📢 Overview

Stop guessing your server's capacity. Measure it.

ServerLimitGauge is a professional benchmarking tool designed specifically for Minecraft servers (Spigot, Paper, Purpur, Folia). Unlike generic hardware benchmarks (like Geekbench), this plugin measures "actual Minecraft performance".

It stresses the server with real-world scenarios—Chunk Generation, Entity AI processing, and Math physics—to calculate a reliable "Recommended Player Count" and "Server Rank" (SSS to C).

Why use this?

• "I bought an i9 server, but it lags." 👉 Identify if it's a Disk I/O or RAM bottleneck.
• "How many players can I host?" 👉 Get a calculated estimate, not a guess.
• "Is my server host scamming me?" 👉 Visualize the true performance.

✨ Key Features

• 📊 Real-World Metrics: Measures MSPT (Milliseconds Per Tick) impact from Entities, Chunk I/O, and CPU math separately.
• 🛡️ Safety Circuit Breaker: Features a built-in safety limit. If the server lags too much (TPS drops), the benchmark aborts immediately to prevent crashes.
• 🧠 Intelligent Diagnosis: Automatically identifies bottlenecks. It tells you: "CPU is great, but your RAM speed is limiting performance."
• 🎯 High Precision: Uses Trimmed Averaging logic to ignore lag spikes and warm-up jitters, ensuring consistent results on both high-end and budget CPUs.
• 📂 Log Reports: Saves detailed benchmark reports with hardware specs (CPU Model, RAM) to plugins/ServerLimitGauge/logs/.

🎮 How to Use

1. Prepare: Ensure your server is idle (no players online is recommended for best accuracy).
2. Command: Run /benchmark start.
3. Wait: The plugin will perform a Warm-up followed by 5 loops of stress tests:
   • Prime Number Calculation (CPU Single-thread)
   • Physics Explosion (Math)
   • HashMap/RAM Access (Memory Latency)
   • Chunk Generation & I/O (Disk Speed)
   • Entity Processing (Mob AI)
4. Result: Check the chat or console for the Server Rank and Recommended Player Count.

Note: The benchmark creates temporary entities and loads chunks, but cleans them up immediately.

📜 Commands & Permissions

Command	Description	Permission
/benchmark start	Starts the performance benchmark.	slg.admin
/benchmark reload	Reloads the configuration file.	slg.admin

(By default, slg.admin is granted to OPs)

⚙️ Configuration

You can customize the stress load and safety limits.

# ==========================================
# ServerLimitGauge Configuration
# ==========================================

# Save benchmark results to a text file in /logs folder.
save-logs: true

# Safety Settings
safety:
  # If true, the benchmark will abort if MSPT exceeds 250ms (TPS < 4) to prevent crashing.
  # Set to false if you want to test low-spec machines to their absolute limit.
  enable-mspt-limit: true

📸 Gallery

High-End Environment (i9-11900KF): Shows SSS Rank and high player capacity.

=============== [Result Report] ===============
OS: Windows 11 (amd64)
CPU Model: 11th Gen Intel(R) Core(TM) i9-11900KF @ 3.50GHz
CPU Cores: 16 threads
Allocated RAM: 10240 MB
Overall Score: 30700
Server Rank: SSS (Extreme)

Recommended Player Count: 245 Players
Max Capacity (Limit): 307 Players

[Detailed Metrics]
- CPU Integer/Math: 28.04 ns
- RAM Latency: 74.99 ns
- Disk/Chunk I/O: 20.96 ms
- Entity Processing: 26.05 ns/entity

[Bottleneck Diagnosis]
⚠ Memory Capacity (10240 MB) is the primary bottleneck.
   Your CPU could handle 426 players,
   but memory constraints limit this to 307 players.
   -> Allocating more RAM will drastically improve your Server Rank.
✔ CPU single-thread performance is legendary (Monster Class).
✔ Disk I/O & Terrain generation speeds are healthy.
============================================

Bottleneck Detection: Shows warnings when RAM is insufficient or Disk I/O is slow.

📈 bStats