加了 Mod 后游戏崩溃怎么排查

排查前先做什么

遇到 Mod 问题时，先别慌。按顺序做：

1. 记下精确的问题——什么时候出现、什么错误提示、复现步骤是什么
2. 隔离版本——如果不是隔离版本，立刻把当前状态备份
3. 备份重要世界——导出 .mcworld 存到隔离工作区之外
4. 对比测试——在干净的隔离版本上确认问题是否由 Mod 引起

标准排查流程

第一步：禁用所有 Mod，逐个加回来

最快定位问题的方法：

1. 在 Mods 页面全部禁用
2. 启动游戏，确认能正常进入
3. 启用第 1 个 Mod，测试
4. 启用第 2 个 Mod，测试
5. 找到导致崩溃的那个 Mod

如果同时启用了太多 Mod，可以用二分法——一次禁用一半，看问题在哪一半里。

第二步：检查版本匹配

定位到有问题的 Mod 后，检查：

第三步：看日志

LeviLauncher 和游戏都有日志可以看：

• 启动器日志：%APPDATA%\levilauncher.exe\logs\
• 游戏日志：隔离工作区里的游戏日志文件

日志里搜索崩溃点、Mod 名称、加载器错误。提交 Issue 时附上日志是必须的。

常见 Mod 问题和解决

游戏启动直接崩溃

• 先全部禁用 Mod，确认无 Mods 情况下能不能启动
• 如果还是崩，可能不是 Mod 的问题——检查 Gaming Services 和 GameInput
• 如果无 Mods 能启动，说明是某个 Mod 的问题 → 回到第一步

进游戏后加载世界卡住

• 行为包可能和存档不兼容
• 先导出备份，然后把行为包全部禁用试试
• 确认你在正式版还是预览版（预览版世界格式变化可能导致行为包不兼容）

资源包贴图丢失或显示黑块

• 资源包版本和游戏版本不匹配
• 资源包可能损坏 → 重新下载导入
• 多个资源包同时启用时优先级冲突 → 调整顺序

两个 Mod 互相冲突

• 都正常时能跑，但一起启用就崩
• 试试调整加载顺序（优先启用依赖方、后启用被依赖方）
• 不行的话只能二选一，找替代 Mod

恢复策略

如果搞坏了环境：

1. 删掉出问题的 Mod（先禁用，确认问题修复再删）
2. 整个隔离版本出问题 → 删除版本、重新安装、重新导入 Mod（逐个测）
3. 存档坏了 → 从之前导出的 .mcworld 备份恢复

预防复发

• 每次加新 Mod 前先备份
• 一个一个加，加完就测
• 预览版上少装 Mod
• 重要世界和 Mod 测试隔离在不同版本里
• 定期导出稳定配置的 LIP 包或 Mod 清单

延伸阅读

• 启用或禁用 Mod
• 导出 .mcworld 备份
• 某个版本无法启动