MegaBlock Survivors 設定
MegaBlock Survivors 的設定流程圍繞 Nightbreak 管理的內容包建構，並可選擇透過 FreeMinecraftModels 支援自訂模型。
需求
- Java
21 - 在
1.21API 線上的 Paper/Spigot 相容伺服器
可選整合：
FreeMinecraftModels用於自訂怪物和武器模型（軟依賴）
MegaBlock Survivors 建立的內容
啟動時，MegaBlock Survivors 會初始化或使用以下路徑：
plugins/MegaBlockSurvivors/config.yml
plugins/MegaBlockSurvivors/content_packages/
plugins/MegaBlockSurvivors/imports/
plugins/MegaBlockSurvivors/worlds/
plugins/MegaBlockSurvivors/leaderboard.yml
plugins/MegaBlockSurvivors/version.txt
設定
config.yml 包含：
| 鍵 | 類型 | 預設值 | 說明 |
|---|---|---|---|
setupDone | boolean | false | 追蹤首次設定引導是否已完成 |
首次設定警告
當 setupDone 為 false 時，外掛程式會在擁有 megablocksurvivors.* 權限的玩家加入時向其顯示首次設定警告。這會引導他們完成初始內容下載。
建議的首次設定流程
- 安裝 MegaBlock Survivors 並啟動伺服器一次。
- 使用
/nightbreaklogin <token>連結您的 Nightbreak 帳戶。 - 執行
/mbs downloadall以下載所有可存取的 MegaBlock Survivors 內容包到plugins/MegaBlockSurvivors/imports。 - 任何時候執行
/mbs setup以瀏覽、啟用、停用或更新個別套件。 - 下載內容後執行
/mbs reload以載入新的地圖和資源。
/nightbreaklogin <token> 是共享的 Nightbreak/MagmaCore 帳戶流程的一部分，不是 MegaBlock Survivors 的 plugin.yml 中宣告的指令。
內容包
內容包透過 content_packages/ 資料夾中的 YAML 檔案設定。每個套件可以定義：
| 欄位 | 類型 | 說明 |
|---|---|---|
isEnabled | boolean | 套件是否啟用 |
name | string | 套件的顯示名稱 |
description | string list | 說明行 |
downloadLink | string | 手動下載 URL |
version | integer | 套件版本號 |
nightbreakSlug | string | 用於自動下載的 Nightbreak 內容 slug |
schematicFiles | string list | 套件中包含的建築圖檔案 |
worldFolders | string list | 包含的世界資料夾 |
worldContainerFolders | string list | 包含的世界容器資料夾 |
modelFolders | string list | FreeMinecraftModels 的模型資料夾 |
markerFileName | string | 用於偵測套件是否已安裝的標記檔案 |
category | enum | FREE、PREMIUM 或 RESOURCES |
toggleable | boolean | 套件是否可以切換開/關 |
版本更新通知
當外掛程式偵測到版本更新（透過與 version.txt 比較）時，會通知主控台和所有線上 OP 版本變更。