Nightbreak 設定和內容管理
本頁面是 Nightbreak 管理外掛程式的共享設定指南。
它直接適用於：
- EliteMobs
- BetterStructures
- FreeMinecraftModels
- EternalTD
這些外掛程式現在共享相同的整體生命週期：
- 安裝外掛程式和所有必需的相依性。
- 啟動伺服器一次，以便產生檔案和選單。
- 如果外掛程式有首次設定命令，請執行它。
- 使用
/nightbreaklogin <token>連結 Nightbreak 權杖。 - 使用外掛程式設定選單瀏覽、安裝、啟用、停用和更新內容。
- 當您需要更快的初始啟動時，使用外掛程式的批次下載/更新命令。
MagmaCore 實際共享的內容
MagmaCore 是 Nightbreak 管理流程背後的共享層。它提供：
- 共享命令
/nightbreaklogin <token> plugins/MagmaCore/nightbreak.yml中的共享權杖儲存- 外掛程式設定選單使用的共享設定選單原語
- 共享的 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 帳戶頁面，取得您的伺服器權杖，然後執行：
/nightbreaklogin <token>
權杖透過 MagmaCore 共享，因此一個已連結的權杖可以被該伺服器上所有相容的 MagmaGuy 外掛程式重複使用。
4. 使用設定選單進行日常內容管理
設定選單是以下內容的當前權威來源：
- 套件狀態
- 存取狀態
- 已安裝與已下載的內容
- 需要修復的部分安裝內容
- 過時的內容
- 按類別篩選的內容
如果您有已連結的權杖，設定選單是安裝和更新內容的推薦位置。
5. 需要速度時使用批次安裝/更新
當您想快速架設伺服器時使用 downloadall 命令，當您想重新整理所有過時內容時使用 updatecontent 命令。
共享批次下載器僅嘗試以下 Nightbreak 管理的套件：
- 具有 Nightbreak slug
- 對已連結的權杖可存取
- 尚未下載或標記為過時
大多數當前外掛程式在批次下載成功後會自動重新載入。
共享概念
已下載與已安裝
一個套件可以在本機存在但未啟用。確切含義因外掛程式而略有不同，但設定選單狀態比 imports 中是否存在 zip 檔案更重要。
批次下載也會進入與手動匯入使用的相同外掛程式 imports 資料夾，在外掛程式特定的匯入/重載步驟完成之前。
存取感知內容
設定選單現在可以區分以下內容：
- 對您的權杖可用
- 需要購買或解鎖
- 已安裝
- 僅部分安裝
- 已下載但已停用
- 已過時
手動匯入仍然有效
Nightbreak 管理的外掛程式仍然支援手動匯入工作流程。手動匯入現在是備用路徑，而非預設路徑。請參閱手動匯入與遊戲內管理。
不使用此流程的外掛程式
並非此 Wiki 中的每個外掛程式都使用 Nightbreak 管理的可下載內容。
- BetterFood 不使用 Nightbreak 套件管理
- ResurrectionChest 不使用 Nightbreak 套件管理
- WorldCannon 不使用 Nightbreak 套件管理
- ResourcePackManager 管理資源包，而非 Nightbreak DLC 套件