CannonRTP 命令与权限

CannonRTP 在 cannonrtp 命名空间下注册其命令。

• 根命令：/cannonrtp
• 别名：/crtp、/wc

/wc 是大多数管理员会使用的简短别名，但所有子命令底层使用的权限节点都是 cannonrtp.admin。

管理员命令

命令	发送者	描述
/cannonrtp	任意	显示帮助标题，后接发送者可使用的所有已注册子命令
/wc help	任意	与 /cannonrtp 相同 —— 打印帮助列表
/wc create <id>	玩家	创建一份全新的炮台配置，并在你当前位置放置第一个实例
/wc create <id> <display_name>	玩家	同上，但设置自定义显示名称（下划线会被替换为空格）
/wc place <id>	玩家	在你当前位置追加放置一个现有炮台的实例
/wc remove <id>	玩家	移除你当前世界中距离最近的 <id> 放置点（配置文件保留）
/wc delete <id>	任意	直接删除炮台的配置文件
/wc target <id> <world>	玩家	修改该炮台的目标落点世界
/wc center <id>	玩家	将该炮台的搜索中心设为你当前位置
/wc list	任意	列出所有放置点的显示名称、状态、队列大小以及最后的状态详情
/wc status	任意	与 /wc list 输出相同
/wc probe	玩家	测试你当前位置是否能通过所有已启用的保护检查
/wc reload	任意	重新加载全局配置、所有单炮台配置、任务以及保护适配器
/wc setup	玩家	打开 Nightbreak 风格的内容浏览器菜单（列出已安装和可下载的炮台内容包）
/wc downloadall	任意	从 Nightbreak 下载所有可用的 CannonRTP 内容包
/wc updatecontent	任意	下载已过期的 CannonRTP 内容包的更新（别名：/wc updateall）

CannonRTP 不附带独立的首次 /wc initialize 菜单 —— 它没有预设模式。安装后管理员首次加入时，Nightbreak 会在聊天中弹出警告，提示运行 /wc setup。

所有管理员命令都需要 cannonrtp.admin 权限。

有关 /wc setup、/wc downloadall 和 /wc updatecontent 实际管理的内容详情，请参阅内容包页面。

create、place、remove 和 delete 的区别

一份炮台配置（plugins/CannonRTP/cannons/<id>.yml）可以驱动世界中的多个放置点。create 创建配置并放置第一个实例。place 为现有配置追加一个放置点。remove 删除一个放置点（你所在世界中距离最近的那个），但保留配置。delete 直接删除配置文件，从而删除所有放置点。

玩家交互

没有供玩家激活炮台的命令。玩家通过走入炮台的触发半径（triggerRadius，默认 1.75 格）来使用 CannonRTP。

权限

在 plugin.yml 中仅注册了两个权限节点：

权限	默认	描述
cannonrtp.admin	op	所有管理员子命令所需
cannonrtp.use	true	玩家触发任何炮台前所需

cannonrtp.use 的运作方式

如果玩家没有 cannonrtp.use 权限，炮台会静默忽略该玩家。基础权限检查不会发送任何拒绝消息 —— 他们只是会直接穿过炮台区域而不会被发射。

单炮台权限门控

每个炮台配置还可以定义一个 requiredPermission 字段。

• 如果 requiredPermission 为空（默认），炮台仅检查 cannonrtp.use。
• 如果设置了 requiredPermission，且玩家有 cannonrtp.use 但缺少该单炮台节点，CannonRTP 会发送已配置的 noPermission 消息，其中包含炮台的显示名称。该消息对每个玩家在每个炮台上限速为每 3 秒一次。

Tab 补全

接受炮台 <id> 参数的命令会从已知的炮台配置 id 列表中进行 Tab 补全。接受 <world> 参数的命令会从当前已加载的世界名称列表中进行 Tab 补全。