LogoArcartX Doc

配置目录结构

Chronos 配置目录、职业配置与迁移备份

授权通过、云端业务加载后,plugins/Chronos/ 的主要结构如下。首次未授权启动时可能只有授权配置:

keybinding.yml
setting.yml
migration-state.yml
license.yml

migration-backups/ 与 migration-state.yml 只会在检测并处理旧格式时出现;全新安装不会为了占位而创建它们。

路径作用
client/*.yml客户端动画状态机
controllers/*.yml服务端控制器、状态、连招链和 execute
professions/*.yml职业配置;包含各职业允许的控制器、路由器、技能定义和默认装配。只读取此目录直接包含的 .yml 文件,不递归读取子目录
setting.yml只保存配置 schema 与默认职业
license.yml授权码 ID 与 KEY;修改后需重启服务器重新连接授权服务
keybinding.yml注册客户端按键,并声明哪些按键 ID 是技能槽
migration-backups/*旧格式迁移时保存的原始文件、哈希和完成标记
migration-state.yml最近一次成功迁移的结果摘要

新运行时不读取旧的 default_controller、switch_by_main_hand 或全局 triggers。 当 schema 小于 3 且检测到这些旧字段时,插件会先备份旧 setting.yml,再转换为新 setting.yml 和 professions/common.yml; 迁移失败会停止启用,不回退到旧逻辑。

文件之间的关系

控制器负责动作怎么运行;职业负责玩家当前可以使用哪些控制器、技能和槽位映射。职业等级、技能升级、解锁、资源和持久化需要由外部职业框架插件持有,Chronos 只消费快照。

On this page