Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for STYM

Per-region TPS and lag alerts for Folia.

Report TickRadar?

R

1.0.0

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.

Boss bar and tab-list footer showing the TPS and MSPT of the player's 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.

/tickradar regions listing the global region and three player regions

Discord alert: region R3 is at 62.0 ms (critical)

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 <id> 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 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.

Information

Published
September 25, 2026
Author
0Downloads

Platforms

Paper
Paper
26.1–26.2

Dependencies

PaperPaper

Dependencies: Paper

Plugins and libraries a server needs for this version to run.

No dependencies

Add anything a server has to install alongside this version.