TabTPS Folia

Real-time per-region performance monitoring for Folia servers.

A fork of TabTPS built specifically for Folia's regionalized multithreading. Each player sees TPS and MSPT from their own region — not a server-wide average.

---

🖥️ Display Types

Tab Menu

Show performance data in the player list header or footer.

Action Bar

Compact live stats right above the hotbar.

Boss Bar

Color-coded boss bar that fills based on TPS or MSPT.

---

📊 Available Modules

Configure which modules to display in each display type:

Module	Description
tps	TPS of the player's current region
mspt	MSPT of the player's current region
lowest_region_tps	Lowest TPS across all regions
median_region_tps	Median TPS across all regions
highest_region_tps	Highest TPS across all regions
ping	Player latency
cpu	Server CPU usage
memory	JVM memory usage
players	Online player count

---

⌨️ Commands

Command	Description
/tickinfo	Region TPS overview (Lowest / Median / Highest)
/ping [player]	View your or another player's ping
/pingall	Summary of all players' pings
/memory	JVM memory pool breakdown
/tabtps toggle tab	Toggle tab display
/tabtps toggle actionbar	Toggle action bar display
/tabtps toggle bossbar	Toggle boss bar display
/tabtps reload	Reload configuration

---

⚙️ Configuration

All configuration files are in plugins/TabTPS/:

• display-configs/ — Define which modules to show per permission group
• themes/ — Customize colors for performance thresholds
• main.conf — Update rates, permission priorities, help colors

---

📋 Requirements

• Folia 1.20+ (tested on 1.21.11)
• Java 21

---

🙏 Credits

Based on TabTPS by jpenilla — licensed under MIT.