Language

TPS Warning

TPS Warning

Modrinth

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.

10 downloads updated 1mo ago
latest v1.0.0 Modrinth
Paper Purpur 26.1.2 – 26.1.2 ManagementTechnologyUtility

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

Versions

Release
1.0.0
paper, purpur · 26.1.2 · 1mo ago
10

Comments 0

No comments yet. Be the first to share your thoughts.

FAQ

How do I install TPS Warning?

Download the file for your Minecraft version and loader from this page, then drop the .jar into your mods (or plugins) folder and launch the game.

Is TPS Warning free?

TPS Warning is free to download on Modgrid — we link straight to the official source, no paywall or bundled installer.

Which Minecraft versions does TPS Warning support?

Works with Paper, Purpur. Supports versions 26.1.2–26.1.2. See the download section on this page for the full list of supported versions and loaders.

Download TPS Warning

Files are served directly from the original source. Modgrid does not host or modify them.