跳至主要內容

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 Packsplugins/BetterStructures/schematics/<folderNameV2>
MODULARModule Packsplugins/BetterStructures/modules/<folderNameV2>

使用 /bs setup 來篩選和檢查套件,而不是依賴舊的靜態列表。

套件設定欄位​

每個套件都由 plugins/BetterStructures/content_packages 中的一份設定檔描述。你很少需要手動編輯它們 - 它們隨外掛一起附帶,而且是外掛追蹤套件狀態的方式 - 但各欄位如下:

鍵預設值說明
isEnabledtrue由設定選單修改的套件安裝旗標。設為 false 時,套件資料夾內的任何內容都不會載入,詳見下文。
name—顯示在設定選單中的名稱
description—顯示在設定選單中的說明文字
downloadLink—套件沒有 nightbreakSlug 時顯示的手動下載連結;託管下載使用 slug
version0本機內容版本,會與遠端版本比對以判斷套件是否過時
folderNameV2—套件檔案所在的子資料夾,依類型位於 schematics 或 modules 之下
contentPackageTypeSTRUCTURESTRUCTURE 或 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、componentsplugins/BetterStructures 中同名的資料夾
custombosses、customitems、customtreasurechests、powers、enchantmentsplugins/EliteMobs 中同名的資料夾
models 或 modelengineFreeMinecraftModels 的模型資料夾;若只安裝了 ModelEngine,則為 ModelEngine 的 blueprints
scriptsplugins/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。手動匯入仍然受支援,但不再是主要的文件化工作流程。