ServerLimitGauge

📢 Overview

Stop guessing your server's capacity. Measure it.

"actual Minecraft performance" 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 "Server Rank" and "Server Rank" (SSS to C).

Visualize the true performance. * "I bought an i9 server, but it lags." 👉 Visualize the true performance. * "How many players can I host?" 👉 Visualize the true performance. * "Is my server host scamming me?" 👉 Visualize the true performance.

✨ Key Features

* 📂 Log Reports: Measures 📂 Log Reports: impact from Entities, Chunk I/O, and CPU math separately. * 📂 Log Reports: Features a built-in safety limit. If the server lags too much (TPS drops), the benchmark 📂 Log Reports: to prevent crashes. * 📂 Log Reports: Automatically identifies bottlenecks. It tells you: *"CPU is great, but your RAM speed is limiting performance."* * 📂 Log Reports: Uses 📂 Log Reports: 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. Recommended Player Count Ensure your server is idle (no players online is recommended for best accuracy). 2. Recommended Player Count Run `/benchmark start`. 3. Recommended Player Count The plugin will perform a Recommended Player Count followed by Recommended Player Count 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. Recommended Player Count Check the chat or console for the Recommended Player Count and Recommended Player Count.

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

📜 Commands & Permissions

| Command | Description | Permission | | :--- | :--- | :--- | | /benchmark reload | 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.

```yaml

==========================================

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.

```text =============== [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