ModsFinder

TPS Detective

by Catomon

TPS Detective shows server tick statistics in a GUI, so a freeze can be traced to the cause that stops the server responding.

ForgeNeoForgeClient and serverAll rights reserved1.20.1 – 1.21.1

What it does

Pressing O opens a screen where tick times are shown in real time as an overlay. Entity tick times, structure generation times and the last task the server ran are listed, which helps find the source of a drop to 0 TPS. Tick lag caused by a villager is one example of what the screen can reveal. The mod works in singleplayer only, not on dedicated servers. It is published for Forge and NeoForge across 7 release versions, 1.20.1 – 1.21.1, and it runs on client and server. The code is not open source, and all rights are reserved.

Key features

  1. Tick statistics screen

    Server tick statistics are displayed in a GUI, with the view opened by pressing O.

  2. Freeze detection

    The GUI shows when the server stops responding and the world sits at 0 TPS.

  3. Entity and structure timings

    Entity tick times, structure generation times and the last server task are listed to locate the cause of lag.

Compatibility

Latest build for each game version and loader.

1.21.1Not available1.3.0
1.20.61.0.2-fixNot available
1.20.51.0.2-fixNot available
1.20.41.0.2-fixNot available
1.20.31.0.2-fixNot available
1.20.21.0.2-fixNot available
1.20.11.3.0Not available
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Questions

Does TPS Detective work on dedicated servers?

No. The mod works in singleplayer only and does not run on dedicated servers.

Which loaders does TPS Detective support?

It is published for Forge and NeoForge, with files for 1.20.1 and 1.21.1 as the latest builds.

In the catalog

TPS Detective is one of 3,545 Optimization mods on ModsFinder, and one of 1,441 Optimization mods for Forge. 32,366 mods support Minecraft 1.21.1.

More from Catomon

All projects

Similar mods

What the author says

This thing shows entity tick times and structure max gen times and also the last task server was busy doing if the server stops responding (frozen world, 0 TPS). Press 'O' to see the snapshot screen where you can also turn on realtime overlay.
Catomon, on the Modrinth page

Official listing

Owner
Catomon
Published
2025-10-25
Updated on Modrinth
2026-09-19
Facts verified
2026-10-15

Tags