Terra/结构配置

该页面介绍结构配置。

结构配置位于配置包内的structures/single/目录。
结构文件位于配置包内的structures/data/目录。
战利品表位于配置包内的structures/loot目录。

选项

id

结构的ID。但我仍推荐使用UPPER_SNAKE_CASE|蛇形命名法来给ID命名。

files

结构文件名的权重池及其权重（比如.tstructure）。该文件必须位于结构数据目录（structures/data/`）。

spawn

生成结构的选项。

• bound

  - 结构可生成的Y轴范围。如果结构扫描的Y轴在此范围之外则不会生成。

  • min - 最低Y轴

  • max - 最高Y轴

• start

  - 开始检测Y值的范围。插件将从该范围内选取随机值并向下搜索，直到匹配生成条件或超出范围。

  • min - 开始搜索的最低Y值

  • max - 开始搜索的最高Y值

• width - 填充网格中用于放置结构的单元格宽度。

• padding - 填充网格中用于放置结构的单元格之间的填充。

上图为填充网格的宽度和填充示例。黑点代表结构的生成位置。

loot

该结构使用的战利品表。键代表战利品表ID，值代表使用的战利品表文件（文件后缀为.json）。
战利品表文件位于structures/loot目录。可通过任意原版的战利品表生成器生成。

特性

特性定义了在生成后对结构的修改。该列表内添加多个结构特性，甚至是同一类型的多个特性。

ENTITY_FEATURE

在结构生成后生成的实体。

• entity - 生成的实体类型

• amount

  - 生成实体数

  • min - 最小生成数

  • max - 最大生成数

• attempts - 最大生成尝试次数（如果超出上限则无视amount）

• spawnable-on -实体可生成在哪些方块上

• spawnable-in - 实体可生成在哪些方块内（空气）。

• in-height - 根据 "spawnable-in "列表垂直搜索验证的方块数。

示例实体特性：

该结构有两个实体特性。其中之一可以生成20-30只蠹虫（但会在40次尝试后放弃生成），另一者生成10-15只僵尸（但会在20次尝试后放弃生成）。

features:
  - ENTITY_FEATURE:
      entity: SILVERFISH
      attempts: 40
      in-height: 1
      amount:
        min: 20
        max: 30
      spawnable-on:
        - "minecraft:stone"
        - "minecraft:stone_bricks"
        - "minecraft:mossy_stone_bricks"
      spawnable-in:
        - "minecraft:air"
  - ENTITY_FEATURE:
      entity: ZOMBIE
      attempts: 20
      in-height: 2
      amount:
        min: 10
        max: 15
      spawnable-on:
        - "minecraft:stone"
        - "minecraft:stone_bricks"
        - "minecraft:mossy_stone_bricks"
      spawnable-in:
        - "minecraft:air"