CannonRTP 內容包
CannonRTP 將官方的大砲模型與設定組合視為由 Nightbreak 管理的內容包，而非單純的手動匯入。每個內容包都包含大砲 YAML 設定，以及驅動其 3D 大砲模型的所有 FreeMinecraftModels 資源。
主要指令
| 指令 | 用途 |
|---|---|
/wc setup | 開啟 Nightbreak 內容瀏覽器選單（列出已安裝與可下載的大砲內容包） |
/wc downloadall | 從 Nightbreak 批次下載所有可用的 CannonRTP 內容包 |
/wc updatecontent | 批次更新已過時的 CannonRTP 內容包（別名：/wc updateall） |
/wc reload | 在手動匯入後重新載入 CannonRTP |
/nightbreaklogin <token> | 共用的 Nightbreak Token 註冊 —— 高級內容包所需 |
以上指令皆需要 cannonrtp.admin。
內建內容包
CannonRTP 預設附帶兩個 Nightbreak 組合的內容包定義：
| 內容包 id | 顯示名稱 | 來源 |
|---|---|---|
cannonrtp | Free CannonRTP | 免費 Nightbreak 下載 |
cannonrtp_premium | Premium CannonRTP | 需要 Nightbreak 高級贊助者權限 |
每份定義位於 plugins/CannonRTP/content_packages/<id>.yml，並儲存：
version—— 本機已安裝版本（/wc updatecontent用以判斷何者已過時）name與description—— 顯示於/wc setup選單中downloadLink—— 批次下載流程所使用的 Nightbreak 頁面folderName與contentFilePrefixes—— CannonRTP 視為屬於該內容包的內部檔案nightbreakSlug—— 下載／更新端點所使用的 Nightbreak 專案 slug
通常你不應手動編輯這些檔案 —— 它們會由插件重新產生並覆寫。
內容包狀態
在 /wc setup 選單中，每個內容包會顯示為以下狀態之一：
- installed —— 該內容包的大砲檔案存在於
plugins/CannonRTP/cannons/，且isEnabled為true - 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 會在啟動時掃描此處，並將其內容合併至內容包資料夾中。 |
手動匯入備援
你仍可手動安裝內容包：
- 從 Nightbreak 下載內容包的 zip 檔。
- 將該 zip（保持完整）放入
plugins/CannonRTP/imports/。 - 執行
/wc reload。
CannonRTP 會接收該內容包，將檔案移至適當資料夾中，並重新載入大砲設定。手動匯入仍受支援，但已不再是建議的工作流程 —— /wc setup 與 /wc downloadall 會自動處理。
高級權限
高級內容包（如 cannonrtp_premium）需要連結 Nightbreak 帳號。使用你 Nightbreak 帳號頁面上的 Token 執行一次 /nightbreaklogin <token>，之後 /wc downloadall 或 /wc setup 選單即可取得高級內容。
若未登入，高級內容包仍會顯示於設定選單中，但無法下載。