跳到主要内容

CannonRTP 内容包

CannonRTP 将官方炮台模型作为 Nightbreak 内容包管理。目前的 Free Cannon 和 Premium Cannon 下载包含 FreeMinecraftModels 模型,以及 content_packages/ 中的内容包版本标记。对应的炮台配置由 CannonRTP 自身在 cannons/ 中生成;下载包不提供放置位置配置。

主要命令​

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

/wc 管理命令需要 cannonrtp.admin。独立的账号命令 /nightbreaklogin <token> 需要 nightbreak.login。

除炮台内容包外,/wc setup 菜单还显示一个插件更新条目(点击即可下载可用更新)、一个推荐插件条目、一个执行 /wc downloadall 的全部下载条目,以及一个写入 config.yml 中 nightbreak.autoDownloadPluginUpdates 的自动更新开关(参见配置)。

内置内容包​

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

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

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

  • isEnabled —— 内容包是否启用;在 /wc setup 菜单中启用或禁用内容包时会写入此项
  • version —— 本地已安装版本(被 /wc updatecontent 用于判断哪些已过期)
  • name 和 description —— 在 /wc setup 菜单中显示
  • downloadLink —— 当内容包没有 nightbreakSlug、需要手动下载时,CannonRTP 指引你前往的 Nightbreak 页面,也是控制台中关于内容包过期警告里的链接
  • folderName 和 contentFilePrefixes —— CannonRTP 视为该内容包一部分的内部文件
  • nightbreakSlug —— 下载/更新接口使用的 Nightbreak 项目 slug

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

内容包状态​

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

  • 已安装 —— 满足下方的下载检查,元数据为 isEnabled: true,且 plugins/CannonRTP/cannons/ 中存在对应的炮台配置
  • 已下载但禁用 —— 模型下载已被识别,但内容包未启用;在菜单中禁用会将其炮台文件移到 plugins/CannonRTP/cannons_disabled/
  • 有更新 —— 内容包已安装,且 Nightbreak 上有新版本可用;如果你关联的账户已不再拥有访问权限,菜单会如实提示,而不是提供更新
  • 需要访问权限 —— 内容包未下载,你已登录,但你的 Nightbreak 账户没有该内容包的访问权限
  • 未下载 —— 缺少大于零的本地版本标记,或找不到模型文件

仅有生成的炮台 YAML 文件不能证明内容包已下载。CannonRTP 要求本地包 version 大于零,并且在 plugins/FreeMinecraftModels/models/ 或 plugins/FreeMinecraftModels/Models/ 下的包目录 folderName 内至少存在一个 .bbmodel 文件。如果模型目录缺失,即使生成的炮台配置仍存在,内容包也会重新显示为可下载。

在菜单中点击某个内容包会进行下载、安装、启用或禁用操作。禁用某个内容包会将其炮台配置从 cannons/ 移动到 cannons_disabled/,但不会删除它们,因此重新启用时会还原相同的文件。每当内置的 cannonrtp_free_cannon.yml 和 cannonrtp_premium_cannon.yml 从 cannons/ 中缺失时,CannonRTP 都会重新创建它们,因此禁用后,重新加载会在那里留下没有放置点的默认副本;重新启用时,保存的文件会被移回并覆盖它们。

炮台文件夹布局​

文件夹用途
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 菜单就能获取高级内容。

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