// 服务器医生 · SERVER DOCTOR

JibaiServerDoctor

先诊断 —— 再对症,别再盲目清理。

给你的 Minecraft 服务器请一位随叫随到的「全科医生」。用 0-100 健康评分、风险列表和 AI 诊断包,帮你看懂服务器为什么卡。不删数据、不破坏方块、不清理实体。全核心兼容 Bukkit / Spigot / Paper / Purpur。

MC 1.20+ Java 17 全核心兼容 已发布 v1.0.0
/DOCTOR STATUS · 体检报告
0HEALTH SCORE
内存 / 实体 / 区块正常
红石高频区块 ×2关注
world 实体过高风险
向下,看天亮
功能 · 拂晓

别的插件帮你「清理」,医生帮你「看懂」

服务器卡了,很多人第一反应是装一堆清理、优化插件,结果卡还是卡——因为根本不知道问题出在哪。服务器医生先诊断,再对症。

🩺全核心通用

纯 Bukkit / Spigot API,不用 Paper 专属接口、不用 NMS、不用反射。Bukkit / Spigot / Paper / Purpur 都能跑,已在 Paper 1.21.8 实测。

📊0-100 健康评分

把内存、实体、掉落物、区块、红石、漏斗、报错、tick 延迟综合成一个分数,一眼看懂服务器现在健不健康。

💡不只报问题,还教你怎么办

每条风险都附带原因和处理建议,比如实体过多时告诉你去哪定位刷怪塔、养殖场或掉落物堆积。

📋一键体检报告

/doctor report 生成 Markdown 报告:环境、内存、实体、区块、红石、漏斗、报错、评分和问题排名,存档随时看。

🤖诊断包 + AI 提示词

/doctor export 打包报告、错误摘要、环境和 ai-prompt.txt。把它直接复制给 AI,就能得到针对性的优化建议。

🔍精准定位区块 / 玩家

/doctor inspect chunk 看你脚下区块的实体、掉落物、漏斗、红石;inspect player 看某玩家周围是不是卡顿源。

🧯红石 / 漏斗监控

红石高频区块、漏斗密集区块按阈值提醒。重点:只记录和提醒,绝不破坏你的任何方块。

📑日志错误分析

自动读取 logs/latest.log,统计 ERROR / WARN / Exception,聚合同类报错并尝试认出是哪个插件在闹脾气。

🔔管理员实时告警

健康分过低、内存爆表、红石漏斗超标时自动提醒在线管理员,带冷却时间,不刷屏。

健康评分 · 微光

一个分数,一眼看懂服务器状态

把内存、实体、掉落物、区块、红石、漏斗、报错、tick 延迟等因素综合成 0-100 的健康分。分数越高越健康。

90-100
🟢
优秀 · 状态很棒
70-89
🔵
正常 · 一切正常
50-69
🟡
需要关注 · 有苗头了
30-49
🟠
存在风险 · 该处理了
0-29
🔴
严重异常 · 赶紧排查
风险列表示例 · /doctor risks
1. [严重] world 世界实体数量过高:共 5860 个实体
   建议:实体过多会显著增加每 tick 计算量,请用 /doctor inspect
        定位实体密集的区块,常见来源是刷怪塔、养殖场或掉落物堆积。
快速上手 · 天光渐亮

3 步,给服务器做一次体检

01

安装

把 JibaiServerDoctor-1.0.0.jar 丢进 plugins/,重启服务器。

02

体检

进游戏或在控制台输入 /doctor status 看当前状态,/doctor report 生成报告。

03

排障

发现卡顿就 /doctor export,把 ai-prompt.txt 复制给 AI,照建议优化。

指令与权限 · 天色渐明

主指令 /doctor,别名 /jdoctor、/serverdoctor

指令作用谁能用
/doctor status查看服务器当前健康状态status 权限
/doctor report生成 Markdown 体检报告report 权限
/doctor export导出诊断包(含 AI 提示词)export 权限
/doctor inspect chunk检查你所在的区块(玩家专用)inspect 权限
/doctor inspect player <玩家名>检查指定玩家附近区域inspect 权限
/doctor risks查看当前风险列表risks 权限
/doctor errors查看最近日志错误摘要errors 权限
/doctor reload重载配置文件reload 权限
/doctor help查看指令帮助所有人

⌨️ 所有指令都支持 Tab 键补全,控制台也能执行大部分指令。核心权限节点:jibai.doctor.admin 一个搞定全部,默认全部为 OP 权限。

支持的核心 · 天光大亮

目标版本 Minecraft 1.20.x 及以上

Paper

✅ 优先支持 · 实测 1.21.8

Purpur

✅ 支持

Spigot

✅ 支持

Bukkit

✅ 支持

Folia / Velocity / BungeeCord

❌ 暂不支持

Forge / Fabric / 基岩版

❌ 暂不支持

🛡️安全第一 · 医生的底线

常见问题 · 第一缕光

你可能想问

它会帮我自动清理卡顿源头吗?

不会,也不应该。服务器医生的定位是诊断,动手清理请交给你自己或专门的清理插件——这样更安全,也不会误删你精心搭建的红石机器。

为什么 tick 延迟不是标准 TPS?

为了全核心通用,它不依赖 Paper 的 TPS API,而是自己测量真实 tick 间隔算出近似延迟(理想值 50ms,越低越好)。

诊断包会泄露我的服务器隐私吗?

不会。它不打包敏感配置文件,导出前还会对 IP、密码、Token 等自动打码。

能自定义提示语和颜色吗?

可以。messages.yml 里所有文本都能改,支持 <green> 标签和 &a 颜色码。

下载 · 天亮了

天亮了,给服务器做次体检

当前版本 v1.0.0 · 已在 Paper 1.21.8 实测 · 全核心编译 · 已发布到 MineBBS。

📦 JibaiServerDoctor-1.0.0.jarMC 1.20+ · Java 17