Troubleshooting

常见问题与故障排查

启动阶段崩溃：NoSuchMethodError / NoSuchFieldError

这类错误通常表示生产 jar 的映射、MMCE 版本或依赖组合不匹配。请先确认使用官方发布的 reobf jar，而不是开发环境的普通 class/jar；再确认整合包中的 MMCE、AE2 EL、CrazyAE 等版本与发布说明一致。

不要同时保留两个 MMCE Complement jar。搜索 mods 及其子目录，删除旧版后再测试。

附属模块不生效、方块不变色

1. 确认 main 已成型，并触发一次主结构检测。
2. 核对控制器朝向；模块坐标与主 JSON 同时旋转。
3. 核对全部直接与间接父模块都生效。
4. 检查冲突关系；冲突双方同时失效。
5. 检查与父模块重叠的位置；不同定义以父模块为准，子模块该位置不会参与匹配。
6. 查看控制器 NBT 中 mmceComplementModules。空数组表示当前没有生效模块。
7. 检查日志中的 attachment module 加载错误。

模块中的 MMCE 模块化方块只有在模块最终生效并被收集进机器后才会使用机器外壳颜色。

选择工具没有导出内容

• 使用的是 mmce_complement:attachment_construct_tool。
• 玩家处于创造模式且有管理员权限。
• 潜行右键的是已识别机器的控制器。
• 选区至少有一个不属于 main 或当前生效模块的新方块。
• 想排除已有模块时，必须先让该模块真正生效。

如果扣除当前形成结构后为空，工具会提示而不会导出。控制器未识别时则有意回退为原版完整结构导出。

hasModule 一直是 false

moduleList 表示声明列表，hasModule 才表示生效状态。检查拼写与大小写，并让主结构重新检测。NBT 中应能看到模块 ID；如果 mmceComplementModules 为空，问题在结构/依赖检测而不是 ZenScript 编译。

可选组件在 JEI/创造栏中不存在

网络组件按依赖和关键 API 类动态注册。仅安装名称相似的模组并不够，例如 ME 能源总线需要 AE2 Extended Life 与 CrazyAE 对应通道。查看启动日志并核对 安装与依赖。

流体 GUI 显示 0 或与世界不同步

先确认客户端与服务端本模组版本一致。对已有存档，从旧版跨越多个开发构建时可能存在 TileEntity NBT/metadata 差异；备份世界后在测试区放置一个全新仓进行对比。若新仓正常而旧仓异常，请在 issue 中附旧仓 NBT。

流体释能仓不接收/不转换

• fluid_energy_ratios 中必须使用准确的流体 registry name，而不是本地化名称。
• 比例、流体容量和能源容量必须是正整数文本。
• 内部能源已满时不会继续转换。
• 剩余能源空间若不足容纳 1 mB 的完整转换结果，也会暂时保留流体。

ME 矿物词典总线主动拉取慢或闪烁

确认使用 1.3.0 正式 jar。主动模式应把最多 16 种候选写入幽灵配置，而非直接反复写入物品槽。切换关闭后配置应立即清空且剩余物品返回网络。若问题仍在，附上 AE2 EL、CrazyAE、MMCE 精确版本和服务器日志。

报告问题时请提供

• MMCE Complement、MMCE、Forge 和全部相关可选模组版本
• latest.log，崩溃时再附完整 crash report
• 机器 JSON 与最小化 ZenScript
• 控制器和相关仓室 NBT
• 能稳定复现的搭建顺序与控制器朝向

问题反馈：GitHub Issues