如何安装

安装须知

Chronos 是服务端插件，客户端玩家仍须安装 ArcartX Mod。

Chronos 的一个动作横跨两套状态机，安装前先记住它们的分工：

状态机	提供者	职责
服务端控制器	Chronos 插件	识别输入、判断条件、管理冷却、决定进入哪个状态（无特殊状态时仍由客户端/原版接管）
客户端状态机	ArcartX 本体	播放模型动画、原版动作、视觉效果

前置要求

要求	说明
ArcartX	硬前置
Java	17 或更高版本；需同时满足 ArcartX 与服务端自身的要求
Minecraft 服务端	Spigot / Paper 及其分支
授权码	在 ArcartX 社区购买后获取
PlaceholderAPI	可选。PAPI 触发器需要它；未安装或未启用时会跳过 PAPI 条件，仍判断其余条件，详见职业配置

安装流程

获取插件文件

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

下载发布版 Chronos JAR
查询你的授权码 ID 和 KEY

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

上传并生成配置

把 Chronos_Plugin-<版本号>.jar 放进服务端 plugins 目录
重启服务器
插件自动生成 plugins/Chronos/ 配置文件夹

如果没有出现 Chronos 文件夹，依次检查：插件是否真的上传成功、控制台有没有报错、ArcartX 本体插件是否已正确安装。

填写授权码

打开 plugins/Chronos/license.yml，填入你的授权信息：

licenseId: 666          # 替换为你的授权码 ID
licenseKey: KEY-xXxxXXx    # 替换为你的授权码 KEY

重启验证

在服务端控制台执行 stop，正常停服后再启动服务器，并观察控制台。业务初始化会输出下面这段 Banner 和「加载完成」日志：

[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 | 信息: 加载完成

验证安装

看控制台加载了什么

加载过程中，控制台会打印按键分类、按键数量和注册的控制器。下面是已配置按键和控制器时的日志示例。全新安装的 common.yml 使用 EXTERNAL 模式，允许的控制器列表和默认控制器均为空；添加控制器文件后，还需将其加入职业的 controllers.allowed，并按需设置 controllers.default，或通过 API 分配：

[11:54:02 INFO]: ♦ ArcartX-Chronos | INFO: 开始加载
[11:54:02 INFO]: ♦ ArcartX-Chronos | INFO: 按键分类: 克洛诺斯
[11:54:02 INFO]: ♦ ArcartX-Chronos | INFO: 加载2个按键配置
[11:54:02 INFO]: ♦ ArcartX-Chronos | INFO: 注册控制器示例控制器
[11:54:02 INFO]: ♦ ArcartX-Chronos | INFO: 加载1个控制器配置
[11:54:02 INFO]: ♦ ArcartX-Chronos | INFO: 注册动作客户端按键-> 战技1
[11:54:02 INFO]: ♦ ArcartX-Chronos | INFO: 注册动作客户端按键-> 战技2
[11:54:02 INFO]: ♦ ArcartX-Chronos | INFO: 注册动作控制器-> 示例控制器

常见问题

插件没加载

常见原因：ArcartX 本体未安装、服务端版本不支持、授权码无效或过期。先看控制台有没有对应报错。

授权验证失败

核对 licenseId 与 licenseKey 是否填对
确认服务器能正常联网
仍不行则联系社区管理员确认授权状态
服务器时钟非标准时间

如何安装

On this page