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.