Mod冲突检查与排序工具

这个 Mod 是干什么的

不是内容 Mod，是一个诊断工具。它不添加任何玩法，只回答四个问题：

1. 哪些 Mod 其实没加载成功，为什么？ 清单写错、DLL 没列进 <Assemblies>、缺前置、没在 Mod 面板批准、被信任名单拦下、游戏版本不匹配、加载时 Harmony 装配失败——每种都会写明原因和怎么处理。

2. 哪些 Mod 在抢同一个游戏方法？ 读 Harmony 的全局补丁表，把「多个 Mod 改同一个方法」分成三档：

   • 会互相破坏：有 Mod 改写方法 IL，或有 Prefix 能跳过原方法；
   • 需注意：多个 Mod 都改写返回值，最后执行的那个生效；
   • 可共存：各自追加逻辑，一般能同时工作。 每处都列出方法名、涉及的 Mod、各自的补丁类型与优先级。

3. 想全部保留，最少要放弃什么？ 在硬冲突之间算出最少需要停用哪几个 Mod，让其余 Mod 全部正常工作，可一键停用。可以给某个 Mod 点「必须保留」，方案会优先牺牲别的；两个都保留又确实冲突时，面板会直接说「没有可行组合」。也可以选「全部保留（接受全部冲突）」，一个都不停用。

4. 某个 Mod 的设置打开了，为什么不生效？ 每个 Mod 行有「体检」按钮：加载与信任状态、权限三方对照（清单声明 / 实际检测 / 上次批准）、它改的方法里哪些被别的 Mod 抢占。

安装

把 ModDoctor 文件夹放进游戏的 Mods 目录：

<游戏根目录>\Mods\ModDoctor\
里面应有：manifest.xml、ModDoctor.dll、README.txt

启动游戏 → 主菜单 Mod 面板 → 启用 Mod Doctor。首次启用需要批准两项权限：

• files：读取 Mods 目录、写报告与配置
• reflection-external：读取 Harmony 的补丁明细

批准后重启游戏。升级时覆盖 manifest.xml 与 ModDoctor.dll，回 Mod 面板重新确认启用即可。

使用

1. 进游戏按 F8 打开面板（启动时若发现问题会自动弹出）。
2. 先看「共存方案」第一行：绿色说明当前没有需要处理的硬冲突。
3. 有红色结论时，二选一：按方案停用最少的几个，或「全部保留（接受全部冲突）」。
4. 启用/停用的改动重启游戏才生效。

面板里还有：冲突明细（方法级）、问题与修复建议、每个 Mod 的状态、加载顺序、单 Mod 体检。 所有结论同时写到 <游戏根目录>\Mods\ModDoctor-report.txt，反馈问题时直接贴这个文件即可。

关于排序，必须说清楚

游戏启动顺序是：扫描 Mods 文件夹 → 逐个加载并装配补丁 → 按 modOrder 重排列表 → 加载资产。

所以 排序只影响列表顺序和资产覆盖顺序，不改变补丁的装配顺序——补丁冲突不能靠排序解决。需要「A 先于 B 初始化」的依赖，靠文件夹名（如加 00_ 前缀），不是靠 modOrder。创意工坊 Mod 在本体 Mod 之后装配，这一点也改不了。

它不会做的事

• 不修改任何 Mod 的文件，只读取状态、只切换启用开关；
• 不绕过游戏的信任审批；
• 无法让同一个方法上两个「会跳过原方法的 Prefix」同时生效——Harmony 的规则是第一个返回 false 的 Prefix 会跳过其余有副作用的 Prefix 与原方法。工具能做的是查清谁在抢、让谁赢，不能把两边逻辑合并；
• 不检测 Mod 之间通过自定义事件、物品 ID 的重复注册，也不检测运行期异常（这类要看游戏日志的异常栈）。

反馈

请带上：面板截图（共存方案 + 出问题的那个 Mod 的体检）、ModDoctor-report.txt、以及触发动作（点了什么、期望什么、实际什么）。有这三样，绝大多数「某 Mod 不生效」都能定位到具体方法。