跳至主要內容

BetterStructures 設定

BetterStructures 仍然支援手動匯入,但目前推薦的工作流程是以 Nightbreak 為優先且在遊戲內操作。

要求

  • WorldEdit 或相容 FAWE 的結構圖支援
  • 當前建構線所需的 Java 21 執行環境

推薦工作流程

  1. 安裝 BetterStructures 和 WorldEdit,然後啟動伺服器一次。
  2. 執行 /bs initialize
  3. 使用 /nightbreaklogin <token> 連結 Nightbreak 權杖。
  4. 開啟 /bs setup 瀏覽結構套件和模組套件。
  5. 使用 /bs downloadall 快速引導(它會抓取待處理的外掛更新與所有內容)。
  6. 當有套件更新可用時使用 /bs updatecontent

首次設定選單

/bs initialize 會開啟一個小型引導選單。在選擇其中一個選項之前,每位持有 betterstructures.* 的玩家都會在加入伺服器十秒後收到一則提醒訊息。這三個選項都會透過在 config.yml 中寫入 setupDone: true 來將設定標記為已完成。

選項作用
Recommended Setup(推薦設定)標記設定完成,並列出三步驟流程:從 nightbreak.io/account 取得權杖、使用 /nightbreaklogin <token> 連結它,然後開啟 /bs setup
Manual Setup(手動設定)標記設定完成,並把內容管理交由你自行處理,同時指向 /bs setupimports 資料夾。
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 遊戲內管理