BetterStructures 指令
使用 /betterstructures 或 /bs。
設定與內容
| 指令 | 用途 |
|---|---|
/bs | 主要說明與狀態指令 |
/bs initialize | 首次設定流程（開啟首次設定選單） |
/bs setup | 開啟設定/內容選單 |
/bs recommendedplugins | 顯示與 BetterStructures 搭配良好的搭檔外掛 |
/bs downloadall | 下載外掛更新（若有）以及所有可用內容，然後重新載入 |
/bs downloadallcontent | 僅下載所有可用的內容套件（不含外掛更新） |
/bs updatecontent | 下載過時內容的更新（別名：/bs updateallcontent） |
/bs forcereinstallcontent <package|all> | 即使已安裝的版本已是最新，仍透過一般的已驗證管線重新下載內容。Tab 補全會提供 all 以及每個 Nightbreak 套件的 slug。 |
/bs downloadpluginupdate | 下載待處理的外掛更新（需重新啟動才能套用） |
/bs reload | 重新載入 BetterStructures 的設定與內容，並匯入待處理的內容 |
/bs version | 顯示外掛版本 |
關於 /bs reload
/bs reload 不再停用並重新啟用外掛。它現在會執行原地內容重新載入：先在伺服器執行緒上重新讀取 config.yml 與 ValidWorlds.yml，接著在工作執行緒上重建寶藏、生成器、模組生成器、生成池、schematic、模組與內容套件的設定。指令、監聽器與 NMS 轉接器則維持已註冊狀態。
值得留意的影響：
- 在重新載入進行期間，
/bs place、/bs lootify、/bs pregenerate與/bs generateModules會以「content is reloading」訊息被拒絕，且新生成的區塊會被略過而不會被掃描。 - 若你在重新載入進行中再次執行
/bs reload，你的請求會被排入佇列，之後會再執行一次完整的重新載入，因此你在重新載入途中變更的檔案仍會被讀取到。 - 若重新載入失敗，BetterStructures 會刻意停用自己，而不是帶著半空的內容註冊表繼續執行。請查看主控台找出原因，修正後重新啟動伺服器。
關於 /bs forcereinstallcontent
一般的下載會略過本機版本已與遠端版本相符的套件，這使得當磁碟上的檔案損壞或被部分刪除時，那些指令毫無用處。forcereinstallcontent 會繞過該版本檢查，把選定的套件重新推送過同一條已驗證的下載、匯入與重新載入管線。
all會選取 BetterStructures 目前認定為已下載、已安裝或已過時的所有套件。若沒有任何項目符合，此指令會被拒絕並要求你直接指定一個 slug — 當某個套件的檔案完全遺失時，這正是你需要的做法。- 指定單一 slug 只會重新安裝該套件。
- 未知的 slug 會被拒絕，並回覆一則指向 Tab 補全的訊息。
下載/更新、推薦外掛與外掛更新等指令，是由內建於 BetterStructures 中的共享 MagmaCore Nightbreak 系統所提供。同一個設定選單也會顯示 Plugin Update（外掛更新）項目、Recommended Plugins（推薦外掛）項目，以及 Automatic Updates（自動更新）切換開關（請參閱 設定）。
工具與管理指令
| 指令 | 用途 |
|---|---|
/bs place <schematic> <type> | 手動放置結構。有效類型：SURFACE、UNDERGROUND_SHALLOW、UNDERGROUND_DEEP、SKY、LIQUID_SURFACE |
/bs lootify <generator> <rarity> <minAmount> <maxAmount> <weight> | 將手持物品加入寶藏表。generator 必須是有效的寶藏設定，rarity 必須存在於該設定中，minAmount 至少為 1，maxAmount 最多為 64，且你必須手持物品。 |
/bs pregenerate <centerType> <shape> <radiusInBlocks> <applyWorldBorder> | 預先生成啟用 BetterStructures 的區塊。世界取自玩家當前所在的世界。centerType：HERE、WORLD_CENTER、WORLD_SPAWN。shape：SQUARE、CIRCLE。applyWorldBorder：TRUE/FALSE。 |
/bs cancelPregenerate | 取消玩家當前世界中正在進行的預生成（別名：/bs cancelpregenerate） |
/bs generateModules <generatorFile> | 從模組生成器檔案生成模組化內容 |
/bs teleport <world> <x> <y> <z> | 傳送到指定位置（別名：/bs tp） |
/bs silent | 切換特定的管理員警告 |
權限
| 權限 | 說明 | 預設 |
|---|---|---|
betterstructures.setup | 存取 /bs setup、/bs recommendedplugins、/bs downloadallcontent 和 /bs updatecontent | OP |
betterstructures.initialize | 存取 /bs initialize | OP |
betterstructures.generatemodules | 存取 /bs generateModules | OP |
betterstructures.generatemodules.slowly | 已在 plugin.yml 中註冊，但目前並未被原始碼中的任何指令使用。可能為歷史殘留。 | OP |
betterstructures.generatemodules.instantly | 已在 plugin.yml 中註冊，但目前並未被原始碼中的任何指令使用。可能為歷史殘留。 | OP |
betterstructures.* | 工具與管理指令（place、pregenerate、cancelPregenerate、reload、teleport、version、lootify 以及 /bs 說明）的萬用權限，外加管理員內容指令 /bs downloadall、/bs downloadpluginupdate 與 /bs forcereinstallcontent。預設由 OP 持有。 | OP |
| (無) | /bs silent 在原始碼中沒有權限檢查 — 任何傳送者皆可執行。 | — |
betterstructures.setup 涵蓋內容瀏覽/管理指令，betterstructures.initialize 涵蓋首次設定，betterstructures.generatemodules 涵蓋地下城生成。同時包含外掛與內容的 /bs downloadall、僅含外掛的 /bs downloadpluginupdate，以及用於修復的 /bs forcereinstallcontent，皆受管理員萬用權限 betterstructures.* 所控管。.slowly 與 .instantly 變體雖仍宣告於 plugin.yml 中，但目前沒有任何指令會檢查它們。
betterstructures.* 同時也控制首次設定提醒：持有該權限的玩家會在加入時收到一則一次性訊息指向 /bs initialize，直到 config.yml 中的 setupDone 被設為 true 為止。