Getting Started

安装、依赖与快速开始

环境

• Minecraft：1.12.2
• Forge：使用与你的 MMCE/整合包兼容的 1.12.2 Forge 版本
• 必需：Modular Machinery Community Edition、GeckoLib 3
• CraftTweaker：MMCE 本身的脚本环境需要它；本模组的附属模块脚本 API 也依赖该环境

把 mmce_complement-1.3.0.jar 放入客户端和服务端的 mods 文件夹。多人游戏必须保证两端版本一致。

可选兼容

功能	条件
无线通量网络输入/输出仓	Flux Networks 及其兼容 API
ME 机械矿物词典输入总线	AE2 Extended Life 与 MMCE 的 ME 物品总线
ME 机械能源输入/输出总线	AE2 Extended Life + CrazyAE 对应能源通道
ME 机械魔力输入/输出总线	AE2 Extended Life + CrazyAE + Modular Magic 对应能力
流体仓与总成中的气体	Mekanism；安装后自动使用气体兼容 TileEntity

可选模组缺失时，本模组不会注册相应组件；机器 JSON 若仍引用该组件会加载失败。

第一次启动

1. 启动一次游戏，让 Forge 生成 config/mmce_complement.cfg。
2. 关闭游戏后修改倍率、总成容量和流体释能表。
3. 用 JEI/HEI 确认仓室名称、等级和当前 tooltip 数值。
4. 在 MMCE 的 machinery 目录中编写机器 JSON，并把本模组方块作为普通模块化组件引用。
5. 修改配置或机器定义后，完整重启客户端/服务端进行发布前验证。

JSON 中引用方块

本模组命名空间是 mmce_complement。例如：

{
  "x": 1,
  "y": 0,
  "z": 0,
  "elements": ["mmce_complement:batch_hatch"]
}

有 metadata/变体的方块，请沿用 MMCE 对带 metadata 方块的原生写法。不要根据创造栏显示顺序猜 metadata；以 JEI 导出、已有机器定义或“组件总览”中的说明为准。

推荐的发布前流程

1. 在干净测试实例中只安装必需依赖与本模组，确认能进入主菜单。
2. 再加入整合包的可选网络模组，确认对应组件注册且 GUI 可打开。
3. 分别验证机器形成、拆除、区块重载和服务端重启后的状态。
4. 对附属模块验证四种状态：缺失、完整、依赖缺失、发生冲突。
5. 对性能仓使用已知时长/耗能的配方验证倍率，并检查工厂的特殊自定义线程未被线程仓放大。
6. 修改 mmce_complement.cfg 后再次验证 tooltip 与实际行为一致。