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 Token 註冊 —— 高級內容包所需 |
/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/ 而不刪除,因此再次啟用會還原相同檔案。每當 cannons/ 中缺少內建的 cannonrtp_free_cannon.yml 與 cannonrtp_premium_cannon.yml 時,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 帳號。使用你 Nightbreak 帳號頁面上的 Token 執行一次 /nightbreaklogin <token>,之後 /wc downloadall 或 /wc setup 選單即可取得高級內容。
若未登入,高級內容包仍會顯示於設定選單中,但無法下載。