安装 ChaEngineMod ​

选择正确的客户端文件 ​

客户端文件必须同时匹配 Minecraft 版本与加载器：

Forge 1.16.5 的 ChaEngineMod 以 Java 8 为编译目标，也支持在 Java 11 运行；若整合包内其他旧 Mod 对 Java 有更严格限制，以整合包整体要求为准。

不要用相近小版本的文件代替，也不要在同一客户端同时安装 Forge 与 NeoForge 版本。完整说明见版本兼容。

安装前置与 Mod ​

1. 安装表中对应的 Minecraft、加载器与 Java。
2. 关闭游戏，把 ChaEngineMod 放入当前实例的 mods/。
3. ChaEngineMod 已随发布包携带模型运行所需的内部库，不需要另行下载同名依赖。
4. 需要读取 .chaassets 时，再安装对应版本的 ChaAssetsMod；它是可选组件。
5. 启动游戏一次，确认加载器的 Mod 列表中存在 ChaEngineMod。

ChaEngineMod 是客户端 Mod，不应放进服务端 plugins/。服务端安装的是 ChaEngine 与 ChaCore 插件。

更新动作与模型残影功能时，请同时更新服务端插件与对应客户端 Mod，并完整重启两端。同一版本号也可能有不同构建批次；只替换磁盘文件或执行配置重载，不能让已运行的游戏使用新代码。新残影指令与 API 需要客户端完成本批次动画库同步后才能接收。

准备 ChaEngine 资源目录 ​

在当前游戏目录创建：

resourcepacks/ChaEngine/
├─ model/
├─ particles/
└─ textures/

模型、动画与模型贴图放在 model/；基岩版粒子索引与定义放在 particles/；粒子纹理放在 textures/。实际路径必须与服务端配置完全一致。

服务端不会向客户端发送模型、动画、纹理或粒子文件。每位玩家都要提前取得同一套资源。如果使用加密包，请按ChaAssets 资源加密完成构建、下载与授权。

进入服务器后如何确认成功 ​

1. 客户端启动时没有 ChaEngineMod 加载错误。
2. 加入已安装 ChaEngine 的服务器后，没有持续出现能力未准备或资源授权失败提示。
3. 由管理员触发一个已配置的模型物品、物品背景、模型实体、粒子效果或相机预设。
4. 客户端能看到资源，且重新进入服务器后仍能正常显示。

若只有某一位玩家看不到效果，通常先检查该玩家的 Mod 版本和资源文件，而不是重新修改服务端配置。

更新客户端 ​

1. 备份 resourcepacks/ChaEngine/ 中自己维护的资源。
2. 关闭游戏并确认没有残留 Java 进程占用文件。
3. 删除旧 ChaEngineMod 文件，再放入与当前游戏版本匹配的新文件。
4. 使用 ChaAssetsMod 时同步核对它的版本。
5. 启动后重新进入测试服务器，验证模型、物品背景、动画、粒子、按键与相机。

不同版本的客户端可以连接同一服务器，但每个客户端都必须使用自己版本对应的 Mod 文件。

常见安装问题 ​

资源问题请继续阅读ChaEngine 资源目录，连接问题请按故障排查处理。