建立生成器

生成器

生成器是 BetterStructures 配置系統中最強大的部分。預設有 31 個生成器，共同管理著 BetterStructures 目前發佈的 200 多個建筑。你可以建立自己的生成器，也可以使用現有的作為快捷方式。

生成器告訴外掛東西應該在哪裡生成，並定義戰利品表。預設生成器的名稱也很容易猜到它們的功能。

生成器配置選項

鍵	預設值	必需	描述
isEnabled	true	❌	生成器是否啟用
structureType	-	✅	結構生成位置（見下表）
lowestYLevel	-59	❌	生成的最低 Y 級別
highestYLevel	320	❌	生成的最高 Y 級別
validWorlds	全部允許	❌	結構可以生成的世界列表
validWorldEnvironments	全部允許	❌	NORMAL, NETHER, THE_END
validBiomesV2	所有生態群系	❌	有效生態群系列表（namespace:key 格式）
treasureFilename	-	❌	箱子戰利品的寶藏檔案

---

structureType

設定建筑的結構類型。你可以為單個生成器指定多個結構類型！

類型	主世界	下界	終界	描述
SURFACE	地表	類似地表的點	地表	在世界地表生成
SKY	Y 80-120	類似空氣的點	Y 80-120	在天空生成（可在 config.yml 中配置）
UNDERGROUND_SHALLOW	Y 0-60	Y 60-120	有效高度	淺層地下結構
UNDERGROUND_DEEP	Y -64 到 0	Y 0-60	❌ 不生成	深層地下結構
LIQUID_SURFACE	水（海洋）	岩漿湖	❌ 不生成	在液體表面生成
DUNGEON	✅	✅	✅	用於模組化地牢放置

多結構類型範例

structureType:
- SURFACE
- UNDERGROUND_SHALLOW

這允許同一生成器在多個位置生成結構，例如同時在地表和淺層地下區域。

注意：由於 Minecraft 有大量地下空間，因此有兩個地下設定。兩者都有可以確保在各深度均勻分佈，防止玩家錯過結構。

---

按維度劃分的 Y 級別範圍

每個維度的預設高度範圍（可在 config.yml 中配置）：

維度	預設範圍	配置設定
主世界/自訂	Y=-60 到 Y=320	lowestYNormalCustom / highestYNormalCustom
下界	Y=4 到 Y=120	lowestYNether / highestYNether
終界	Y=0 到 Y=320	lowestYEnd / highestYEnd
天空（主世界）	Y=80 到 Y=120	normalCustomAirBuildingMinAltitude / Max...
天空（終界）	Y=80 到 Y=120	endAirBuildMinAltitude / Max...

這些預設值可以使用 lowestYLevel 和 highestYLevel 按生成器覆蓋。

---

自訂生態群系支援

BetterStructures 自動支援來自 Terralith、Iris、Terra 和 TerraformGenerator 等世界生成器的自訂生態群系。

當你在 validBiomesV2 中指定原版生態群系時，外掛會自動包含相容的自訂生態群系：

validBiomesV2:
  - minecraft:plains
  - minecraft:forest

這會在原版生態群系和所有映射到這些類型的自訂生態群系（例如 terralith:blooming_plains）中生成結構。

---

treasureFilename

設定箱子戰利品的寶藏檔案。除非在 Schematic 設定 中覆蓋，否則這適用於使用此生成器的所有建筑。