BetterStructures 設定
BetterStructures 仍然支援手動匯入，但目前推薦的工作流程是以 Nightbreak 為優先且在遊戲內操作。
要求
- WorldEdit 或相容 FAWE 的結構圖支援
- 當前建構線所需的 Java 21 執行環境
推薦工作流程
- 安裝 BetterStructures 和 WorldEdit，然後啟動伺服器一次。
- 執行
/bs initialize。 - 使用
/nightbreaklogin <token>連結 Nightbreak 權杖。 - 開啟
/bs setup瀏覽結構套件和模組套件。 - 使用
/bs downloadall快速引導（它會抓取待處理的外掛更新與所有內容）。 - 當有套件更新可用時使用
/bs updatecontent。
首次設定選單
/bs initialize 會開啟一個小型引導選單。在選擇其中一個選項之前，每位持有 betterstructures.* 的玩家都會在加入伺服器十秒後收到一則提醒訊息。這三個選項都會透過在 config.yml 中寫入 setupDone: true 來將設定標記為已完成。
| 選項 | 作用 |
|---|---|
| Recommended Setup（推薦設定） | 標記設定完成，並列出三步驟流程：從 nightbreak.io/account 取得權杖、使用 /nightbreaklogin <token> 連結它，然後開啟 /bs setup。 |
| Manual Setup（手動設定） | 標記設定完成，並把內容管理交由你自行處理，同時指向 /bs setup 與 imports 資料夾。 |
| Use Current Content（使用現有內容） | 關閉提示並保留目前內容。如果 schematic 登錄清單非空，就執行重新載入；否則會回報沒有已安裝的內容，並指向 /bs setup。這項檢查不計算模組。 |
如果 WorldEdit 和 FastAsyncWorldEdit 都沒有安裝，第三個欄位會被替換成一則警告，要求你在繼續之前先安裝其中一個。
設定選單
/bs setup 會開啟一個分頁選單，提供 Structure Packs（結構套件）和 Module Packs（模組套件）兩個篩選器。每個套件都會顯示已安裝、已下載但未啟用、過時或需要 Nightbreak 存取權限等狀態。點擊時的操作取決於狀態：下載、安裝、更新、解除安裝或顯示存取資訊。
除了套件之外，此選單也會顯示內建於 BetterStructures 中的共享 MagmaCore 控制項：
- Plugin Update（外掛更新）- 顯示是否有更新的 BetterStructures 版本可用，並讓你下載它。重新啟動後即會套用，除非你執行
/bs applypluginupdate，或將config.yml中的nightbreak.applyPluginUpdatesWithoutRestart設為when-empty或immediately。此檢查會在啟動時自動執行，並大約每小時重新整理一次，因此剛啟動的伺服器可能會短暫顯示「Plugin Update Pending」。 - Recommended Plugins（推薦外掛）- 開啟搭檔外掛推薦檢視（與
/bs recommendedplugins相同）。當清單上的所有推薦都已安裝時，圖示會變成綠色。 - Download All Content（下載所有內容）- 附加在套件清單之後的批次項目，等同於
/bs downloadall。 - Automatic Updates（自動更新）- 控制 BetterStructures 是否在啟動時自動下載外掛與內容更新。此功能預設為關閉，對應
config.yml中的nightbreak.autoDownloadPluginUpdates。自動下載的內容會暫存至下次重新啟動時套用，不會觸發即時重新載入。已下載的外掛更新也透過重新啟動套用，除非nightbreak.applyPluginUpdatesWithoutRestart設為when-empty或immediately（請參閱設定檔）。 - Installation tips（安裝提示）- 資訊按鈕，會把設定指南、帳號權杖頁面、支援 Discord 以及可點擊的設定指令輸出到聊天欄。
在內容重新載入執行期間，/bs setup 會被拒絕開啟，因為此選單讀取的正是重新載入工作程序正在重建的登錄資料。請等待重新載入回報成功後再開啟它。
選單不檢查檔案完整性。只要路徑存在且版本相符，損壞或被部分刪除的套件仍可能顯示為最新。使用 /bs forcereinstallcontent <package|all> 修復；若整個套件資料夾都已遺失，請直接指定 slug。解除安裝會保留磁碟上的檔案。它會把套件的 isEnabled 設為 false 並重新載入，而重新載入會略過該套件資料夾中的所有 schematic 或模組，包括子資料夾。
手動匯入備選方案
手動匯入仍然透過以下方式運作：
plugins/BetterStructures/imports
保持套件的 zip 檔案完整，然後在需要時執行 /bs reload。/bs reload 會在重新載入的過程中匯入該資料夾內的所有內容，因此你不需要重新啟動就能讀取到剛丟進去的套件。
請注意，把檔案留在 imports 中會拖慢啟動速度：當該資料夾不為空時，BetterStructures 會等待其 softdepend 中列出的外掛完成初始化後才啟動，因為把內容匯入到另一個外掛的資料夾意味著該外掛必須重新載入。一旦該資料夾再次清空，BetterStructures 就會直接初始化而不再等待。
參見共享指南：手動匯入 vs 遊戲內管理。