ServerScope

插件

· 作者 Erotoro

ServerScope 是一款专为 Paper 和 Folia 服务器设计的监控与可观测性插件,通过集成的诊断系统为管理员提供关于服务器性能、健康状况和稳定性的清晰洞察。

0 本站下载 0 关注 更新于 4 个月前

最新 1.1.0 · 26.1.2 · Folia / Paper

一键开服(送7天)

ServerScope

Minecraft 服务器监控与诊断工具

? 插件简介 ServerScope 是一款现代化的监控与可观测性插件,为运行在 Paper / Folia 1.21+ 上的 Minecraft 服务器提供 Web 仪表盘。

它赋予管理员对服务器状态的完全控制权:性能、卡顿、负载、可疑事件——一切尽在掌握。

? 适用场景:

  1. SMP 服务器
  2. Vanilla+ 服务器
  3. 高负载的大型项目

⚡ 为什么需要它 使用 ServerScope,您可以快速了解:

  • ❓ 服务器当前为何卡顿
  • ? 哪些区块导致了负载
  • ? 实体数量是否正在增加
  • ⚠️ 这究竟是真实问题还是仅属警告
  • ? 哪些插件行为可疑

? 主要功能

  • ? 实时指标:
  •   TPS、MSPT、实体数、区块数
    
  • ? 世界与区块诊断
  • ? 事件与插件分析
  • ? 警报系统
  • ? 内置 Web 仪表盘
  • ? JSON API
  • ? 管理游戏内指令
  • ? 数据存储(SQLite)

? 依赖要求​ Java 21+ Paper / Folia 1.21+

? 安装方法​

  1. 下载 .jar 文件
  2. 将其移动到 plugins/ 文件夹中
  3. 启动服务器
  4. 等待配置文件生成

? 配置文件: plugins/ServerScope/config.yml

⚙️ 首次启动即包含的功能 ​ 以下功能在首次启动后自动启用:

  • 存储
  • 收集器
  • 警报
  • 分析
  • Web 面板

? 默认 Web 面板设置:

  • 仅限本地访问 (127.0.0.1)
  • 端口 8080
  • Token 自动生成

? 如何访问 Web 面板​ 如果您在同一台机器上操作:

接下来:

  1. 打开 config.yml
  2. 找到 web.auth-token
  3. 将 Token 粘贴到面板中

**? 如何启用外部访问(托管服务器)**​ 如果服务器是托管的:

  1. 检查是否可以开放端口
  2. 在配置文件中指定:
web:
  host: 0.0.0.0
  port: 25656
  1. 重启服务器
  2. 访问: http://IP:PORT/

? 重要提示: token 是必填项 端口必须被托管服务提供商允许

? 安全性(重要) ​ ❌ 请勿公开 Token ❌ 请勿在未加保护的情况下开放仪表盘

? 分析功能​ 允许您追踪:

  • 缓慢的事件
  • 频繁的事件
  • 负载尖峰
  • 插件影响

? 默认监控:

  • player_interact
  • block_break / place
  • entity_damage
  • inventory_click
  • creature_spawn

? 警报系统​ 通知系统: ? CRITICAL(严重)— 在游戏中显示 ? WARN(警告)— 保留在 UI / 控制台中

示例:

  • TPS 过低
  • MSPT 过高
  • 区块过载
  • 实体过多

? 存储机制​

  • SQLite 数据库
  • 异步写入
  • 极低负载

? 文件路径:

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”,且直接集成在服务器内部。

如果您希望:

  • 更快地定位卡顿原因
  • 理解服务器行为
  • 监控服务器负载

→ 这款插件是必备之选。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源