Crash Doctor

Crash Doctor

Crash Doctor 帮助你在不翻阅 Java 堆栈跟踪的情况下了解 Minecraft 崩溃原因。

游戏崩溃时，Crash Doctor 会分析崩溃报告、latest.log、已安装的模组以及近期的模组变更，找出最可能的原因。它会用通俗易懂的语言说明诊断结果、展示判断依据、按可能性排列问题模组，并生成简洁的支持报告，方便你分享给模组开发者、整合包支持人员，或帮助你排查问题的朋友。

功能

• 用通俗易懂的语言诊断常见的 Minecraft 崩溃原因
• 根据证据推理，按可能性排列问题模组
• 将 Fabric 和 Forge 的依赖错误解析为清晰的解决方案
• 检测 Mixin 故障、缺失的类、Java 版本问题、内存崩溃、本机库问题、显卡驱动故障、配置损坏、注册表错误以及网络不匹配
• 检测 mods 文件夹中的重复模组 JAR 和加载器不匹配的 JAR
• 在崩溃后尽可能显示崩溃弹窗
• 异常退出后，在下次启动时显示“你上次崩溃了”提示
• 生成可直接复制的 Markdown 支持报告
• 分享报告前，会对用户名、主文件夹路径、电子邮件地址、令牌、会话 ID 和 UUID 进行脱敏
• 完全离线运行，不会将日志上传到任何地方

使用方法

安装对应的 Fabric 或 Forge JAR，启动 Minecraft，然后使用：

• /crashdoctor
• /crashdoctor analyze

你也可以在 Minecraft 的控制菜单中为“Open Crash Doctor”（打开 Crash Doctor）绑定按键。

隐私

Crash Doctor 在你的电脑本地运行，不会上传崩溃报告、日志、模组列表或分析数据。

只有在你选择复制时才会生成支持报告，并且分享前会对敏感信息进行脱敏。

源代码

目前项目尚处于早期阶段，Crash Doctor 暂不开源。未来可能会有所改变。

使用许可

你可以在整合包中使用 Crash Doctor，包括公开发布的整合包，但下载链接必须指向官方 CurseForge 或 Modrinth 页面。

未经许可，不得修改后再分发、重新上传或复用源代码。

限制

Crash Doctor 提供基于证据的建议，但不保证诊断结果一定准确。复杂的模组交互问题可能仍需手动排查。

崩溃弹窗能否显示取决于游戏进程是否正常关闭。如果 Minecraft 被强制终止，Crash Doctor 会尝试在下次启动时显示诊断结果。