创建生成器

生成器

生成器是 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 配置 中覆盖，否则这适用于使用此生成器的所有建筑。