TickRadar

# TickRadar **Folia only.** TickRadar shows the TPS and MSPT of the region a player is standing in, gives staff a sorted view of every populated region, and alerts your team (in game, in the console and on Discord) when a region starts to lag. On Folia, there is no single server-wide TPS anymore: every region ticks on its own thread. The usual tools (a global `/tps`, most tab plugins) either don't run on Folia at all, or quietly average numbers that no longer mean anything. TickRadar shows the number that actually matters: the health of **your** region.  ## Features - **Per-player displays**: boss bar, action bar and tab footer showing the TPS and MSPT of your own region, each toggleable (`/tickradar bossbar|actionbar|tab`). - **`/tickradar regions`**: every populated region and the global region, slowest first, with world, approximate coordinates, player count, TPS, MSPT and a one-click `[Teleport]` link. - **Alerts**: configurable MSPT thresholds, with a cooldown so a slow region doesn't spam you, sent to the console, to players holding `tickradar.alerts`, and to Discord. - **Discord webhook**: no bot, no invite. Paste a webhook URL and get alerts in a channel; rate-limit aware and automatically disabled if the webhook is revoked. - **PlaceholderAPI**: every value available as a `%tickradar_...%` placeholder, with a `_raw` variant for your own formatting. - **Public API only**: no reflection into Folia's internals, so TickRadar keeps working across Folia updates. - **English and French** out of the box, user-editable and never overwritten.   ## Main commands | Command | What it does | |---|---| | `/tickradar` | Health of your own region (or the global region, from console) | | `/tickradar regions [page]` | Populated regions, slowest first, with a teleport link | | `/tickradar tp ` | Teleport to a region shown by `/tickradar regions` | | `/tickradar bossbar\|actionbar\|tab [on\|off]` | Toggle your own displays | | `/tickradar alerts [on\|off]` | Opt in or out of in-game alerts | | `/tickradar status` | TickRadar's own health, for support requests | | `/tickradar reload` | Reload the configuration and languages without a restart | ## Key permissions | Permission | Default | Grants | |---|---|---| | `tickradar.use` | everyone | `/tickradar` (your own region's health) | | `tickradar.display` | op | Boss bar, action bar and tab footer | | `tickradar.alerts` | op | Receiving in-game alerts | | `tickradar.admin` | op | Every admin command (regions, teleport, status, reload, Discord) | Grant `tickradar.display` (and `tickradar.alerts`) to everyone if you want all your players to see their region's health, not just staff. ## Performance Built for Folia's parallel regions, and measured on a real Folia 26.1.2 server: - **About 60 µs per player per second** once the server is warm, with boss bar, action bar and tab footer all on: roughly 0.1% of a 50 ms tick. - **No startup hitch**: display code is warmed up off the game thread at startup and after every `/tickradar reload`. - **Player updates are spread across the ticks of each second**, so a crowded spawn never gets all its players sampled on the same tick. - **No I/O on game threads**: Discord runs on its own thread, and placeholders only read a cache. *Measured on 25/09/2026: Folia 26.1.2 limited to 8 CPU cores and 12 GB of RAM, 3 players each alone in their own region, default settings, average over the last 5 minutes of a 20-minute run. The same test on 4 cores and 8 GB gave the same per-player cost.* ## Usage statistics (bStats) TickRadar reports anonymous usage statistics to [bStats](https://bstats.org) by default: server and player counts, server and Java version, and a few non-identifying settings. **Never** player names, IP addresses, world names, coordinates or the Discord webhook URL. Turn it off with `metrics: false` in `config.yml`. Public dashboard: https://bstats.org/plugin/bukkit/TickRadar/34279 ## Compatibility - **Folia 26.1.2 and newer.** On any server that is not Folia (Paper, Purpur, Pufferfish…), TickRadar disables itself cleanly with a clear log message. - Requires **Java 25** (Folia 26.x already does). - Optional: PlaceholderAPI 2.11.7+. ## License and support Released under the **MIT License** by STYM. Source, issues and full documentation: https://github.com/STYM-DEV/TickRadar Its code is written with the help of AI coding agents.