跳至主要內容

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顯示名稱來源
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/ 而不刪除,因此再次啟用會還原相同檔案。每當 cannons/ 中缺少內建的 cannonrtp_free_cannon.yml 與 cannonrtp_premium_cannon.yml 時,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 帳號。使用你 Nightbreak 帳號頁面上的 Token 執行一次 /nightbreaklogin <token>,之後 /wc downloadall 或 /wc setup 選單即可取得高級內容。

若未登入,高級內容包仍會顯示於設定選單中,但無法下載。