跳至主要内容

建立生成器

生成器​

生成器是 BetterStructures 設定系統中最強大的部分。預設情況下有 31 個生成器，它們共同管理著 BetterStructures 目前發佈的 200 多個建築，雖然你可以建立自己的生成器，但你也可以使用現有的生成器作為快捷方式。

生成器告訴插件確切的生成位置，並定義戰利品表。預設生成器的命名方式也應該非常容易猜測它們的功能。

生成器的唯一必需欄位是 structureType 設定，它告訴插件建築是否應該在天空、淺層地下、深層地下、地表或地表液體中生成。

isEnabled​

設定生成器是否啟用。

structureType​

設定建築的類型。注意，你可以指定多個類型的列表！

你可以為單個生成器指定多個結構類型：

structureType:
- SURFACE
- UNDERGROUND_SHALLOW

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

以下是有效的結構類型值：

surface​

structureType:
- SURFACE

地表結構在世界表面生成。唯一的例外是下界環境，它在插件認為足夠像地表的位置生成。

sky​

structureType:
- SKY

天空結構在空中 80 至 120 方塊上方生成，可在 config.yml 中配置。唯一的例外是下界環境，它在插件認為足夠像空氣的位置生成。

underground_shallow​

structureType:
- UNDERGROUND_SHALLOW

淺層地下結構在上界的 y=0 至 y=60 之間生成，在下界的 y=60 至 y=120 之間生成，在末地的任何有效地下高度生成。

注意： 你會注意到有兩種地下設定。這是因為只有一種設定會導致地下非常稀疏，因為 Minecraft 有大量的地下空間，玩家經常會因為沒有挖進地下而錯過地下結構。這也保證了不同深度間的均勻分佈。

underground_deep​

structureType:
- UNDERGROUND_DEEP

深層地下結構在上界的 y=-64 至 y=0 之間生成，在下界的 y=0 至 y=60 之間生成，不在末地中生成。

liquid_surface​

structureType:
- LIQUID_SURFACE

液體表面結構將在液體上生成。在上界的情況下，它們將在水上生成，幾乎總是在大洋上。在下界的情況下，它們將在熔岩湖中生成。它們不會在末地中生成。

lowestYLevel​

設定結構生成的最低 Y 級別（高度）。預設值：-59。

highestYLevel​

設定結構生成的最高 Y 級別（高度）。預設值：320。

按維度劃分的預設 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 / normalCustomAirBuildingMaxAltitude 配置）
  • 天空結構（末地）： Y=80 至 Y=120（可透過 endAirBuildMinAltitude / endAirBuildMaxAltitude 配置）

這些全域預設值可以在生成器配置中使用 lowestYLevel 和 highestYLevel 覆蓋。

validWorlds​

設定結構將生成的世界列表。如果不存在列表，它將使用插件允許的所有世界，除非另有限制（例如按環境類型或生物群落）。

validWorldEnvironments​

設定結構將生成的世界環境列表。如果不存在列表，它將使用插件允許的所有世界環境。有效值：NORMAL、NETHER、THE_END 和 CUSTOM。

validBiomes​

設定結構將生成的有效生物群落列表。如果沒有定義列表，它將假定每個生物群落都是有效的！

這需要使用命名空間:金鑰格式的生物群落（例如，minecraft:plains、minecraft:desert）。你可以找到 Spigot API 定義的有效生物群落列表。該插件自動包括透過 CustomBiomeCompatibility 系統映射到原版生物群落的自訂生物群落。

自訂生物群落支援：

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

當你在 validBiomes 中指定原版生物群落時，插件自動包括相容的自訂生物群落：

validBiomes:
  - minecraft:plains
  - minecraft:forest

此設定將在以下位置生成結構：

  • 原版生物群落（minecraft:plains、minecraft:forest）
  • 映射到這些原版類型的所有自訂生物群落（例如，terralith:blooming_plains）

無需額外設定 - 自訂生物群落支援是自動的。

treasureFilename​

設定生成器將使用的寶藏檔案。這設定了使用此生成器的所有建築中的寶箱生成物，除非在 示意圖配置的 treasureFile 設定中設定了不同的值。