The TPS drop alert

The TPS drop alert notifies you when your server's performance falls below a level you consider acceptable. It uses the 5-minute TPS average rather than the instantaneous 1-minute value to filter out brief spikes and only fire on sustained degradation.

What triggers it

The alert fires when the 5-minute TPS falls below your configured threshold. It will not fire again until TPS recovers above the threshold and then drops below it again, so a sustained low-TPS period produces a single alert rather than a flood of them.

The default threshold is 16.0. At 16 TPS the game is running at 80% speed and most players will notice rubber-banding and delayed interactions.

What the alert contains

The alert email includes more than just the TPS value at the time it fired:

• Current 5-minute TPS and MSPT
• The world with the highest entity count and that count
• Current player count
• Current heap usage percentage
• A link directly to your analytics dashboard

The entity count by world is included because high entity load is the most common cause of sustained TPS drops. Having the culprit world named in the email saves investigation time.

Setting your threshold

Good starting points depending on your server type:

• Competitive or event servers: 17.0 or higher. Players in these environments are more sensitive to desync
• General survival or SMP: 16.0, the default. Catches real problems without too many false positives
• Heavily modded or minigame servers: 14.0 to 15.0. Acceptable performance for these server types is already lower, so a stricter threshold fires too often