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(使用現有內容) | 關閉提示並保留已安裝的內容,然後執行一次重新載入。如果沒有安裝任何內容,它會告知你並指向 /bs setup。 |
如果 WorldEdit 和 FastAsyncWorldEdit 都沒有安裝,第三個欄位會被替換成一則警告,要求你在繼續之前先安裝其中一個。
設定選單
/bs setup 會開啟一個分頁選單,其中套件被分為兩個篩選器:Structure Packs(結構套件)和 Module Packs(模組套件)。每個套件都會顯示它是已安裝、已下載但未啟用、過時,還是需要 Nightbreak 存取權限;點擊它即可安裝/更新。
除了套件之外,此選單也會顯示內建於 BetterStructures 中的共享 MagmaCore 控制項:
- Plugin Update(外掛更新)- 顯示是否有更新的 BetterStructures 版本可用,並讓你下載它(需重新啟動才會套用)。此檢查會在啟動時自動執行,並大約每小時重新整理一次,因此剛啟動的伺服器可能會短暫顯示「Plugin Update Pending」。
- Recommended Plugins(推薦外掛)- 開啟搭檔外掛推薦檢視(與
/bs recommendedplugins相同)。當清單上的所有推薦都已安裝時,圖示會變成綠色。 - Download All Content(下載所有內容)- 附加在套件清單之後的批次項目,等同於
/bs downloadall。 - Automatic Updates(自動更新)- 一個工具列切換開關,控制 BetterStructures 是否在啟動時自動下載外掛與內容更新。此功能預設為關閉,並由
config.yml中的nightbreak.autoDownloadPluginUpdates鍵所支援。即使已下載外掛更新,仍需重新啟動才能套用。 - Installation tips(安裝提示)- 資訊按鈕,會把設定指南、帳號權杖頁面、支援 Discord 以及可點擊的設定指令輸出到聊天欄。
在內容重新載入執行期間,/bs setup 會被拒絕開啟,因為此選單讀取的正是重新載入工作程序正在重建的登錄資料。請等待重新載入回報成功後再開啟它。
如果某個套件的檔案損壞或被部分刪除,/bs setup 不會修復它們 - 它只比對版本,並認定該套件已是最新。請改用 /bs forcereinstallcontent <package|all>。
手動匯入備選方案
手動匯入仍然透過以下方式運作:
plugins/BetterStructures/imports
保持套件的 zip 檔案完整,然後在需要時執行 /bs reload。/bs reload 會在重新載入的過程中匯入該資料夾內的所有內容,因此你不需要重新啟動就能讀取到剛丟進去的套件。
請注意,把檔案留在 imports 中會拖慢啟動速度:當該資料夾不為空時,BetterStructures 會等待其 softdepend 中列出的外掛完成初始化後才啟動,因為把內容匯入到另一個外掛的資料夾意味著該外掛必須重新載入。一旦該資料夾再次清空,BetterStructures 就會直接初始化而不再等待。
參見共享指南:手動匯入 vs 遊戲內管理。