指令

人是靠思想站立起来的。

指令概览

Chronos 提供了简洁的指令系统来管理玩家的动作控制器。

指令前缀

可以使用以下任意前缀：

/arcartx_chronos - 完整前缀
/ac - 简写前缀（推荐）

指令列表

指令	作用	权限
`/ac set <控制器ID> <玩家>`	为玩家设置控制器	OP
`/ac remove <玩家>`	移除玩家的控制器	OP
`/ac reload`	重载所有配置文件	OP

在后台输入 /ac 可以查看指令帮助：

[18:44:55 INFO]: ♦ ArcartX-Chronos | 信息: 指令列表
[18:44:55 INFO]: ♦ ArcartX-Chronos | 信息:  - /arcartx_chronos set - 设置玩家控制器
[18:44:55 INFO]: ♦ ArcartX-Chronos | 信息:  - /arcartx_chronos remove - 移除玩家控制器
[18:44:55 INFO]: ♦ ArcartX-Chronos | 信息:  - /arcartx_chronos reload - 重载

详细用法

set - 设置控制器

为指定玩家设置动作控制器。

语法：

/ac set <控制器ID> <玩家名称>

参数说明：

参数	说明
`控制器ID`	`controllers` 文件夹中的 yml 文件名（不含扩展名）
`玩家名称`	在线玩家的游戏名

示例：

# 为玩家 Steve 设置剑士控制器
/ac set sword Steve

# 为玩家 Alex 设置弓箭手控制器
/ac set bow Alex

控制器ID 就是文件名！ 如果你的配置文件是 controllers/sword.yml，那么控制器ID 就是 sword。

remove - 移除控制器

移除指定玩家的当前控制器。

语法：

/ac remove <玩家名称>

示例：

# 移除玩家 Steve 的控制器
/ac remove Steve

移除控制器后，玩家将无法使用 Chronos 的动作系统，直到重新设置控制器。

reload - 重载配置

重新加载所有配置文件，无需重启服务器。

语法：

/ac reload

重载后控制台输出示例：

[18:20:32 INFO]: ♦ ArcartX-Chronos | 信息: 加载1个控制器配置
[18:20:32 INFO]: ♦ ArcartX-Chronos | 信息: 注册动作客户端按键-> 战技1
[18:20:32 INFO]: ♦ ArcartX-Chronos | 信息: 注册动作客户端按键-> 战技2
[18:20:32 INFO]: ♦ ArcartX-Chronos | 信息: 注册动作控制器-> sword
[18:20:32 INFO]: ♦ ArcartX-Chronos | 信息: 注册动作控制器-> bow

调试技巧： 重载后查看控制台输出，可以确认：

有多少个控制器被加载
注册了哪些按键
各控制器的ID

使用流程

典型的工作流程：

常见问题

问题：找不到控制器ID

确认步骤：

检查文件是否在 controllers 文件夹中
检查文件扩展名是否为 .yml
执行 /ac reload 重载配置
查看控制台输出确认控制器已注册

问题：设置控制器后无效果

可能原因：

客户端未安装 ArcartX Mod
服务端状态名与客户端控制器不匹配
连招链配置有误

通过 API 使用

除了指令，你也可以通过 Java API 来管理控制器：

// 获取 API
ChronosAPI api = ChronosAPI.getInstanceAPI();
 
// 为玩家设置控制器
api.setPlayerController(player, "sword");
 
// 获取玩家当前控制器ID
String controllerId = api.getPlayerControllerId(player);
 
// 移除玩家控制器
api.removePlayerController(player);

详细 API 请参考 API/EVENT。

指令

On this page