Nightbreak 設定與內容管理
本頁是 Nightbreak 管理型外掛共用的設定指南。
它直接適用於：
- EliteMobs
- BetterStructures
- FreeMinecraftModels
- EternalTD
這些外掛現在共用相同的大致生命週期：
- 安裝外掛與任何必要的硬性依賴。
- 先啟動一次伺服器，讓檔案與選單生成。
- 如果外掛提供首次設定指令，先執行它。
- 用
/nightbreaklogin <token>綁定 Nightbreak token。 - 使用外掛的設定選單瀏覽、安裝、啟用、停用與更新內容。
- 如果想更快完成初始部署，使用外掛的批次下載或更新指令。
MagmaCore 實際共用了什麼
MagmaCore 是 Nightbreak 管理流程背後的共用層。它提供：
- 共用的
/nightbreaklogin <token>指令 - 儲存在
plugins/MagmaCore/nightbreak.yml的共用 token - 供各外掛設定選單使用的共用選單基礎功能
- 共用的 Nightbreak 存取、版本與下載檢查
- 會把檔案下載到對應外掛
imports資料夾的共用批次下載邏輯
像 /em initialize 或 /bs setup 這種外掛專屬指令，仍然是由各外掛自己實作。MagmaCore 提供的是這些指令所依賴的共用系統。
共用的首次設定模式
大多數目前由 Nightbreak 管理的外掛都提供：
| 外掛 | 首次設定指令 | 設定選單 | 批次安裝 | 批次更新 |
|---|---|---|---|---|
| EliteMobs | /em initialize | /em setup | /em downloadall | /em updatecontent |
| BetterStructures | /bs initialize | /bs setup | /bs downloadall | /bs updatecontent |
| FreeMinecraftModels | /fmm initialize | /fmm setup | /fmm downloadall | /fmm updatecontent |
| EternalTD | /etd initialize | /etd setup | /etd downloadall | /etd updatecontent |
initialize 是首次使用時的引導流程。它不會取代外掛專屬的設定選單或內容管理指令。
MagmaCore 也有另一套外掛啟動時的初始化系統，但那和此處記錄的玩家端 initialize 指令不是同一回事。
推薦的伺服器管理員流程
1. 先安裝外掛
把外掛 jar 與任何必要的硬性依賴放進 plugins/，然後先啟動一次伺服器。
2. 執行首次設定流程
如果外掛提供 initialize 指令，先用它。現在的選單設計用來：
- 將首次設定標記為完成
- 引導你前往 Nightbreak 帳號綁定
- 指向目前的設定選單
- 說明何時仍然適合使用手動匯入
首次設定選單本身的行為是共用的，但確切的指令名稱與後續邏輯仍然依外掛而定。
3. 綁定你的 Nightbreak 帳號
前往 Nightbreak 帳號頁面，取得你的伺服器 token，然後執行：
/nightbreaklogin <token>
這個 token 會透過 MagmaCore 共用，因此同一台伺服器上的所有相容 MagmaGuy 外掛都可以重複使用它。
4. 用設定選單進行日常內容管理
設定選單現在是下列資訊的主要真實來源：
- 套件狀態
- 存取狀態
- 已安裝與僅已下載的內容
- 需要修復的部分安裝內容
- 已過期的內容
- 依分類篩選的內容
如果你已綁定 token，建議使用設定選單來安裝與更新內容。
5. 想求快時使用批次安裝或更新
如果你想快速完成伺服器初始部署，就用 downloadall；如果你想把所有已過期內容一次更新，就用 updatecontent。
共用的批次下載器只會嘗試處理符合以下條件的 Nightbreak 管理套件：
- 有 Nightbreak slug
- 綁定的 token 有權限存取
- 尚未下載，或已被標記為過期
目前大多數外掛在批次下載成功後都會自動重新載入。
共用概念
已下載與已安裝的差別
套件可以已存在於本機但尚未啟用。確切含義會因外掛略有不同，但設定選單顯示的狀態比 imports 裡是否有 zip 更重要。
批次下載也會先落在和手動匯入相同的外掛 imports 資料夾中，接著才完成外掛專屬的匯入或重新載入步驟。
具存取感知的內容
設定選單現在可以區分內容是否：
- 你的 token 可存取
- 需要購買或解鎖
- 已安裝
- 僅部分安裝
- 已下載但停用
- 已過期
手動匯入仍然有效
Nightbreak 管理型外掛仍然支援手動匯入流程。現在手動匯入是備援路徑，而不是預設路徑。請參閱 手動匯入與遊戲內管理。
不使用此流程的外掛
不是這個 wiki 裡的所有外掛都使用 Nightbreak 管理的可下載內容。
- BetterFood 不使用 Nightbreak 套件管理
- ResurrectionChest 不使用 Nightbreak 套件管理
- WorldCannon 不使用 Nightbreak 套件管理
- ResourcePackManager 管理的是資源包，而不是 Nightbreak DLC 套件