# **ServerScope**
\n## **Minecraft server monitoring and diagnostics**<\/p>\n
**\ud83d\udcca About the plugin**
\n**ServerScope** is a modern monitoring and observability plugin with a **web dashboard** for **Minecraft servers** running on **Paper \/ Folia 1.21+**.<\/p>\n
It gives administrators full control over the server\u2019s status: performance, lag, load, suspicious events \u2014 all in one place.<\/p>\n
**\ud83d\udca1 Suitable for:**<\/p>\n
1. SMP servers
\n2. Vanilla+ servers
\n3. Large-scale projects with high load<\/p>\n
**\u26a1 Why you need it**
\n**With ServerScope, you can quickly understand:**<\/p>\n
– \u2753 Why the server is lagging right now
\n– \ud83c\udf0d Which chunks are causing the load
\n– \ud83d\udc04 Whether the number of entities is increasing
\n– \u26a0\ufe0f Whether it\u2019s a real problem or just a warning
\n– \ud83d\udd0c Which plugins are behaving suspiciously<\/p>\n
**\ud83d\ude80 Key features**
\n– \ud83d\udcc8 Live metrics:
\n– TPS, MSPT, entities, chunks
\n– \ud83c\udf0d World and chunk diagnostics
\n– \ud83d\udd0d Event and plugin profiling
\n– \ud83d\udea8 Alert system
\n– \ud83c\udf10 Built-in web dashboard
\n– \ud83d\udd17 JSON API
\n– \ud83c\udfae Admin game commands
\n– \ud83d\udcbe Data storage (SQLite)<\/p>\n
**\ud83d\udce6 Requirements**\u200b
\nJava 21+
\nPaper \/ Folia 1.21+<\/p>\n
**\ud83d\udce5 Installation**\u200b
\n1. Download the .jar file
\n2. Move it to the plugins\/ folder
\n3. Start the server
\n4. Wait for the configurations to be generated<\/p>\n
**\ud83d\udcc1 Configuration:**
\n“`plugins\/ServerScope\/config.yml“`<\/p>\n
**\u2699\ufe0f What\u2019s included straight away**
\n\u200b
\nThe following are already active after the first launch:
\n – storage
\n – collectors
\n – alerts
\n – profiling
\n – web panel<\/p>\n
**\ud83d\udd12 Default web panel:**
\n – access only locally (127.0.0.1)
\n – port 8080
\n – token generated automatically<\/p>\n
**\ud83c\udf10 How to access the web panel**\u200b
\nIf you\u2019re on the same machine:
\nhttp:\/\/127.0.0.1:8080\/<\/p>\n
Next:
\n1. Open config.yml
\n2. Find web.auth-token
\n3. Paste it into the panel<\/p>\n
**\ud83c\udf0d How to enable external access (hosting)**\u200b
\nIf the server is hosted:
\n1. Check if you can open the port
\n2. Specify in the config:
\n“`
\nweb:
\n host: 0.0.0.0
\n port: 25656
\n“`
\n3. Restart the server
\n4. Open:
\n“`http:\/\/IP:PORT\/“`<\/p>\n
**\ud83d\udccc Important:**
\n_the token is mandatory
\nthe port must be allowed by the hosting provider_<\/p>\n
**\ud83d\udd10 Security (IMPORTANT)**
\n\u200b
\n_\u274c Do not publish the token_
\n_\u274c Do not open the dashboard without protection_<\/p>\n
**\ud83e\udde0 Profiling**\u200b
\nAllows you to track:
\n – slow events
\n – frequent events
\n – load spikes
\n – plugin impact<\/p>\n
\ud83d\udccc By default:
\n – player_interact
\n – block_break \/ place
\n – entity_damage
\n – inventory_click
\n – creature_spawn<\/p>\n
**\ud83d\udea8 Alerts**\u200b
\nNotification system:
\n\ud83d\udd34 CRITICAL \u2014 appears in-game
\n\ud83d\udfe1 WARN \u2014 remains in the UI \/ console<\/p>\n
Examples:
\n – low TPS
\n – high MSPT
\n – chunk overload
\n – many entities<\/p>\n
**\ud83d\udcbe Storage**\u200b
\n – SQLite database
\n – asynchronous writing
\n – minimal load<\/p>\n
\ud83d\udcc1 File:<\/p>\n
“`
\nplugins\/ServerScope\/serverscope-mvp.db
\n“`<\/p>\n
**\ud83c\udfae Commands**\u200b<\/p>\n
“`
\n\/serverscope
\n\/serverscope status
\n\/serverscope reload
\n\/serverscope report
\n\/serverscope findings
\n\/serverscope alerts
\n\/serverscope web regenerate-token
\n“`<\/p>\n
**\ud83d\udd11 Permissions**\u200b<\/p>\n
“`
\nserverscope.admin
\nserverscope.command.*
\nserverscope.alerts
\n“`
\n\ud83d\udccc Default: OP access<\/p>\n
**\u26a0\ufe0f Common issues**\u200b
\n\u274c Dashboard is there, but no data\u200b
\n\u2192 incorrect token<\/p>\n
\u274c 401 Unauthorised\u200b
\n\u2192 token missing<\/p>\n
\u274c 429 Too Many Requests\u200b
\n\u2192 too many requests<\/p>\n
\u274c Dashboard won\u2019t open\u200b
\n\u2192 check:
\n – port
\n – host
\n – firewall
\n – hosting<\/p>\n
**\ud83d\udd04 Regenerate token**\u200b<\/p>\n
“`
\n\/serverscope web regenerate-token
\n“`<\/p>\n
**\ud83d\udca1 Conclusion**\u200b
\n**ServerScope** is essentially \u2018Grafana for Minecraft\u2019, but right inside the server.<\/p>\n
If you want to:
\n – find lags faster
\n – understand server behaviour
\n – monitor load<\/p>\n
\u2192 this plugin is a must-have.<\/p>\n","protected":false},"excerpt":{"rendered":"
ServerScope is a monitoring and observability plugin for Paper and Folia servers that provides administrators with clear insights into server performance, health, and stability through an integrated diagnostics system.<\/p>\n","protected":false},"featured_media":137636,"template":"","meta":{"_minecraft_slug":"serverscope","_minecraft_project_id":"gkcXjUor","_minecraft_author":"denfry","_minecraft_license":"MIT","_minecraft_downloads":10,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"serverscope.zip","_minecraft_size_bytes":16853269,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:09:32.328254Z","_minecraft_date_created":"2026-03-19T21:42:44.525172Z","_minecraft_date_modified":"2026-03-18T09:48:40.029982Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/serverscope","_minecraft_icon_attachment_id":137636,"_minecraft_imported_at":"2026-06-08T03:20:50+00:00","_minecraft_import_hash":"054c4b89784da1dd92120b7e7dfdf675","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,127,128,129,92],"mod_loader":[131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-137635","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","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