查看“Terra/结构配置”的源代码

{{模板:TRBox}}

该页面介绍结构配置。

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

= 选项 =

== id ==

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

== files ==

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

== spawn ==

生成结构的选项。

<ul>
<li><pre class="">bound</pre>
<p> </p>
<p>- 结构可生成的Y轴范围。如果结构扫描的Y轴在此范围之外则不会生成。</p>
<ul>
<li><p><code>min</code> - 最低Y轴</p></li>
<li><p><code>max</code> - 最高Y轴 </p></li></ul>
</li>
<li><pre class="">start</pre>
<p> </p>
<p>- 开始检测Y值的范围。插件将从该范围内选取随机值并向下搜索，直到匹配生成条件或超出范围。</p>
<ul>
<li><p><code>min</code> - 开始搜索的最低Y值</p></li>
<li><p><code>max</code> - 开始搜索的最高Y值</p></li></ul>
</li>
<li><p><code>width</code> - 填充网格中用于放置结构的单元格宽度。</p></li>
<li><p><code>padding</code> - 填充网格中用于放置结构的单元格之间的填充。</p></li></ul>

[[File:terra structure.png]]

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

== loot ==

该结构使用的战利品表。键代表[https://github.com/PolyhedralDev/Terra/wiki/Working-With-Structures#Loot 战利品表ID]，值代表使用的战利品表文件（文件后缀为<code>.json</code>）。<br />
战利品表文件位于<code>structures/loot</code>目录。可通过任意原版的[https://amaury.carrade.eu/minecraft/loot_tables 战利品表生成器]生成。

== 特性 ==

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

=== ENTITY_FEATURE ===

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

<ul>
<li><p><code>entity</code> - 生成的实体类型</p></li>
<li><pre class="">amount</pre>
<p> </p>
<p>- 生成实体数</p>
<ul>
<li><p><code>min</code> - 最小生成数</p></li>
<li><p><code>max</code> - 最大生成数</p></li></ul>
</li>
<li><p><code>attempts</code> - 最大生成尝试次数（如果超出上限则无视<code>amount</code>）</p></li>
<li><p><code>spawnable-on</code> -实体可生成在哪些方块上</p></li>
<li><p><code>spawnable-in</code> - 实体可生成在哪些方块内（空气）。</p></li>
<li><p><code>in-height</code> - 根据 &quot;spawnable-in &quot;列表垂直搜索验证的方块数。</p></li></ul>

示例实体特性：

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

<pre class="">features:
  - ENTITY_FEATURE:
      entity: SILVERFISH
      attempts: 40
      in-height: 1
      amount:
        min: 20
        max: 30
      spawnable-on:
        - &quot;minecraft:stone&quot;
        - &quot;minecraft:stone_bricks&quot;
        - &quot;minecraft:mossy_stone_bricks&quot;
      spawnable-in:
        - &quot;minecraft:air&quot;
  - ENTITY_FEATURE:
      entity: ZOMBIE
      attempts: 20
      in-height: 2
      amount:
        min: 10
        max: 15
      spawnable-on:
        - &quot;minecraft:stone&quot;
        - &quot;minecraft:stone_bricks&quot;
        - &quot;minecraft:mossy_stone_bricks&quot;
      spawnable-in:
        - &quot;minecraft:air&quot;</pre>