ServerScope

ServerScope

Minecraft server monitoring and diagnostics

Paper / Folia 1.21+ Paper / Folia 1.21+ is a modern monitoring and observability plugin with a Paper / Folia 1.21+ for Paper / Folia 1.21+ running on Paper / Folia 1.21+.

It gives administrators full control over the server’s status: performance, lag, load, suspicious events — all in one place.

💡 Suitable for:

1. SMP servers 2. Vanilla+ servers 3. Large-scale projects with high load

With ServerScope, you can quickly understand: With ServerScope, you can quickly understand:

- ❓ Why the server is lagging right now - 🌍 Which chunks are causing the load - 🐄 Whether the number of entities is increasing - ⚠️ Whether it’s a real problem or just a warning - 🔌 Which plugins are behaving suspiciously

🚀 Key features - 📈 Live metrics: - TPS, MSPT, entities, chunks - 🌍 World and chunk diagnostics - 🔍 Event and plugin profiling - 🚨 Alert system - 🌐 Built-in web dashboard - 🔗 JSON API - 🎮 Admin game commands - 💾 Data storage (SQLite)

📦 Requirements​ Java 21+ Paper / Folia 1.21+

📥 Installation​ 1. Download the .jar file 2. Move it to the plugins/ folder 3. Start the server 4. Wait for the configurations to be generated

📁 Configuration: ```plugins/ServerScope/config.yml```

⚙️ What’s included straight away ​ The following are already active after the first launch: - storage - collectors - alerts - profiling - web panel

🔒 Default web panel: - access only locally (127.0.0.1) - port 8080 - token generated automatically

🌐 How to access the web panel​ If you’re on the same machine: http://127.0.0.1:8080/

Next: 1. Open config.yml 2. Find web.auth-token 3. Paste it into the panel

🌍 How to enable external access (hosting)​ If the server is hosted: 1. Check if you can open the port 2. Specify in the config: ``` web: host: 0.0.0.0 port: 25656 ``` 3. Restart the server 4. Open: ```http://IP:PORT/```

📌 Important: the token is mandatory the port must be allowed by the hosting provider

🔐 Security (IMPORTANT) ​ ❌ Do not publish the token ❌ Do not open the dashboard without protection

🧠 Profiling​ Allows you to track: - slow events - frequent events - load spikes - plugin impact

📌 By default: - player_interact - block_break / place - entity_damage - inventory_click - creature_spawn

🚨 Alerts​ Notification system: 🔴 CRITICAL — appears in-game 🟡 WARN — remains in the UI / console

Examples: - low TPS - high MSPT - chunk overload - many entities

💾 Storage​ - SQLite database - asynchronous writing - minimal load

📁 File:

``` plugins/ServerScope/serverscope-mvp.db ```

🎮 Commands​

``` /serverscope /serverscope status /serverscope reload /serverscope report /serverscope findings /serverscope alerts /serverscope web regenerate-token ```

🔑 Permissions​

``` serverscope.admin serverscope.command.* serverscope.alerts ``` 📌 Default: OP access

⚠️ Common issues​ ❌ Dashboard is there, but no data​ → incorrect token

❌ 401 Unauthorised​ → token missing

❌ 429 Too Many Requests​ → too many requests

❌ Dashboard won’t open​ → check: - port - host - firewall - hosting

🔄 Regenerate token​

``` /serverscope web regenerate-token ```

ServerScope​ ServerScope is essentially ‘Grafana for Minecraft’, but right inside the server.

If you want to: - find lags faster - understand server behaviour - monitor load

→ this plugin is a must-have.