免费 ArcartX Chronos 2.0 基础动作配置 1.0

---

一、资源简介

这是一套基于 ArcartX Chronos 2.0 编写的完整入门配置。

资源以原版 Steve 基础人模为底，将 27 个基础动作与7 个法师动作整合进同一个运行模型，并提供配套的客户端状态机、服务端控制器和七段左键连招。

配置文件内加入了较为详细的中文注释。即使之前没有接触过 Chronos，也可以直接查看注释了解：

● 哪个文件负责播放动画
● 哪个区域负责检测按键
● 动作持续时间在哪里修改
● 下一段动作什么时候可以输入
● 如何在动作中加入消息、位移、伤害或特效

这不是一份只有空架子的模板。
第一段动作已经附带可运行的消息与前移脚本，可直接观察 execute 的使用方式。

---

二、测试环境


注意： 本配置使用 Chronos 2.x 字段，例如 state_name。请勿直接放入 Chronos 1.x 环境，也不要改回旧字段 stateName。

---

三、主要内容

1. 完整基础状态

运行模型包含待机、行走、跑步、潜行、跳跃、游泳、飞行、滑翔、匍匐、梯子、骑乘、睡觉和死亡等基础动作。

客户端控制器会根据玩家当前行为自动切换对应动画，不需要为走路或跑步额外编写服务端状态。

2. 七段左键连招

左键 → 动作 1
继续左键 → 动作 2
继续左键 → 动作 3
继续左键 → 动作 4
继续左键 → 动作 5
继续左键 → 动作 6
继续左键 → 动作 7

玩家可以在当前动作尚未播放结束时提前点击下一段。输入会被暂时保存，并在配置指定的时间进入下一段，避免快速点击导致动作提前抢播。

3. 第一段脚本示例


execute:
发送攻击提示:
at: 0
expression: 'self.sendMessage("攻击-1")'

向前位移:
at: 100
expression: "self.dash(0.45, 0.0)"


实际效果：

● 进入第一段时向玩家发送“攻击-1”
● 动作开始 100ms 后沿角色面朝方向前移
● 如果动作在 100ms 前被打断，尚未执行的位移不会补触发

4. 中文白话注释

服务端控制器中对常用字段进行了直观说明：


duration = 这一段持续多久
derive = 什么时候允许玩家提前按下一段
buffer_at = 提前按下后，什么时候真正播放下一段
cancel = 什么时候允许其它技能打断当前动作
move_cancel = 什么时候允许玩家靠方向键结束动作
execute = 动作播放到指定时间时执行的脚本

---

四、附件结构


controllers/
└─ 法师基础.yml # 服务端状态、时间、窗口、连招和脚本

client/
└─ 法师基础控制器.yml # 客户端基础状态与七段动画映射

resource/model/人模/
├─ 法师基础.bbmodel # 实际运行模型，内含34个动画
└─ 法师基础.animation.json # 七段法师动作的制作源/同步副本

action-spec.yml # 动画长度、状态关系和部署信息
DEPLOYMENT.md # 简明部署说明


运行模型中的动画数量：34 个，其中基础动作 27 个、法师动作 7 个。

---

五、安装方法

步骤 1：放入服务端配置


法师基础.yml
-> plugins/Chronos/controllers/法师基础.yml

法师基础控制器.yml
-> plugins/Chronos/client/法师基础控制器.yml


步骤 2：放入客户端资源


法师基础.bbmodel
-> ArcartX/resource/model/人模/法师基础.bbmodel

法师基础.animation.json
-> ArcartX/resource/model/人模/法师基础.animation.json


步骤 3：重载配置和资源


/ac reload
/arcartx reload true


重要提醒：

● 不要直接覆盖自己服务器原有的 默认.yml
● 不要直接覆盖自己服务器原有的 默认控制器.yml
● 不要直接覆盖 setting.yml 和 keybinding.yml
● 本资源只需要新增两份法师配置和两份客户端模型资源

如果服务器已经存在同名“法师基础”控制器，请先备份再安装。

---

六、如何启用控制器

方法一：使用指令测试


/ac set 法师基础 <玩家名>


示例：


/ac set 法师基础 Steve


方法二：通过主手物品自动切换

如果服务器的 setting.yml 已经开启：


switch_by_main_hand:
enable: true
path: "controller"


则给物品写入：


controller: 法师基础


玩家手持该物品时会切换到法师基础控制器；切换到其它物品时由服务器自己的默认控制器规则处理。

---

七、常用修改位置

想修改每段动作持续时间

编辑对应状态的：


duration: "749"


单位为毫秒。修改后还应同步检查 buffer_at、windows 和 execute.at 是否超过新的动作时间。

想让下一段更早播放

减小：


buffer_at: 749


它表示系统记住下一段输入后，要等到当前动作的哪个时间点才切换。

想限制玩家只能在动作后半段接下一段

修改：


windows:
derive:
start: 300
end: 749


这样玩家在前 300ms 点击下一段不会被当前动作接收。

想让某一段向前移动

在对应状态中加入：


execute:
向前位移:
at: 100
expression: "self.dash(0.45, 0.0)"


at 是动作开始后的毫秒数；0.45 是水平力度；第二个参数 0.0 表示不增加向上速度。

想增加测试消息


execute:
发送提示:
at: 0
expression: 'self.sendMessage("动作已触发")'

---

八、当前功能边界

已经完成

● 模型与七段动作整合
● 客户端基础状态映射
● 七段左键连招
● 输入缓冲与固定衔接时间
● 第一段消息与前移脚本示例
● Chronos 2.0.1 加载与重载检查
● 配置、状态和动画引用静态校验

尚未包含

● 正式伤害与命中范围
● 法力、体力或其它资源消耗
● 技能冷却
● 粒子、音效和镜头特效
● 格挡、闪避和蓄力玩法
● 完整多人环境与手感验收

当前状态：配置已成功加载，静态结构与引用已通过检查；具体连招手感、位移距离和多人表现仍建议在自己的测试服中实测调整。

---

九、使用建议

这套配置更适合作为以下用途的起点：

● 学习 Chronos 2.x 客户端/服务端控制器如何对应
● 制作自己的普攻连段
● 测试 duration、derive 和 buffer_at 的区别
● 学习通过 execute 接入消息、移动、伤害或特效
● 在原版基础人模上快速验证新动作

建议每次只修改一个参数并进服测试，不要一次同时调整动画速度、服务端时长、输入窗口和位移，否则出现问题时很难判断是哪一项造成的。

---