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%"
