In the realm of Minecraft mods, TPSnitch stands out as an essential tool for players who want to keep a close watch on their server’s performance. It effectively tracks and reveals the server’s TPS (ticks per second), providing a clear view of operational efficiency.
Overview of TPSnitch
TPSnitch serves as a cross-loader utility mod designed specifically for Minecraft servers, allowing for detailed performance monitoring. It systematically records TPS, MSPT (milliseconds per tick), and the number of players at user-defined intervals into a JSON file, enabling users to analyze server performance trends effortlessly.
Key Features
- Records TPS, MSPT, and player counts to a JSON file with timestamps
- Customizable logging intervals, debug settings, and log file names
- Tracks player counts based on join and leave events
- Includes support functions for accessing TPS and MSPT data from the server
- Compatible with Fabric
Log File Structure
The log generated is structured as a JSON object where each timestamp is the key, and the corresponding value contains data for TPS, MSPT, and player count:
{
"2025-04-23T21:00:00Z": {
"TPS": 20.0,
"MSPT": 50.0,
"PlayerCount": 5
},
...
}
How to Get Started
- Ensure you have Java 21 installed.
- Download the TPSnitch mod from the provided link.
- Acquire the necessary dependencies from modrinth.
- Transfer the downloaded JAR files into the
modsdirectory of your server. - Launch your Minecraft server.
Configuration Options
- You can adjust the log interval, debug mode, and file names using your loader’s configuration system.
- Logs are stored in a JSON file, with the default name being
tpsnitch_log.json.
License Information
This mod is released under the MIT License.
Support and Queries
For any inquiries or to seek assistance, please visit our Issues Page.
