ParadoxStudios Logo ParadoxDevelopment

Paradox Server Monitor

Paradox Server Monitor is a lightweight Bukkit/Spigot plugin designed for real-time monitoring of Minecraft server performance. The plugin collects key metrics (RAM, CPU, TPS) and displays them in a clear Embed on Discord.

The key feature is the "No-Spam" functionality: The plugin sends only one message, which it then edits at regular intervals. This keeps the channel clean and the information always up-to-date.

✨ Features

  • Memory Monitoring (RAM):
    • Maximum allocated memory (Max)
    • Currently allocated memory (Allocated)
    • Free memory (Free)
    • Used memory (Used) + percentage usage
  • CPU Monitoring:
    • Server process load (Java process)
    • Total system load (System CPU)
  • Server Monitoring:
    • TPS (Ticks Per Second): Current and Average (EMA)
    • Tick Time: Duration of the last tick in ms (lag indicator)
    • Uptime: Server running time
    • Online Players: Count of connected players
  • Discord Integration:
    • Webhook support
    • Automatic editing of a single message (persistence across restarts)
    • Adjustable update interval
    • Configurable title and color

📥 Installation

  1. Download the file ServerMonitor-1.0.0.jar (or build from source using gradle build).
  2. Place the .jar file into the plugins/ folder on your server.
  3. Restart the server to generate configuration files.
  4. Open the file plugins/ServerMonitor/config.yml.
  5. Insert your Discord Webhook URL (see Configuration section).
  6. Save the file and run /reload or restart the server.

⚙️ Configuration

The configuration file is located at plugins/ServerMonitor/config.yml.

# Discord Webhook URL. Insert your link here.
webhook_url: "https://discord.com/api/webhooks/..."

# Message update interval in seconds.
# Recommended: 30 seconds (to avoid Discord rate-limits)
update_interval_seconds: 30

# Embed message title on Discord
title: "Paradox Server Monitor"

🔧 Troubleshooting

  • Message not sending: Check if webhook_url in config is filled correctly and not empty.
  • New message created after every restart: The plugin saves the message ID in plugins/ServerMonitor/data.yml. If you delete this file, the plugin will create a new message.
  • CPU shows N/A: Some operating systems or container environments may not provide access to system metrics via JMX.

Created by Paradox