查看“Terra/群系配置”的源代码

{{模板:TRBox}}

This page discusses the configuration of Biomes. For information on Biomes, see the [https://github.com/PolyhedralDev/TerraDefaultConfig/wiki/Biomes About Biomes] page.

Biome configurations are in the <code>biomes/</code> directory within a config pack.

= 主要选项 =

== id ==

The ID of this Biome. Any string will work as an ID, though it is generally recommended to use UPPER''SNAKE''CASE for object IDs.

== extends ==

This key holds the ID of the abstract biome this biome extends. It is optional. If included, any abstractable keys missing from this biome will be pulled from the super biome.

== noise-equation ==

生成地形使用的噪声等式。正数值生成坚实（solid）地形，负数值生成负（negative）地形。变量和函数：

* <code>x</code> - 当前x轴坐标
* <code>y</code> - 当前y轴坐标
* <code>z</code> - 当前z轴坐标
* <code>noise2(x, z)</code> - Get 2D noise at an X and Z value. (Parameters can be expressions, e.g. <code>noise2(x/5, z*2)</code>).
* <code>noise2(x, y, z)</code> - Get 3D noise at an X, Y and Z value. (Parameters can be expressions, e.g. <code>noise2(x/5, y^2, z*2)</code>).
* Terra includes most standard mathematical functions (trig functions, <code>max(a, b)</code>, <code>min(a, b)</code>, <code>floor(x)</code>, <code>ceil(x)</code>, <code>round(x)</code>, etc.) If you want another function implemented, submit a PR to our [https://github.com/PolyhedralDev/parsii Parsii fork], or create an issue requesting it.

More info about setting up equations [https://github.com/PolyhedralDev/TerraDefaultConfig/wiki/My-First-Noise-Equation here].<br />
This value must be included, and can be abstracted.

== vanilla ==

该自定义群系使用的原版群系ID。可以在[https://hub.spigotmc.org/javadocs/spigot/org/bukkit/block/Biome.html 这里]找到群系的ID。

== erodible ==

A boolean value that defines whether this biome can be [https://github.com/PolyhedralDev/TerraDefaultConfig/wiki/pack.yml-Options#erode eroded].<br />
This value is optional (defaults to false) and '''cannot''' be abstracted,

= 次要选项 =

== structures ==

A list of [https://github.com/PolyhedralDev/TerraDefaultConfig/wiki/Structure-Configuration structure config] IDs that can generate in this biome.<br />
This value is optional (defaults to an empty list) and can be abstracted.

== palette ==

A list of Palettes to use in the biome. Each list entry contains a single key-value pair, with the key being the palette ID, and the value being the Y-level at which the palette ''starts'' to generate.

A shortcut exists for palettes that only contain a single block. Instead of creating a palette file for a single-block palette, you may simply include <code>BLOCK:minecraft:block_id</code> as a palette ID in this list.<br />
This value must be included, and can be abstracted.

Example Palette Configurationpalette:
  - &quot;BLOCK:minecraft:bedrock&quot;: 0
  - GRASSY: 255This palette configuration generates the GRASSY palette at Y level 255 and down, until it reaches Y=0, where a single-block palette containing just Bedrock will be generated.

== snow ==

A list of Snow configurations to use in the biome. This allows you to configure different amounts of snow at different Y-levels. Each entry defined the minimum Y-value, maximum Y-value, and amount of snow to generate within that range.<br />
This value must be included, and can be abstracted.

Example Snow Configurationsnow:
  - min: 0
    max: 120
    # Chance is per 100
    chance: 50 # 50%
  - min: 120
    max: 140
    chance: 75 # 75%
  - min: 140
    max: 255
    chance: 100 # 100%This snow configuration generates 50% snow from Y=0-120, then 75% snow from Y=121-140, and 100% snow above Y=141.

== flora ==

Various options that define the Flora to generate in this biome.<br />
This value must be included, and can be abstracted.<br />
Options:

<ul>
<li><p><code>chance</code> - The chance (per 100) each block will attempt to generate Flora. (Optional, defaults to 0).</p></li>
<li><p><code>attempts</code> - The amount of times to attempt Flora generation (Optional, defaults to 1).<br />
This value is useful when a biome has many Flora types with conflicting heights/spawn criteria, since if spawning fails, another type of Flora will attempt to generate.</p></li>
<li><pre class="">simplex</pre>
<p> </p>
<p>- Options to distribute Flora using Simplex noise</p>
<ul>
<li><p><code>enable</code> - Whether to use Simplex noise to distribute Flora (When false, pseudorandom is used). (Optional, defaults to false).</p></li>
<li><p><code>frequency</code> - Frequency of the Simplex noise generator. (Optional, defaults to 0.1).</p></li>
<li><p><code>seed</code> - Seed of the Simplex noise generator (Optional, defaults to 2403).</p></li></ul>
</li>
<li><pre class="">items</pre>
<p> </p>
<p>- Contains definitions for the types of Flora to generate in this biome, along with their weights and height restrictions.</p>
<ul>
<li><pre class="">FLORA_ID</pre>
<p> </p>
<p>- The ID of a Flora object to generate in this biome. This can be either</p>
<p> </p>
<p>pre-included</p>
<p> </p>
<p>flora, or a</p>
<p> </p>
<p>custom</p>
<p> </p>
<p>Flora object ID. A biome may have any number of Flora objects defined.</p>
<ul>
<li><p><code>weight</code> - The weight of this Flora object in this biome's Flora [https://github.com/PolyhedralDev/TerraDefaultConfig/wiki/Weighted-Pools pool].</p></li>
<li><pre class="">y</pre>
<p> </p>
<p>- Height restrictions for this Flora object.</p>
<ul>
<li><p><code>min</code> - The minimum height at which this Flora object can generate.</p></li>
<li><p><code>max</code> - The maximum height at which this Flora object can generate.</p></li></ul>
</li></ul>
</li></ul>
</li></ul>

Example Flora Configurationflora:
  chance: 60
  attempts: 1
  items:
    TALL_GRASS:
      weight: 29
      y:
        min: 62
        max: 84
    GRASS:
      weight: 70
      y:
        min: 62
        max: 84
    SUNFLOWER:
      weight: 1
      y:
        min: 62
        max: 84A standard Flora configuration, using all included Flora. All Flora items have the same height restrictions; they can only generate from Y levels 62 to 84.GRASS is the most common, with a weight of 70/100 (70%).TALL_GRASS has a weight of 29/100 (29%)SUNFLOWER has a weight of 1/100 (1%).Every block in this biome has a 60% chance of generating Flora, and generation will only be attempted once.

== trees ==

Various options that define Tree generation in this biome. This value must be included, and can be abstracted.<br />
Options:

<ul>
<li><p><code>density</code> - The chance (per 1000) every fourth block will attempt to generate a Tree. (Optional, defaults to 0).<br />
(Since this value is every ''fourth'' block, it can be thought of as out of 4000).</p></li>
<li><pre class="">items</pre>
<p> </p>
<p>- Contains definitions for the types of Trees to generate in this biome, along with their weights and height restrictions.</p>
<ul>
<li><pre class="">TREE_ID</pre>
<p> </p>
<p>- The ID of a Tree object to generate in this biome. This can be either</p>
<p> </p>
<p>pre-included</p>
<p> </p>
<p>trees, or a</p>
<p> </p>
<p>custom</p>
<p> </p>
<p>Tree object ID. A biome may have any number of Tree objects defined.</p>
<ul>
<li><p><code>weight</code> - The weight of this Tree object in this biome's Tree [https://github.com/PolyhedralDev/TerraDefaultConfig/wiki/Weighted-Pools pool].</p></li>
<li><pre class="">y</pre>
<p> </p>
<p>- Height restrictions for this Tree object.</p>
<ul>
<li><p><code>min</code> - The minimum height at which this Tree object can generate.</p></li>
<li><p><code>max</code> - The maximum height at which this Tree object can generate.</p></li></ul>
</li></ul>
</li></ul>
</li></ul>

Example Tree Configurationtrees:
  density: 250
  items:
    OAK:
      weight: 8
      y:
        min: 58
        max: 84
    LARGE_OAK:
      weight: 2
      y:
        min: 58
        max: 84A standard Tree configuration, potentially useful for a forest. It uses all included Trees. All Tree items have the same height restrictions; they can only generate from Y levels 58 to 84.OAK is the most common, with a weight of 8/10 (80%).LARGE_OAK has a weight of 2/10 (20%).Every fourth block in this biome has a 25% chance of generating a Tree, meaning every block in this biome has a 6.25% chance of generating a tree.

== carving ==

Options for Carvers in this biome. This option contains key-value pairs.<br />
The key is a [https://github.com/PolyhedralDev/TerraDefaultConfig/wiki/Carver-Configuration Carver] ID, and the value is tha ''chance per chunk'' that carver will spawn in a chunk. '''Carvers aren't stored in a weighted pool''', Each carver uses an independent calculation, therefore multiple carvers may spawn in the same chunk!

Example Carver Configurationcarving:
  CAVE: 30
  RAVINE: 5
  CAVERN: 5This configuration defined 3 Carvers in this biome:CAVE with a 30% chance of spawning per chunk.RAVINE with a 5% chance of spawning per chunk.CAVERN with a 5% chance of spawning per chunk.

== ores ==

A set of entries that each define an [https://github.com/PolyhedralDev/TerraDefaultConfig/wiki/Ore-Configuration Ore] object to generate, how much of it to generate, and the maximum and minimum Y-levels at which veins may generate.<br />
Options:

<ul>
<li><pre class="">ORE_ID</pre>
<p> </p>
<p>- The ID of the Ore object to generate.</p>
<ul>
<li><p><code>min</code> - The minimum number of veins to generate per chunk.</p></li>
<li><p><code>max</code> - The maximum number of veins to generate per chunk.</p></li>
<li><p><code>min-y</code> - The minimum Y-level at which veins may begin.</p></li>
<li><p><code>max-y</code> - The maximum Y-level at which veins may begin.</p></li></ul>
</li></ul>

Example Ore Configurationores:
  DIRT:
    min: 0
    max: 1
    min-height: 0
    max-height: 84
  GRAVEL:
    min: 0
    max: 1
    min-height: 0
    max-height: 84
  DIORITE:
    min: 0
    max: 1
    min-height: 0
    max-height: 84
  ANDESITE:
    min: 0
    max: 1
    min-height: 0
    max-height: 84
  GRANITE:
    min: 0
    max: 1
    min-height: 0
    max-height: 84
  COAL_ORE:
    min: 4
    max: 8
    min-height: 0
    max-height: 84
  IRON_ORE:
    min: 2
    max: 6
    min-height: 0
    max-height: 64
  GOLD_ORE:
    min: 1
    max: 3
    min-height: 0
    max-height: 32
  LAPIS_ORE:
    min: 1
    max: 2
    min-height: 0
    max-height: 32
  REDSTONE_ORE:
    min: 1
    max: 2
    min-height: 0
    max-height: 16
  DIAMOND_ORE:
    min: 1
    max: 1
    min-height: 0
    max-height: 16This configuration is a classic, it defines several &quot;deposits&quot; (Dirt, Gravel, Diorite, Andesite, Granite), as well as all Vanilla ores, at standard Y-levels and chances. This example assumes that Ore configs with the corresponding IDs have been set up.

= Super-Secret Advanced Options =

These options are for advanced users that wish to have more control over biomes.

== prevent-smooth ==

Enabling this option prevents this biome from receiving an additional layer of smoothing on top of the standard 4x4x4 trilinear interpolation. Enabling this option grants finer control over terrain generation, but will introduce terrain artifacts if you don't know how to properly handle the lack of extra smoothing! This option defaults to false, and cannot be abstracted.

== ocean ==

Options for the ocean in this biome.

* <code>level</code> - Y-value at which to generate oceans. Ocean will be generated at locations that would be air, and are below this Y-value. Defaults to 62.
* <code>palette</code> - Palette to generate Ocean with. Defaults to a single-block palette containing Water.