猹引擎 ​

ChaEngine服务端安装教程 ​

本页面面向服主和运维同学，目标是把 ChaEngine 服务端一次安装到位。

安装前准备 ​

1. 准备 ChaEngine 服务端插件包。
2. 准备 ChaCore 前置插件包。
3. 准备服务器文件读写权限与停服窗口。
4. 备份当前 plugins 目录与配置文件。

目录约定 ​

服务器根目录/
  plugins/
    ChaCore.jar
    ChaEngine.jar
    ChaEngine/
      config.yml
      block/
      entity/
      equip/
      ui/
        首页.yml
        活动中心.yml
        pages/
          home/
            index.html
          activity/
            center.html
          shop/
            index.html

安装流程 ​

第一步：停服并备份 ​

先停服，再备份当前运行环境，保留可回滚版本。

第二步：安装前置 ChaCore ​

把 ChaCore.jar 放入 plugins/ 目录。

第三步：安装 ChaEngine ​

把 ChaEngine.jar 放入 plugins/ 目录。

第四步：首次启动生成目录 ​

启动一次服务端，让 plugins/ChaEngine/ 自动生成默认目录和文件。
目录生成后停服，进入配置阶段。

第五步：填写主配置 ​

按你的部署需求填写 plugins/ChaEngine/config.yml。
配置模板参考 服务端配置文件。

第六步：放置业务配置文件 ​

把方块、生物、装备、页面配置放入对应目录。

plugins/ChaEngine/block/*.yml
plugins/ChaEngine/entity/*.yml
plugins/ChaEngine/equip/*.yml
plugins/ChaEngine/ui/*.yml

界面配置分层写法：

1. ui/*.yml 只存页面定义与窗口参数。
2. ui/pages/ 按业务模块分文件夹存放 html。
3. 每个 yml 的 html 字段填写相对路径，例如 pages/activity/center.html。

第七步：放置模型与页面资源 ​

把模型与页面资源放入标准目录，保持命名一致。

资源目录参考 猹引擎资源文件。

第八步：开服并加载配置 ​

重新启动服务端，执行引擎重载动作，让最新配置与资源生效。

安装完成后的动作 ​

1. 版本升级前先备份 plugins/ChaEngine/ 目录。
2. 每次替换配置后执行一次引擎重载动作。
3. 每次替换资源后保持服务端与客户端资源批次一致。