BetterStructures 內容套件
BetterStructures 現在將官方內容視為託管套件來處理,而不是純粹的手動匯入工作流程。
主要指令
| 指令 | 用途 |
|---|---|
/bs initialize | 首次設定流程 |
/bs setup | 瀏覽和管理套件狀態 |
/bs downloadall | 下載外掛更新(若有)以及所有可用內容,然後重新載入 |
/bs downloadallcontent | 僅下載所有可用內容(不含外掛更新) |
/bs updatecontent | 更新過時內容(別名:/bs updateallcontent) |
/bs forcereinstallcontent <package|all> | 即使已安裝的版本已是最新,仍重新下載內容 - 這是用於修復損壞或被部分刪除套件的指令 |
/bs recommendedplugins | 列出與 BetterStructures 搭配良好的搭檔外掛 |
/nightbreaklogin <token> | 共享 Nightbreak 權杖註冊 |
下載和更新指令使用 BetterStructures 內建的 MagmaCore 共用 Nightbreak 系統檢查權杖、檢查存取權限並下載檔案。接著,BetterStructures 透過自己的重新載入流程匯入內容。
套件類型
每個套件都會宣告一個 contentPackageType,而設定選單會為每種類型提供一個篩選器:
contentPackageType | 設定選單篩選器 | 檔案存放位置 |
|---|---|---|
STRUCTURE(預設) | Structure Packs | plugins/BetterStructures/schematics/<folderNameV2> |
MODULAR | Module Packs | plugins/BetterStructures/modules/<folderNameV2> |
使用 /bs setup 來篩選和檢查套件,而不是依賴舊的靜態列表。
套件設定欄位
每個套件都由 plugins/BetterStructures/content_packages 中的一份設定檔描述。你很少需要手動編輯它們 - 它們隨外掛一起附帶,而且是外掛追蹤套件狀態的方式 - 但各欄位如下:
| 鍵 | 預設值 | 說明 |
|---|---|---|
isEnabled | true | 由設定選單修改的套件安裝旗標。設為 false 時,套件資料夾內的任何內容都不會載入,詳見下文。 |
name | — | 顯示在設定選單中的名稱 |
description | — | 顯示在設定選單中的說明文字 |
downloadLink | — | 套件沒有 nightbreakSlug 時顯示的手動下載連結;託管下載使用 slug |
version | 0 | 本機內容版本,會與遠端版本比對以判斷套件是否過時 |
folderNameV2 | — | 套件檔案所在的子資料夾,依類型位於 schematics 或 modules 之下 |
contentPackageType | STRUCTURE | STRUCTURE 或 MODULAR |
nightbreakSlug | — | 用於存取檢查與下載的 Nightbreak 識別碼,同時也是 /bs forcereinstallcontent 的選取子 |
從設定選單安裝或解除安裝套件時,只會修改套件的 isEnabled,然後觸發重新載入。它不會編輯套件內的 schematic 或模組設定。解除安裝會保留磁碟上的檔案。
當套件的 isEnabled: false 時,schematic 與模組載入器會略過其整個資料夾,也就是 schematics/<folderNameV2> 或 modules/<folderNameV2>,包括子資料夾。這同時適用於 STRUCTURE 與 MODULAR 套件。在已啟用的套件中,每個 schematic 與模組設定仍各有自己的 isEnabled。
套件內容
BetterStructures 套件是一個 zip 檔,其 pack.meta 宣告了 betterstructures。放在 plugins/BetterStructures/imports 中、沒有 pack.meta 的 zip 也會以相同方式處理。其頂層資料夾會依名稱解包:
| 套件中的資料夾 | 目的地 |
|---|---|
content_packages、schematics、modules、module_generators、generators、treasures、spawn_pools、components | plugins/BetterStructures 中同名的資料夾 |
custombosses、customitems、customtreasurechests、powers、enchantments | plugins/EliteMobs 中同名的資料夾 |
models 或 modelengine | FreeMinecraftModels 的模型資料夾;若只安裝了 ModelEngine,則為 ModelEngine 的 blueprints |
scripts | plugins/FreeMinecraftModels/scripts |
freeminecraftmodels、elitemobs、betterstructures | 該外掛資料夾的根目錄,並保留其中的結構,例如 freeminecraftmodels/enchantments |
worldcontainer | 伺服器的世界容器資料夾 |
若有頂層資料夾不在此表中,匯入器會拒絕整個套件。共用的匯入規則請參閱手動匯入與遊戲內管理。
當套件加入 EliteMobs 內容時,BetterStructures 會在匯入後重新載入 EliteMobs。當其他外掛的套件將檔案匯入 BetterStructures 資料夾時,BetterStructures 會在自身啟動完成後執行一次內容重新載入。
套件狀態
根據套件和你的權杖狀態,BetterStructures 可以區分:
- 已安裝的內容
- 已下載但未啟用的內容
- 過時的內容
- 需要 Nightbreak 存取權限的內容
選單將路徑存在的套件視為已下載,再結合套件的 isEnabled 旗標判斷是否已安裝。這只是狀態指示,並非檔案完整性檢查:空資料夾或損壞的資料夾也可能顯示為已安裝。使用 /bs forcereinstallcontent <package|all> 修復檔案。all 會選取目前被辨識為已下載、已安裝或過時的套件;若整個套件資料夾都已遺失,請直接指定 slug。
手動匯入備選方案
手動匯入仍然使用:
plugins/BetterStructures/imports
保持套件的 zip 檔案完整,然後在需要時重新載入 BetterStructures。手動匯入仍然受支援,但不再是主要的文件化工作流程。