TPS HUD

TPS HUD puts a server's tick rate on screen in a small always-visible overlay, so lag shows up the moment it starts instead of after a player complains in chat. Tick rate, usually shortened to TPS (ticks per second), measures how fast the server is processing a second of game logic; 20 is healthy, and a number that drops well below that means something is choking the server. The project ships two separate ways to see it: a Fabric and Quilt mod that runs entirely on the player's own client with no server changes needed, and a Bukkit, Paper, Spigot and Purpur plugin for admins who want the same readout enforced server-side. Both builds sit on version 2.0.0, released 2026-08-31, and reach the current 26.3 line across every platform. mooziii, the sole developer, has kept the project MIT licensed and open source since 2022, and it has logged over 470,000 downloads on Modrinth.

A client mod or a server plugin

The Fabric and Quilt build is the simpler option for a player who does not run or administer the server: it reads tick timing on the client itself, needs Fabric API installed to work, and never touches the server's plugins folder. YetAnotherConfigLib and Mod Menu are optional add-ons that unlock an in-game settings screen instead of hand-editing a config file. The Bukkit, Paper, Spigot and Purpur build is the other half of the same project. It installs like any normal plugin, needs nothing extra to run, and is the right pick for an admin who wants the readout showing for every player, or just for staff, without asking anyone to install a mod.

How to install the server plugin

1. 1.Download the plugin build from the TPS HUD Modrinth page, matching Bukkit, Paper, Spigot or Purpur.
2. 2.Drop the jar into the server's plugins folder.
3. 3.Restart the server. A plugin reload is not enough for a freshly added jar.
4. 4.Confirm it loaded with /plugins, then check the in-game display it adds.

The general steps for adding any jar to a server are the same across plugins; see how to install plugins on a Minecraft server for the full walkthrough, including folder locations and troubleshooting a plugin that fails to load.

How to install the Fabric or Quilt mod

1. 1.Install Fabric Loader or Quilt for the target Minecraft version first; see how to install Fabric on Minecraft Java for setup steps.
2. 2.Download Fabric API and place it in the mods folder. TPS HUD will not load without it.
3. 3.Download the TPS HUD jar from Modrinth and add it to the same mods folder.
4. 4.Optionally add Mod Menu and YetAnotherConfigLib for an in-game options screen instead of editing the config file by hand.
5. 5.Launch the game. The TPS overlay appears automatically, no server-side setup required.

Supported server software and versions

One universal build covers all six platforms. Version 2.0.0+26.2, published 2026-08-31, reaches Minecraft 26.3 on Fabric, Quilt, Bukkit, Paper, Purpur and Spigot alike, so there is no lagging platform to plan around the way there often is on multi-loader projects. Folia and Sponge are not on the supported list; a Folia server needs a different plugin for the same purpose.

• Bukkit, Paper, Purpur, Spigot: version 2.0.0, current through 26.3, no extra dependencies.
• Fabric, Quilt: version 2.0.0, current through 26.3, requires Fabric API.
• Project history goes back to 1.18.2, first published in 2022.

TPS HUD versus TabTPS

TPS HUD is a small, single-purpose overlay: it shows one number and gets out of the way. TabTPS is the more established name in this exact space, with a tab list, boss bar and action bar display, its own permission nodes, and commands for ping and memory alongside tick rate. It has followed Paper continuously since 1.8.8 and carries far more backlinks and community traction than TPS HUD does. Pick TabTPS for a fuller monitoring toolkit on a Paper server with staff permissions to manage. Pick TPS HUD for the least setup, especially as a player-side Fabric mod on a server the player does not administer.