跳到主要内容

CannonRTP 内容包

CannonRTP 将官方的炮台模型与配置打包当作由 Nightbreak 管理的内容包处理,而非纯粹的手动导入。每个内容包都包含炮台的 YAML 配置以及驱动其 3D 炮台模型所需的所有 FreeMinecraftModels 资源。

主要命令

命令用途
/wc setup打开 Nightbreak 内容浏览器菜单(列出已安装和可下载的炮台内容包)
/wc downloadall批量下载所有可用的 CannonRTP 内容包(来自 Nightbreak)
/wc updatecontent批量更新已过期的 CannonRTP 内容包(别名:/wc updateall
/wc reload手动导入后重新加载 CannonRTP
/nightbreaklogin <token>共享的 Nightbreak 令牌注册 —— 高级内容包必需

所有这些命令都需要 cannonrtp.admin 权限。

内置内容包

CannonRTP 默认附带了两个 Nightbreak 内容包的定义:

内容包 id显示名称来源
cannonrtpFree CannonRTP免费的 Nightbreak 下载
cannonrtp_premiumPremium CannonRTP需要 Nightbreak 高级支持者访问权限

每个定义都位于 plugins/CannonRTP/content_packages/<id>.yml 中,并存储:

  • version —— 本地已安装版本(被 /wc updatecontent 用于判断哪些已过期)
  • namedescription —— 在 /wc setup 菜单中显示
  • downloadLink —— 批量下载流程使用的 Nightbreak 页面
  • folderNamecontentFilePrefixes —— CannonRTP 视为该内容包一部分的内部文件
  • nightbreakSlug —— 下载/更新接口使用的 Nightbreak 项目 slug

通常你不应手动编辑这些文件 —— 它们会被插件重新生成和重写。

内容包状态

/wc setup 菜单中,每个内容包会显示为以下状态之一:

  • installed —— 该内容包的炮台文件存在于 plugins/CannonRTP/cannons/ 中且 isEnabledtrue
  • downloaded but disabled —— 该内容包的炮台文件位于 plugins/CannonRTP/cannons_disabled/
  • outdated —— Nightbreak 上有新版本可用
  • not downloaded —— 本地尚无任何文件

在菜单中点击某个内容包会进行下载、安装、启用或禁用操作。禁用某个内容包会将其炮台配置从 cannons/ 移动到 cannons_disabled/,但不会删除它们,因此重新启用时会还原相同的文件。

炮台文件夹布局

文件夹用途
plugins/CannonRTP/cannons/激活的炮台配置。此处的所有文件都会在启动或 /wc reload 时加载。
plugins/CannonRTP/cannons_disabled/当前已关闭的打包炮台配置。此处的文件会被加载器忽略,但会保留以便之后重新启用。
plugins/CannonRTP/imports/手动内容包导入的投放文件夹。CannonRTP 会在启动时扫描该文件夹,并将其内容合并到各内容包文件夹中。

手动导入回退方案

你仍然可以手动安装内容包:

  1. 从 Nightbreak 下载内容包的 zip 文件。
  2. 将该 zip 文件(保持完整)放入 plugins/CannonRTP/imports/
  3. 运行 /wc reload

CannonRTP 会识别该内容包,将文件移动到合适的文件夹中,并重新加载炮台配置。手动导入仍然受支持,但不再是推荐的工作流程 —— /wc setup/wc downloadall 会自动处理这些工作。

高级访问

高级内容包(例如 cannonrtp_premium)需要绑定 Nightbreak 账户。使用 /nightbreaklogin <token> 一次性输入从 Nightbreak 账户页面获取的令牌,之后 /wc downloadall/wc setup 菜单就能获取高级内容。

如果你未登录,高级内容包仍会出现在设置菜单中,但无法下载。