模组冲突排查——装完启动就崩怎么办

典型冲突场景

你装了新模组 → 启动游戏 → 加载到一半 → 闪退 / 崩溃弹窗。这是最经典的模组冲突现象。

原因有三类：

1. 版本不兼容：模组要求 MC 1.20.2 但你装在 1.20.1 上
2. 加载器不兼容：这是 Forge 模组你用 Fabric 加载
3. 模组间冲突：两个模组修改了同一块代码，互相覆盖

第一步：看崩溃日志

崩溃日志是启动器和游戏输出的诊断信息。路径：

.minecraft/pojav_configs/<版本号>/crash-reports/

里面有 crash-<时间>.txt 文件。用文件管理器打开它，看最后几十行：

• 关键词："missing dependency" → 缺依赖。比如缺 Fabric API，或者缺 JEI
• 关键词："version mismatch" → 版本不对。模组需要更高的 MC 版本或加载器版本
• 关键词："Mixin conflict" 或重复条目 → 模组间冲突
• 关键词：memory → RAM 不够了

第二步：二分法定位（最有效）

如果日志看不懂，用这个方法一定能找到元凶：

1. 把 mods/ 目录里所有 jar 备份到别处
2. 先只装 Fabric/Sodium/Lithium 这些基础模组，启动测试（确认基础环境没问题）
3. 每次加 2~3 个模组，启动测试
4. 一旦加了某批后崩溃 → 从这批里再二分 → 直到找到具体是哪一个

这个方法虽然慢，但 100% 有效。

常见冲突类型和解决办法

缺少依赖

日志特征：java.lang.NoClassDefFoundError: X 或 Fabric API not found

解决：去 CurseForge / Modrinth 看这个模组的依赖列表，把缺的装上。Fabric 模组通常需要 Fabric API；很多科技模组需要 JEI。

加载器选错

日志特征：The mod file appears to be a Forge mod, but you're running Fabric Loader（或反过来）

解决：确认你的加载器类型，去 Modrinth 下载对应加载器版本的模组（每个模组页面有 Fabric / Forge / Quilt 三个下载按钮）。

模组版本不匹配

日志特征：Mod version mismatch: mod X requires Y, got Z

解决：要么升级 Minecraft 版本，要么找该模组的旧版本。不要跨 MC 版本装模组 jar。

Shader / 渲染器冲突

日志特征：崩溃在 renderer 或 shader 相关类

解决：Fabric 路线用 Sodium + Iris（不要同时装 OptiFine）；Forge 路线用 OptiFine（不要同时装 Sodium）。两个都想装 = 必然冲突。

崩溃后清理

有时候崩溃会留下损坏的配置文件。定位到有问题的模组并移除后，建议：

1. 删除 crash-reports/ 目录里的旧崩溃文件
2. 删除问题模组留下的配置文件夹（通常在 .minecraft/config/ 下，按模组名命名）
3. 重新启动游戏