PerformanceAnalyzer

PerformanceAnalyzer is a lightweight monitoring and analysis plugin for Paper/Spigot 1.21+ servers.
It helps you track MSPT, TPS, memory usage, packet load, and mining behavior so you can quickly find lag sources and spot suspicious activity like X-Ray or packet floods.

Key Features

• 📊 Live Performance Overview

  • /perfstatus shows live MSPT, TPS, heap usage, online player count, and more.
  • Fully configurable thresholds for what counts as “warning” or “critical”.

• 🕒 Historical Performance Tracking

  • Stores performance metrics in a database (SQLite or MySQL).
  • Analyze spikes and long-term trends with /perfhistory.
  • Great for finding recurring lag, peak times, and slowdowns after certain events or plugin changes.

• 🖼️ In-Game Performance GUI

  • /perfgui opens a clean, in-game GUI with the most important metrics.
  • Designed for staff and admins who prefer a visual overview instead of reading console logs.

• 🔔 Alerts & Notifications

  • Configurable alerts for:
  • High MSPT
  • TPS drops
  • High heap usage
  • Packet floods / abnormal packet rates
  • Alerts can be sent:
  • To console / in-game chat
  • To a Discord webhook (optional)

• 🧪 Optional AntiCheat & X-Ray Detection (BETA, disabled by default)

  • Analyzes mining behavior and ore statistics for X-Ray-like patterns.
  • Highlights players with suspicious ore rates.
  • Whitelist support for trusted players and/or permission groups.
  • Controlled via /xrayalerts, /xrayores, and /acwhitelist.
  • Designed as a helper/indicator, not a full replacement for dedicated anti-cheat plugins.

• 🤝 Integrations

  • ProtocolLib – more accurate packet analysis when installed.
  • spark – complementary profiling information.
  • LuckPerms – use groups for whitelists and notifications in AntiCheat/X-Ray features.

Storage & Database

PerformanceAnalyzer supports two storage backends:

• SQLite (default)

  • Simple and file-based, no extra setup required.
  • Ideal for small to medium servers or quick setups.

• MySQL

  • Better suited for larger servers or multiple instances.
  • Useful if you want to analyze data across different machines or tools.

Note: When using MySQL, the MySQL JDBC driver must be installed/provided on the server.
If MySQL is selected but the driver is missing, PerformanceAnalyzer will log a clear error message explaining what to install.

Installation

1. Download performance-analyzer-1.2.2.jar.
2. Place the JAR into your server’s plugins/ folder.
3. Start the server once to generate config.yml and the database structure.
4. Open plugins/PerformanceAnalyzer/config.yml and adjust:
   • Database backend: sqlite or mysql
   • Thresholds for MSPT/TPS/memory/packet alerts
   • Discord webhook URL (if you want alerts on Discord)
   • Optional: enable AntiCheat/X-Ray (anticheat_enabled: true) if you want to use it
5. Restart or reload the server to apply your configuration.

Commands

• /perfstatus
  Show the current live performance overview (MSPT, TPS, memory, players, etc.).

• /perfhistory
  View historical performance data from the database.

• /perfgui
  Open the in-game performance GUI.

• /perfreload
  Reload the plugin configuration.

• /acwhitelist
  Manage the AntiCheat/X-Ray whitelist (players who should be ignored by checks).

• /xrayalerts
  View and manage X-Ray- and AntiCheat-related alerts.

• /xrayores
  Show ore mining statistics and potentially suspicious patterns.

All commands are permission-based so you can decide exactly who can view or manage what.

Permissions (Examples)

Some example permissions you can assign:

• performance.status – use /perfstatus
• performance.history – use /perfhistory
• performance.gui – use /perfgui
• performance.admin – use /perfreload and admin features
• performance.anticheat.manage – manage AntiCheat/X-Ray features and whitelists

You can combine these with your existing permission system (e.g. LuckPerms) to create admin, moderator, or support roles.

Use Cases

• Find out when and why your server lags.
• See if lag spikes are caused by:
  • plugin changes,
  • peak player times,
  • heavy redstone farms,
  • or specific events.
• Receive Discord alerts when your TPS drops or MSPT spikes.
• Monitor suspicious mining behavior and get an early warning for potential X-Ray users.

Special Thank

to ELITEK3V for testing