如何安装

逆境是人类获得知识的最高学府，难题则是取得智慧之门。

安装须知

Chronos 的安装特点： 与 ArcartX 的混合型架构不同，Chronos 只需要在服务端安装插件即可，无需客户端额外配置。

前后端状态机概念

在开始安装之前，请先理解以下概念：

状态机类型	提供者	职责
服务端状态机	Chronos	处理输入、条件判断、状态转换逻辑
客户端状态机	ArcartX	播放动画、处理视觉效果、原版状态播放

你需要结合前后端状态机，才能实现完整的动作系统功能。

前置要求

在安装 Chronos 之前，请确保满足以下条件：

要求	说明
ArcartX	必须前置，需要先安装 ArcartX 插件
Minecraft 服务端	支持 Spigot/Paper 及其分支
授权码	在 ArcartX 社区购买后获取

安装流程

获取插件文件

购买插件后，在 许可证 页面可以：

下载 ArcartX_Chronos_Plugin-<版本号>.jar 文件
查询您的授权码 ID 和 KEY

请通过官方渠道下载插件，避免使用来源不明的文件。

上传并生成配置

将 ArcartX_Chronos_Plugin-<版本号>.jar 放入服务端的 plugins 目录
重启服务器
插件会自动生成 ArcartX_Chronos 配置文件夹

如果 plugins 目录内没有出现 ArcartX_Chronos 文件夹，请检查：

插件文件是否正确上传
服务端控制台是否有报错信息
ArcartX 插件是否已正确安装

配置授权码

打开 plugins/ArcartX_Chronos/license.yml 文件：

# 填写您的授权信息
licenseId: 114514          # 替换为您的授权码ID
licenseKey: KEY-xXxxXXx    # 替换为您的授权码KEY

编辑器推荐： 使用 Visual Studio Code、Notepad++ 或其他支持 YAML 语法高亮的编辑器。

重启验证

在服务端后台输入 stop 命令重启服务器，观察控制台输出：

[03:13:26 INFO]:    ___           _ _____ _        _   _     _
[03:13:26 INFO]:   / __\_   _    / |___  /_\  _ __| |_(_)___| |_
[03:13:26 INFO]:  /__\// | | |   | |  / //_\\| '__| __| / __| __|
[03:13:26 INFO]: / \/  \ |_| |_  | | / /  _  \ |  | |_| \__ \ |_
[03:13:26 INFO]: \_____/\__, (_) |_|/_/\_/ \_/_|   \__|_|___/\__|
[03:13:26 INFO]:        |___/
[03:13:26 INFO]: ♦ ArcartX-Chronos | 信息: 欢迎使用 ArcartX-Chronos
[03:13:26 INFO]: ♦ ArcartX-Chronos | 信息: 开始加载
[03:13:26 INFO]: ♦ ArcartX-Chronos | 信息: 加载完成

如果看到 加载完成 的提示，说明安装成功！

验证安装

安装成功后，你可以通过以下方式验证：

查看控制台输出

成功加载时，控制台会显示：

加载的按键配置数量
注册的控制器数量
注册的客户端按键

[03:13:26 INFO]: ♦ ArcartX-Chronos | 信息: 按键分类: 克洛诺斯
[03:13:26 INFO]: ♦ ArcartX-Chronos | 信息: 加载1个按键配置
[03:13:26 INFO]: ♦ ArcartX-Chronos | 信息: 注册控制器idle
[03:13:26 INFO]: ♦ ArcartX-Chronos | 信息: 加载1个控制器配置
[03:13:26 INFO]: ♦ ArcartX-Chronos | 信息: 注册动作控制器-> idle