Back to 9Minecraft
Wiki 9Minecraft Wiki 9Minecraft

TPS HUD Mod FAQ

10 questions players actually ask, answered.

How do I turn on the TPS HUD after installing the mod?
The HUD usually appears automatically in the corner of your screen once you join a world or server. If you don't see it, open the mod's config screen or press its default toggle hotkey to enable it.
Where does the mod get the TPS number if nothing is installed on the server?
It estimates TPS client-side by measuring how often the server sends you world updates, like entity and block changes. Because of this, the value is an approximation rather than the server's exact internal tick rate.
Why does the TPS number look wrong or jump around?
Client-side estimates can spike when your own connection is unstable, when chunks are loading, or when you're in a quiet area with few updates. Check the value over a longer period instead of reacting to a single reading.
Does this mod work on any server or only ones with the mod installed?
It works on any server because it only reads data your client already receives. You never need server-side installation or permission from the server owner.
Will the TPS HUD get me banned on multiplayer servers?
It's a client-side display mod that doesn't send extra packets or modify gameplay, so it's generally allowed. Still check your server's rules, since some strict servers restrict any client mods.
Can I use the TPS HUD with other HUD or performance mods?
Yes, it's designed to sit alongside other HUD mods, though overlapping elements may need repositioning. If two mods fight over the same screen corner, move one of them in its config.
Does the mod hurt my FPS or cause lag?
No, it only reads data the client already has and draws a small text element, so the performance impact is negligible. If you notice issues, it's almost always another mod or your connection.
What TPS value means my server is lagging?
A healthy server runs at the full tick rate, and values noticeably below that indicate lag. The lower the number, the worse the lag, so watch for a sustained drop rather than a momentary dip.
Why did my TPS HUD settings reset after restarting the game?
Settings are saved to the mod's config file, so a reset usually means the file wasn't written properly or was overwritten. Change your options, exit the game cleanly, and check that the config file updates.
Can I see TPS for a specific dimension or only the whole server?
The HUD reflects the overall server tick rate as your client perceives it, not per-dimension values. If you want to compare areas, watch how the number changes as you move between them.