ArcartXAPI:API入口
ArcartX API入口类
ArcartXAPI
ArcartXAPI是ArcartX所有服务端API的统一入口,位于priv.seventeen.artist.arcartx.api包下。- 它是一个单例对象,所有方法均为静态方法,可直接调用。
getUIRegistry()
- 获取UI注册管理器
- 参数:无
- 返回值:
ArcartXUIRegistry - 调用示例
getChatCardRegistry()
- 获取聊天卡片注册管理器
- 参数:无
- 返回值:
ArcartXChatCardRegistry - 调用示例
getKeyBindRegistry()
- 获取按键绑定注册管理器
- 参数:无
- 返回值:
ArcartXKeyBindRegistry - 调用示例
getPlayerHostRegistry()
获取玩家宿主配置管理器 PlayerHostProfiles,类型位于 priv.seventeen.artist.arcartx.core.playerhost。配置从 plugins/ArcartX/player_host/*.yml 读取,每个文件使用 root 配置段。配置 ID 与 setPlayerHost 的 profileId 对应,model 必须与宿主模型一致。
- 参数:无
- 返回值:PlayerHostProfiles
- 方法:
snapshot()— 返回不可变PlayerHostRegistrySnapshot,可读取 getRevision() / getProfiles()profile(id)— 读取单个配置;不存在时为 nullregister(id, patch)— 校验后新增或替换配置;非法输入抛出 IllegalArgumentException,原注册表不变unregister(id)— 移除配置reload()— 从文件重载;失败保留原注册表syncPlayers()— 将当前注册表及玩家外观同步到在线客户端
- 调用示例
注册表只在内容改变时增加版本号。register / unregister / reload 不自行广播;多次修改结束后调用一次 syncPlayers。ArcartX 的配置重载流程会安排同步。运行时注册不写回 YAML,后续文件重载会以文件内容替换注册表。移除正在使用的配置不会修改玩家记录;请先为玩家选择其他配置。
配置是模型 axmeta 的稀疏覆盖:缺省字段继承,列表整体替换,映射按键合并,空映射不清空继承项。运行时 register 的 Map 可用 null 删除字段,普通 Bukkit YAML 不能保留此删除标记。profile ID、槽 ID 使用 [a-z][a-z0-9_.-]{0,63},显示名称可使用中文。
getEntityManager()
- 获取实体管理器
- 参数:无
- 返回值:
ArcartXEntityManager - 调用示例
getSoundPlayer()
- 获取音效播放器
- 参数:无
- 返回值:
ArcartXSoundPlayer - 调用示例
getNetworkSender()
- 获取网络发送器
- 参数:无
- 返回值:
ArcartXNetworkSender - 调用示例
getAreaManager()
- 获取区域管理器
- 参数:无
- 返回值:
ArcartXAreaManager - 调用示例
getEffectManager()
- 获取特效管理器
- 参数:无
- 返回值:
ArcartXEffectManager - 调用示例
getInteractionProxyManager()
- 获取交互代理(命中盒代理)管理器,用于创建、查询和操作实体的交互代理
- 参数:无
- 返回值:
InteractionProxyManager - 调用示例
