TPS Warning
PluginMIT

TPS Warning

A lightweight Paper/Spigot plugin that alerts players in-game and via Discord Webhooks when server TPS drops below a set threshold. It features an integrated cooldown system and easy live customization using the /wc command.

4
Downloads
0
Followers
1 weeks ago
Updated
📦
1
Versions

📖About TPS Warning

SystemWarning

A highly efficient, asynchronous Paper/Spigot plugin designed to actively monitor your Minecraft server's performance. It broadcasts instant alerts to the in-game chat and triggers a custom Discord Webhook layout whenever the server's Ticks Per Second (TPS) drop below a customizable threshold.

🚀 Features

  • Real-time TPS Monitoring: Autonomously tracks the server's 1-minute TPS average every 10 seconds.
  • Discord Integration: Asynchronously dispatches performance warnings via Discord Webhooks, ensuring server main-thread operations are never blocked.
  • Smart Cooldown System: Prevents message spamming by enforcing a rate limit (cooldown) between triggered alerts.
  • Dynamic Configuration: Adjust all variables, payloads, text limits, and paths seamlessly.
  • Live In-game Customization: Alter plugin settings on the fly through an interactive in-game administrator command setup.
  • Security First: Built-in payload character sanitization preventing malformed parameters or JSON injection attempts over Discord webhooks.
  • Tab-Completion Engine: Native command auto-suggestions for effortless configuration adjustments.

🛠️ Configuration (config.yml)

The default configuration file will automatically generate upon the plugin's initial startup:

# The critical performance marker. Alerts trigger when current TPS falls below or matches this value.
threshold: 15.0

# Rate limiting parameter (defined in seconds) before another notification cycle can be invoked.
cooldown: 300

discord:
  webhook-url: "YOUR_WEBHOOK_URL_HERE"
  message: "⚠️ **Server Warning!** TPS have dropped to %tps%!"

minecraft:
  message: "&c⚠️ [Warning] Server TPS are critically low: &e%tps%"