# \ud83d\udce2 Overview
\n**Stop guessing your server’s capacity. Measure it.**<\/p>\n
**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”**.<\/p>\n
It stresses the server with real-world scenarios\u2014Chunk Generation, Entity AI processing, and Math physics\u2014to calculate a reliable **”Recommended Player Count”** and **”Server Rank”** (SSS to C).<\/p>\n
**Why use this?**
\n* “I bought an i9 server, but it lags.” \ud83d\udc49 **Identify if it’s a Disk I\/O or RAM bottleneck.**
\n* “How many players can I host?” \ud83d\udc49 **Get a calculated estimate, not a guess.**
\n* “Is my server host scamming me?” \ud83d\udc49 **Visualize the true performance.**<\/p>\n
# \u2728 Key Features
\n* **\ud83d\udcca Real-World Metrics:** Measures **MSPT (Milliseconds Per Tick)** impact from Entities, Chunk I\/O, and CPU math separately.
\n* **\ud83d\udee1\ufe0f Safety Circuit Breaker:** Features a built-in safety limit. If the server lags too much (TPS drops), the benchmark **aborts immediately** to prevent crashes.
\n* **\ud83e\udde0 Intelligent Diagnosis:** Automatically identifies bottlenecks. It tells you: *”CPU is great, but your RAM speed is limiting performance.”*
\n* **\ud83c\udfaf High Precision:** Uses **Trimmed Averaging** logic to ignore lag spikes and warm-up jitters, ensuring consistent results on both high-end and budget CPUs.
\n* **\ud83d\udcc2 Log Reports:** Saves detailed benchmark reports with hardware specs (CPU Model, RAM) to `plugins\/ServerLimitGauge\/logs\/`.<\/p>\n
# \ud83c\udfae How to Use
\n1. **Prepare:** Ensure your server is idle (no players online is recommended for best accuracy).
\n2. **Command:** Run `\/benchmark start`.
\n3. **Wait:** The plugin will perform a **Warm-up** followed by **5 loops** of stress tests:
\n * *Prime Number Calculation (CPU Single-thread)*
\n * *Physics Explosion (Math)*
\n * *HashMap\/RAM Access (Memory Latency)*
\n * *Chunk Generation & I\/O (Disk Speed)*
\n * *Entity Processing (Mob AI)*
\n4. **Result:** Check the chat or console for the **Server Rank** and **Recommended Player Count**.<\/p>\n
> **Note:** The benchmark creates temporary entities and loads chunks, but cleans them up immediately.<\/p>\n
# \ud83d\udcdc Commands & Permissions<\/p>\n
| Command | Description | Permission |
\n| :— | :— | :— |
\n| **\/benchmark start** | Starts the performance benchmark. | `slg.admin` |
\n| **\/benchmark reload** | Reloads the configuration file. | `slg.admin` |<\/p>\n
*(By default, `slg.admin` is granted to OPs)*<\/p>\n
# \u2699\ufe0f Configuration
\nYou can customize the stress load and safety limits.<\/p>\n
“`yaml
\n# ==========================================
\n# ServerLimitGauge Configuration
\n# ==========================================<\/p>\n
# Save benchmark results to a text file in \/logs folder.
\nsave-logs: true<\/p>\n
# Safety Settings
\nsafety:
\n # If true, the benchmark will abort if MSPT exceeds 250ms (TPS < 4) to prevent crashing.\n # Set to false if you want to test low-spec machines to their absolute limit.\n enable-mspt-limit: true\n```\n\n# \ud83d\udcf8 Gallery\n\n\nHigh-End Environment (i9-11900KF): Shows SSS Rank and high player capacity.\n\n```text\n=============== [Result Report] ===============\nOS: Windows 11 (amd64)\nCPU Model: 11th Gen Intel(R) Core(TM) i9-11900KF @ 3.50GHz\nCPU Cores: 16 threads\nAllocated RAM: 10240 MB\nOverall Score: 30700\nServer Rank: SSS (Extreme)\n\nRecommended Player Count: 245 Players\nMax Capacity (Limit): 307 Players\n\n[Detailed Metrics]\n- CPU Integer\/Math: 28.04 ns\n- RAM Latency: 74.99 ns\n- Disk\/Chunk I\/O: 20.96 ms\n- Entity Processing: 26.05 ns\/entity\n\n[Bottleneck Diagnosis]\n\u26a0 Memory Capacity (10240 MB) is the primary bottleneck.\n Your CPU could handle 426 players,\n but memory constraints limit this to 307 players.\n -> Allocating more RAM will drastically improve your Server Rank.
\n\u2714 CPU single-thread performance is legendary (Monster Class).
\n\u2714 Disk I\/O & Terrain generation speeds are healthy.
\n============================================
\n“`<\/p>\n
Bottleneck Detection: Shows warnings when RAM is insufficient or Disk I\/O is slow.<\/p>\n
# \ud83d\udcc8 bStats
\n<\/p>\n","protected":false},"excerpt":{"rendered":"
\u26a1 Stop Guessing, Start Measuring! The Ultimate High-Precision Server Benchmark. Detect Bottlenecks & Calculate Player Capacity with Real-World Stress Tests. [1.20+]<\/p>\n","protected":false},"featured_media":137577,"template":"","meta":{"_minecraft_slug":"serverlimitgauge","_minecraft_project_id":"TCCqwxxF","_minecraft_author":"nekoneko2872","_minecraft_license":"LicenseRef-ServerLimitGauge","_minecraft_downloads":311,"_minecraft_follows":4,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"serverlimitgauge.zip","_minecraft_size_bytes":3339122,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T11:40:49.944285Z","_minecraft_date_created":"2025-12-14T21:39:25.573029Z","_minecraft_date_modified":"2025-12-21T06:22:01.945296Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/serverlimitgauge","_minecraft_icon_attachment_id":137577,"_minecraft_imported_at":"2026-06-08T03:15:12+00:00","_minecraft_import_hash":"edbaba351685107890efcb48adf87051","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,126,127,128,129,123,92],"mod_loader":[131,132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-137576","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n