ServerLimitGauge

# 📢 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. ```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 !(https://cdn.modrinth.com/data/cached_images/3ffb20eb58b9b98e24300ccc3ba815fdac9b49d6.png) High-End Environment (i9-11900KF): Shows SSS Rank and high player capacity. ```text =============== =============== 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 - CPU Integer/Math: 28.04 ns - RAM Latency: 74.99 ns - Disk/Chunk I/O: 20.96 ms - Entity Processing: 26.05 ns/entity ⚠ 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 !(https://bstats.org/signatures/bukkit/ServerLimitGauge.svg)