猹引擎 ​

ChaEngine客户端接入教程 ​

本页面用于指导玩家整包和运维同学完成 ChaEngine 客户端安装。

接入前准备 ​

1. 准备 ChaEngine 客户端模组文件。
2. 准备与服务端同批次的资源包文件。
3. 确认使用支持版本的客户端实例（Forge 1.16.5 或 NeoForge 1.21.1 / 1.21.8）。

目录约定 ​

客户端根目录/
  mods/
    ChaEngineMod-*.jar
  resourcepacks/
    ChaEngine/
      model/
      ui/
        pages/
          home/
            index.html
          activity/
            center.html
          shop/
            index.html

接入流程 ​

第一步：关闭客户端 ​

安装前先完全关闭客户端和启动器实例。

第二步：安装客户端模组 ​

把 ChaEngineMod-*.jar 放入 mods/ 目录。

第三步：安装资源包 ​

把 ChaEngine 资源目录放入 resourcepacks/。

界面资源按业务分层：

1. ui/pages/home/ 存首页类页面。
2. ui/pages/activity/ 存活动类页面。
3. ui/pages/shop/ 存商店类页面。

第四步：启用资源包 ​

在客户端资源包列表中启用 ChaEngine 资源包。

第五步：启动客户端并进服 ​

重启客户端后进入目标服务器。

第六步：版本更新替换流程 ​

更新时按顺序替换：

1. 替换 mods/ 下的客户端模组文件。
2. 替换 resourcepacks/ChaEngine/ 下的资源文件。
3. 重启客户端并重新进服。

安装注意事项 ​

1. 客户端资源命名与服务端配置命名保持一致。
2. 客户端模组版本与服务端发布批次保持一致。
3. 多整包并行维护时，为每个整包保留独立备份目录。