EasyPerfMonitor

Modern Performance Monitoring for Minecraft Servers
Live TPS, MSPT, RAM & CPU dashboard with Chart.js graphs, JSON export & history.

✨ Features

Feature	Description
📊 Live Dashboard	localhost:8080 - 4 responsive charts (TPS/MSPT dual-axis, RAM, CPU)
⚡ Real-Time Metrics	TPS/MSPT (per tick), RAM/CPU with 200-point history & smooth fills
📈 Smart Stats	Current values + ⌀ Averages (w/ MB/% units) - instant visual trends
💾 JSON Export	/perf export creates timestamped files - view histories
🌐 Production Ready	External IP support, async-safe, VPS optimized (port 8080)
🎮 Universal Support	Spigot, Paper, Folia for 1.8.8 → 1.21+

🚀 Quick Start

# 1. Build (Java 8+)
mvn clean package

# 2. Install
/plugins/EasyPerfMonitor.jar → /rl EasyPerfMonitor

# 3. Open Dashboard
http://localhost:8080

Optional config.yml:

web:
  addresses: ["your.server.ip:8080"]
server-ip: "0.0.0.0"  # Bind all interfaces

📱 Commands

Command	Description
/perf	Shows current TPS/MSPT/RAM/CPU
/perf now	Live performance message
/perf export	Save JSON with full history
/perf web	Prints dashboard URL(s)

🛠️ Architecture

EasyPerfMonitor.java
├── onEnable() → HttpServer(8080) + TPS/MSPT Runnables
├── WebFileHandler.java → index.html + /data/*.json
└── PerfCommand.java → export() with history arrays

Tech Stack: Java 8+ - Spigot/Paper/Folia API - Chart.js - Gson

📈 Sample Metrics

Metric	Current	Average	Chart Style
TPS	20.0	⌀19.8	🟢 Green filled area
MSPT	8.0ms	⌀31ms	🟠 Orange dual-axis
RAM	586MB	⌀712MB	🔵 Blue line
CPU	21.7%	⌀18.5%	🔴 Red gradient

🔧 Building from Source

# Requirements: Java 8+, Maven 3+, Minecraft 1.8.8+ Server
git clone https://github.com/yourusername/EasyPerfMonitor.git
cd EasyPerfMonitor
mvn clean package

Pro Tips:

• Open firewall port 8080 for remote access
• /perf export multiple times → drag all JSONs for complete history
• History auto-downsampled to 500 points (blazing fast charts)

❤️ Credits & License

License: MIT - Fork, star, contribute! ⭐
Dependencies: Chart.js (CDN) & Spigot/Paper/Folia API

🌟 Found a bug? `/perf now` + screenshot in Issues
🚀 Want features? PRs welcome!

Production-ready for high-traffic servers