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 | 显示名称 | 来源 |
|---|---|---|
cannonrtp | Free CannonRTP | 免费的 Nightbreak 下载 |
cannonrtp_premium | Premium 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 会在启动时扫描该文件夹,并将其内容合并到各内容包文件夹中。 |
手动导入回退方案
你仍然可以手动安装内容包:
- 从 Nightbreak 下载内容包的 zip 文件。
- 将该 zip 文件(保持完整)放入
plugins/CannonRTP/imports/。 - 运行
/wc reload。
CannonRTP 会识别该内容包,将文件移动到合适的文件夹中,并重新加载炮台配置。手动导入仍然受支持,但不再是推荐的工作流程 —— /wc setup 和 /wc downloadall 会自动处理这些工作。
高级访问
高级内容包(例如 cannonrtp_premium)需要绑定 Nightbreak 账户。使用 /nightbreaklogin <token> 一次性输入从 Nightbreak 账户页面获取的令牌,之后 /wc downloadall 或 /wc setup 菜单就能获取高级内容。
如果你未登录,高级内容包仍会出现在设置菜单中,但无法下载。