
模组医生
为你的服务器崩溃找到肇事模组,写一份简洁的崩溃报告,并能在下次重启时关闭某个模组。
Mod Doctor
为服务器崩溃和异常找出背后的模组,生成一份简明崩溃报告,并可在下次重启时停用某个模组。还会审查新服务器是否存在常见配置错误。仅服务端使用。
功能
- 按模组归类异常。 它监视服务器记录的每一个错误,并利用堆栈跟踪按引发错误的模组进行分组。同一个 bug 触发一千次也只算一行。
- 加载失败的插件。 在启动时以及执行
/doctor时,它会列出所有本应运行但未能运行的插件,并附上服务器给出的原因。 - 崩溃报告。 崩溃后,它会在服务器目录旁写入
mod-doctor-crash-<time>.txt,注明可能的罪魁祸首及其可信程度,并附带堆栈和最后几行日志。下次启动时会打印该报告。 - 停用模组。
/doctor disable <mod>会在下次重启时移除某个模组,/doctor enable <mod>则撤销该操作。在移除其他模组所依赖的模组前会先发出警告,绝不覆盖文件,也绝不删除文件。 - 配置审查。
/servercheck会针对每种常见错误打印一行 PASS 或 WARN。
崩溃的捕获方式
| 发生的情况 | Mod Doctor 的处理方式 |
|---|---|
插件在加载时失败,服务器以 mod_error 停止 |
在退出时写入报告,并指明该插件 |
| 某个世界崩溃 | 两秒后写入报告,无论该世界是否恢复 |
| 服务器因其他不良原因停止 | 在退出时写入报告 |
| 进程在无预警的情况下死亡(被杀死、断电、JVM 崩溃) | 在下次启动时根据运行期间保存的信息写入报告,并读取任何 hs_err_pid 文件 |
对于突然死亡,报告的置信度绝不会高于中等。异常本身并不会终止进程,因此最后出现的异常只是线索,而非证据。
命令
仅限管理员和控制台使用。
| 命令 | 作用 |
|---|---|
/doctor |
未运行的模组、按模组归类的异常、重复 ID、上次崩溃报告 |
/doctor disable <mod> [force] |
从下次重启起停用某个模组。<mod> 为插件名、Group:Name 或 jar 文件名。force 会跳过关于依赖该模组的模组的警告 |
/doctor enable <mod> |
撤销上述操作 |
/servercheck |
配置审查。/doctor check 作用相同 |
/servercheck 检查的内容
白名单或密码、最新备份的时间(服务器自带备份、Server Backup,或你指定的文件夹)、管理员数量、permissions.json(是否有效,以及是否有普通组持有 *)、已加载的世界及其配置文件、可用磁盘空间、服务器版本与服务器已知最新版本的对比、登录模式以及堆大小。它只读取并报告,不做任何更改。
设置
位于模组数据目录中的 moddoctor.properties(首次启动时创建):
| 键 | 默认值 | 含义 |
|---|---|---|
keepReports |
20 |
保留的崩溃报告数量;更旧的会被移除 |
logTailLines |
40 |
复制到报告中的日志行数 |
maxBackupAgeHours |
48 |
最新备份早于该值时,/servercheck 发出警告 |
maxOperators |
5 |
管理员数量超过该值时,/servercheck 发出警告 |
minHeapMb |
4096 |
堆大小低于该值时,/servercheck 发出警告 |
extraBackupFolder |
空 | 另一个用于查找备份的文件夹 |
Mod Doctor 与 Mod Compat Guard
Mod Compat Guard 做的是预测:它读取清单和字节码,告诉你哪些会失败。Mod Doctor 报告的是服务器运行期间实际发生的失败。Mod Doctor 不重复 Guard 的任何检查。若安装了 Guard,/doctor 会显示其错误计数,崩溃报告中也会包含它的错误,因此两者配合良好。
限制
- 重复的插件 ID 或依赖循环会在任何模组运行之前就让服务器停止,因此 Mod Doctor 无法在那次启动中报告。如果服务器运行期间出现第二份副本,
/doctor确实会发出警告。对于无法启动的服务器,请使用 Mod Compat Guard 的独立命令。 - 堆栈跟踪中出现的模组只是证据,而非定论。某个模组可能因另一个模组或服务器自身引发的崩溃而被归咎。
- 在 Windows 上,已加载的 jar 无法移动。此时
/doctor disable会在config.json中停用该模组,并在下次启动时将文件移动到mods-disabled。此路径已在真实服务器上测试。Linux 上使用的直接移动仅在单元测试中测试过,未在真实的 Linux 服务器上测试。 - 读取
hs_err_pid文件仅在单元测试中测试过。尚无真实的 JVM 崩溃文件经过该功能处理。
已在服务器 0.7.5 上使用一个一次性测试模组产生的真实故障进行测试:世界崩溃、setup() 失败、缺少依赖、原因为 crash 的关机,以及被终止的进程。它还在与其他 34 个模组同时运行的情况下运行过,未出现异常。在 0.8.0-pre.3 上,它能编译、通过 Update-Ready Check 并加载,但仅限于没有游戏资源的裸模式。
安装:将 jar 放入服务器的 mods/ 文件夹并重启。许可证:MIT。
与 Hypixel Studios 无关联、未获其认可,也无任何联系。
需要定制功能? 我按需开发小型服务器插件,价格从 $35(修复)和 $90(全新的单功能插件)起:https://ko-fi.com/molonlav3/commissions 。如果这个模组为你节省了时间,请我喝杯咖啡有助于持续更新:https://ko-fi.com/molonlav3
要更新 Hytale? 查看哪些模组兼容 Update 8:https://playerbase-servers.molonlav3.workers.dev/update-8
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。