LogoArcartX Doc

ControllerRegistry:控制器注册器

动作控制器注册API

ControllerRegistry

  • 控制器注册器用于注册和管理动作控制器配置。
  • 通过代码直接访问 ControllerRegistry 单例对象。

新版控制器不再通过配置文件夹加载,只能通过此 API 注册。

register(id, src)

  • 注册一个动作控制器,支持三种数据源
  • 参数
    • id: String — 控制器唯一标识
    • src: YamlConfiguration / String / File — 控制器配置数据源
  • 返回值:无
  • 调用示例
// 从文件注册
ControllerRegistry.INSTANCE.register("控制器ID", new File("文件路径"));
 
// 从YAML字符串注册
ControllerRegistry.INSTANCE.register("控制器ID", yamlString);
 
// 从YamlConfiguration注册
ControllerRegistry.INSTANCE.register("控制器ID", yamlConfig);

unregister(id)

  • 注销一个动作控制器
  • 参数id: String — 控制器唯一标识
  • 返回值:无
  • 调用示例
ControllerRegistry.INSTANCE.unregister("combat");

syncPlayers()

  • 将所有已注册的控制器同步到所有在线玩家的客户端
  • 参数:无
  • 返回值:无
  • 调用示例
ControllerRegistry.INSTANCE.syncPlayers();

注册或修改控制器后,需要调用 syncPlayers() 才能让在线玩家的客户端生效。

On this page