
Pack Doctor - 整合包诊断
找出你的整合包崩溃的原因:依赖问题、带根本原因的崩溃、损坏的配置、配方错误。只读运行,可离线使用。
Pack Doctor - 整合包诊断
你的整合包崩溃了。是哪个模组导致的? Pack Doctor 会读取你的模组、日志、崩溃报告和配置文件,告诉你出了什么问题、问题写在哪里以及有多确定。它可以在一个界面里显示,在游戏内显示,甚至当游戏完全无法启动时也能使用。
欢迎来到本模组的首个测试版!请在评论区留下你的反馈。这将帮助我们更快地修复 bug、添加你需要的功能,并持续改进模组。谢谢 ❤
它能发现什么
| 领域 | Pack Doctor 检查的内容 |
|---|---|
| 模组与依赖 | 缺少必需的模组、版本错误、为其他 Minecraft 或 NeoForge 制作的模组、不兼容的组合、同一个模组安装了两次、完全相同的副本、NeoForge 整合包中的 Fabric 和旧版 Forge jar、损坏的 jar。会考虑 Jar-in-jar 库,因此不会对捆绑的库产生误报。 |
| 日志与崩溃 | 49 种已知错误特征:缺少的类和方法、mixin 失败、模组加载错误、注册表错误、配方和数据包、JSON 和编解码器、网络数据包、内存、显卡驱动、看门狗。重复项会连同出现次数和周围的代码行一起分组显示。 |
| 根本原因 | 在崩溃报告中,Pack Doctor 会沿着异常链追踪到最内层原因,并将其标记为根本原因。像“Could not initialize class”这样的后续错误会被标记为后果。在普通日志中,崩溃前最后一个严重错误只是可能原因:它绝不会声称比日志所证明的更多。 |
| 配置文件 | TOML 和 JSON 语法错误会给出确切的行号和列号,使用与 NeoForge 相同的 TOML 解析器。值会根据模组自身注册的规则(ModConfigSpec)进行检查,因此在 1–10 的设置中出现“level = 50”会被捕获。未知键绝不会被当作错误。 |
| 数据与配方 | 配方、标签、战利品表、进度和函数错误,在世界加载时从游戏中实时捕获,并标明它们来自哪个模组或数据包。配方不会仅仅因为配方查看器不显示它就被判定为损坏。 |
| 性能 | FPS、帧时间、最慢帧、JVM 内存、客户端 tick 和服务端 tick(MSPT),并带有 60 秒图表。仅显示测量值:它不会假装知道是哪个模组导致了卡顿。 |
| 变更 | 在你允许的情况下,它会保留整合包的本地快照(模组 id、版本、文件哈希),并显示自上次检查以来新增、移除、更新或被静默替换的内容。“它在更新后就坏了”会变成一份简短的列表。 |
每项发现都有一个严重程度(critical、error、warning、info)、一个独立的置信度(high、medium、low)、它的来源(文件、行、列、元数据)以及关于该检查什么的通俗建议。如果某项检查无法运行,它会显示检查不可用及原因。它绝不会显示为已通过。



当游戏无法启动时
同一个 jar 可以独立运行。双击它(或在游戏文件夹中运行 java -jar os-pack-doctor-neoforge-1.21.1-1.0.0.jar),选择游戏文件夹,然后按检查整合包。无需启动 Minecraft,你就能获得关于模组、依赖、配置和日志的完整报告。非常适合“游戏在菜单出现前就关闭”的情况。
命令行:java -jar os-pack-doctor-neoforge-1.21.1-1.0.0.jar <game folder> [--json] [--out file] [--log file] [--server] [--lang ru|en]
可分享的报告

- TXT 或 JSON,UTF-8 编码。选择章节,在保存前查看确切的文本,复制一段简短摘要用于 Discord。
- 隐私: 路径中的用户名和主文件夹、访问令牌、API 密钥、密码以及(如果你愿意)服务器地址都会被隐藏。完整配置、世界数据、聊天和物品栏绝不会被包含在内。
- 报告绝不会覆盖另一个文件。如果某个文件夹不可写,你会看到原因,并可以选择其他地方。
- 不会向任何地方发送任何内容。 Pack Doctor 完全没有网络代码。
只读
Pack Doctor 只读取和解释。它绝不会删除模组,绝不会更改配置、配方或世界,绝不会下载或更新任何内容。损坏的配置绝不会被重写。分析器 bug 不会让你的游戏崩溃:该检查会被标记为不可用,其余检查继续进行。繁重的工作在后台运行,并带有进度条和取消按钮。
如何打开它
- 模组菜单 → O.S Pack Doctor → 配置。
- 或者在控制 → 按键绑定 → O.S Pack Doctor 中分配一个按键(默认没有按键,因此绝不会冲突)。
- 可选:崩溃后自动打开诊断(默认关闭)。
- 服务器:
/packdoctor scan(管理员)会将脱敏报告保存到ospackdoctor/reports。
致整合包制作者
- 你自己的规则。 将 JSON 文件放入
config/ospackdoctor/rules/。每条规则都是一个带有 id、严重程度、置信度和任意语言文本的模式;带有内置 id 的规则会替换它。损坏的规则会被跳过并报告,绝不会导致致命错误。 - 每项检查的设置、采样率、日志大小限制、快照、隐私和报告章节。
- 已完整翻译为英语和俄语。

平台: Minecraft 1.21.1、NeoForge 21.1.250(或更新的 21.1.x,会给出警告)、Java 21。可以安装在客户端、服务端或两者上;它不需要同时存在于两侧。
更多 O.S 模组
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。