TPSnitch

TPSnitch

TPSnitch is a Minecraft mod that monitors and displays server TPS (ticks per second) to help track server performance.

1 105 downloads 3 followers

TPSnitch

TPSnitch is a Fabric Minecraft server utility mod for monitoring server performance. It automatically logs TPS (Ticks Per Second), MSPT (Milliseconds Per Tick), and player count at configurable intervals to a JSON file, making it easy to analyze server health over time.

Features

  • Logs TPS, MSPT, and player count to a JSON file keyed by timestamp
  • Configurable log interval, debug mode, and log file name
  • Player count tracked via join/leave events
  • Utility functions for retrieving TPS and MSPT from the server object
  • Supports Fabric

Output Format

The log file is a JSON object where each key is an ISO timestamp, and each value is an object of TPS, MSTP and Player Count:

{
  "2025-04-23T21:00:00Z": {
    "TPS": 20.0,
    "MSPT": 50.0,
    "PlayerCount": 5
  },
  ...
}

Getting Started

  1. Requires Java 21
  2. Download the latest jar file
  3. Place the jar in your server's mods folder
  4. Start your server

Configuration

  • Log interval, debug mode, and log file name are configurable via your loader's config system
  • Logs are saved to a JSON file (default: tpsnitch_log.json)

License

Apache 2.0


For questions or support, put it in our Issues.

No gallery available for this project.

Version Minecraft Loader Download

TPSnitch 1.3.4

1.3.4

1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2
fabric
Download

1.3.3

1.21.5
fabric
Download

TPSnitch 1.3.2

1.3.2

1.21.5
fabric
Download

1.3.1

1.21.5
fabric
Download

1.3.0

1.21.5
fabric
Download

TPSnitch 1.2.0

1.2.0

1.21.5
fabric
Download

TPSnitch 1.1.0 - Fabric

1.1.0

1.21.4
fabric
Download

TPSnitch 1.0.0

1.0.0

1.21.4
fabric
Download