ServerScope
Minecraft 服务器监控与诊断工具
? 插件简介
ServerScope 是一款现代化的监控与可观测性插件,为运行在 Paper / Folia 1.21+ 上的 Minecraft 服务器提供 Web 仪表盘。
它赋予管理员对服务器状态的完全控制权:性能、卡顿、负载、可疑事件——一切尽在掌握。
? 适用场景:
- SMP 服务器
- Vanilla+ 服务器
- 高负载的大型项目
⚡ 为什么需要它
使用 ServerScope,您可以快速了解:
- ❓ 服务器当前为何卡顿
- ? 哪些区块导致了负载
- ? 实体数量是否正在增加
- ⚠️ 这究竟是真实问题还是仅属警告
- ? 哪些插件行为可疑
? 主要功能
- ? 实时指标:
-
TPS、MSPT、实体数、区块数
- ? 世界与区块诊断
- ? 事件与插件分析
- ? 警报系统
- ? 内置 Web 仪表盘
- ? JSON API
- ? 管理游戏内指令
- ? 数据存储(SQLite)
? 依赖要求
Java 21+
Paper / Folia 1.21+
? 安装方法
- 下载 .jar 文件
- 将其移动到 plugins/ 文件夹中
- 启动服务器
- 等待配置文件生成
? 配置文件:
plugins/ServerScope/config.yml
⚙️ 首次启动即包含的功能
以下功能在首次启动后自动启用:
? 默认 Web 面板设置:
- 仅限本地访问 (127.0.0.1)
- 端口 8080
- Token 自动生成
? 如何访问 Web 面板
如果您在同一台机器上操作:
接下来:
- 打开 config.yml
- 找到 web.auth-token
- 将 Token 粘贴到面板中
**? 如何启用外部访问(托管服务器)**
如果服务器是托管的:
- 检查是否可以开放端口
- 在配置文件中指定:
web:
host: 0.0.0.0
port: 25656
- 重启服务器
- 访问:
http://IP:PORT/
? 重要提示:
token 是必填项
端口必须被托管服务提供商允许
? 安全性(重要)
❌ 请勿公开 Token
❌ 请勿在未加保护的情况下开放仪表盘
? 分析功能
允许您追踪:
? 默认监控:
- player_interact
- block_break / place
- entity_damage
- inventory_click
- creature_spawn
? 警报系统
通知系统:
? CRITICAL(严重)— 在游戏中显示
? WARN(警告)— 保留在 UI / 控制台中
示例:
? 存储机制
? 文件路径:
plugins/ServerScope/serverscope-mvp.db
? 命令列表
/serverscope
/serverscope status
/serverscope reload
/serverscope report
/serverscope findings
/serverscope alerts
/serverscope web regenerate-token
? 权限节点
serverscope.admin
serverscope.command.*
serverscope.alerts
? 默认权限:OP 访问
⚠️ 常见问题
❌ 仪表盘存在,但无数据
→ Token 不正确
❌ 401 Unauthorised(未授权)
→ 缺少 Token
❌ 429 Too Many Requests(请求过多)
→ 请求频率过高
❌ 仪表盘无法打开
→ 请检查:
? 重新生成 Token
/serverscope web regenerate-token
? 总结
ServerScope 本质上就是 Minecraft 版的“Grafana”,且直接集成在服务器内部。
如果您希望:
- 更快地定位卡顿原因
- 理解服务器行为
- 监控服务器负载
→ 这款插件是必备之选。
ServerScope
Minecraft server monitoring and diagnostics
? About the plugin
ServerScope is a modern monitoring and observability plugin with a web dashboard for Minecraft servers 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:
- SMP servers
- Vanilla+ servers
- Large-scale projects with high load
⚡ Why you need it
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
? Requirements
Java 21+
Paper / Folia 1.21+
? Installation
- Download the .jar file
- Move it to the plugins/ folder
- Start the server
- 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:
Next:
- Open config.yml
- Find web.auth-token
- Paste it into the panel
**? How to enable external access (hosting)**
If the server is hosted:
- Check if you can open the port
- Specify in the config:
web:
host: 0.0.0.0
port: 25656
- Restart the server
- 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
? Conclusion
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧