自定义世界生成

此特性为Java版独有。

自定义世界生成（Custom world generation）可以让数据包改变世界的生成方式。

世界预设和维度[]

世界预设（World preset）控制世界具有哪些维度。在1.19（22w11a）之前，维度是在维度文件夹中定义的，而不是在世界预设中定义的。在当前版本中推荐使用世界预设，但游戏仍支持维度文件夹。

世界预设或维度定义了维度中使用的生成器（噪声、调试或超平坦）。如果是噪声生成器，又额外定义了使用什么噪声设置和生物群系，以及如何放置生物群系。

噪声设置[]

噪声设置（Noise settings）用于生成地形和噪声洞穴的形状，以及生成地形时使用哪些方块，其以JSON文件的形式存储在数据包的data/<命名空间>/worldgen/noise_settings目录下，用于维度中的minecraft:noise生成器。原版中的设置包括：minecraft:overworld用于一般的主世界生成，minecraft:amplified用于放大化主世界生成，minecraft:nether用于常规的下界生成，minecraft:caves用于洞穴生成，minecraft:end用于常规的末地生成，minecraft:floating_islands用于浮岛的生成。

在地形生成时，最终密度（final_density）小于等于零的位置为空气并将会被含水层填充，大于零的位置生成世界的默认方块default_block并将被地表规则（surface_rule)填充。在应用地表规则时，游戏会使用minecraft:surface噪声决定表层厚度，将（X,0,Z）处的噪声值 × 2.75 + 3.0作为表层厚度，而实际表层厚度还受与坐标相关的随机数的影响上下浮动0.25。该噪声与实际表层厚度在原版的地表规则中配合使用，例如用以决定平原生物群系里泥土和草方块的总厚度。

JSON格式[]

：根对象。
- sea_level：此维度的海平面高度。注意：该值只影响世界生成。生物生成所使用的海平面高度目前为固定值63。
- disable_mob_generation：是否禁止普通动物随地形一起生成。
- ore_veins_enabled：是否生成矿脉。
- aquifers_enabled：是否生成含水层和含熔岩层。
- legacy_random_source：是否使用1.18之前的旧的随机数生成器来生成世界。
- default_block：该维度地形的默认的方块。
  - 方块状态
- default_fluid：该维度默认的流体，用于生成海洋和湖。
  - 方块状态
- spawn_target：（必选，但可以为空）一个生物群系参数区间/值的列表，用于决定玩家出生点的环境条件。会选取距离(0,0)不超过2560格的多个点，获取其环境条件噪声值（depth值和offset值恒为0），计算 $\frac{\left(x^2+z^2\right)^2}{390625}+\sum_{i=1}^6d_i^2$ ${\frac {\left(x^{2}+z^{2}\right)^{2}}{390625}}+\sum _{i=1}^{6}d_{i}^{2}$ ，其中 $d_i$ $d_{i}$ 代表该点处某种生物群系参数的值到本列表中对应值的区间的距离（ $d=\inf_{a\in A}|x-a|$ $d=\inf _{a\in A}|x-a|$ ）。计算结果最小的位置就是最佳位置。玩家出生位置会在这个位置附近。
  - ：一个范围区间。
    - 生物群系噪声值参数
- noise：世界生成参数。
  - min_y：地形开始生成的最低高度。取值为-2032到2031的闭区间，必须是16的倍数（ $16k,-127\le k\le 126$ ）。
  - height：地形生成的总高度。取值为0到4064的闭区间，必须是16的整数倍（ $16k,0\le k\le 254$ ）。min_y + height不能超过2032。
  - size_horizontal：取值为0到4的闭区间。
  - size_vertical：取值为0到4的闭区间。
- noise_router：将密度函数应用于用于世界生成的噪声参数。以下每个字段可以填入一个密度函数ID或一个密度函数（包括常量形式和对象形式）。
  - initial_density_without_jaggedness：与含水层和地表规则的生成有关。在一XZ坐标下，从世界顶部开始以size_vertical*4个方块的精度从上到下查找，初次遇到大于25/64的值的高度作为世界生成的初始地表高度。该高度通常应该低于实际的地表高度（由final_density决定）。
  - final_density：决定了一个坐标是空气（可以生成含水层）还是世界的默认方块 default_block（将会被 surface_rule填充）。
  - barrier：影响是否使用方块分隔含水层和洞穴其他区域。函数值越大越有可能分隔。
  - fluid_level_floodedness：影响含水层生成液体的的概率。函数值越大越有可能生成。该噪声值大于1.0的被视为1.0，小于-1.0的被视为-1.0。
  - fluid_level_spread：影响某处含水层液体表面的高度。函数值越小液体表面越可能较低。
  - lava：影响某处含水层是否使用熔岩代替水。阈值为0.3。
  - vein_toggle：影响矿脉类型和垂直范围。这值大于0.0将是铜矿脉，小于等于0.0将是铁矿脉。
  - vein_ridged：控制哪些方块会参与组成矿脉。如果小于0.0，则方块是矿脉的一部分（是否为矿石块由下方值决定）。
  - vein_gap：影响矿脉中的哪些方块将是矿石块。如果大于-0.3，并且随机数小于从0.4到0.6映射到0.1到0.3的vein_toggle的绝对值，则会放置矿石块，且有2%的概率变为粗金属块。否则，将放置矿脉类型对应的石块。
  - temperature：生物群系的温度噪声。这里和下方的六个值是用于生物群系放置的生物群系参数。某点处生物群系的生物群系参数向量与该点处的对应参数向量的2-范数距离是最小的。
  - vegetation：即humidity，生物群系的湿度噪声。
  - continents：生物群系的大陆性噪声。
  - erosion：生物群系的侵蚀噪声。
  - depth：生物群系的深度噪声。
  - ridges：即weirdness，生物群系的奇异噪声。
- surface_rule：为地形填充方块。
  - 地表规则

密度函数和噪声[]

密度函数为noise_router提供能随坐标变化的值。

噪声[]

噪声可以被密度函数和地表规则调用，以JSON文件的形式存储在数据包的data/<命名空间>/worldgen/noise目录下。

除了被密度函数和地表规则调用外，也有一些具有硬编码的特殊用途的噪声。包括：

minecraft:surface：决定地表规则中的表层厚度。
minecraft:surface_secondary：作为地表规则中的附加表层厚度。
minecraft:clay_bands_offset：用以生成bandlands地表规则中的恶地陶瓦条带。
minecraft:badlands_pillar、minecraft:badlands_pillar_roof、minecraft:badlands_surface：硬编码在minecraft:eroded_badlands生物群系生成恶地柱。
minecraft:iceberg_pillar、minecraft:iceberg_pillar_roof、minecraft:iceberg_surface：硬编码在minecraft:frozen_ocean和minecraft:deep_frozen_ocean生物群系生成冰山。

噪声的JSON格式[]

：根对象。

- firstOctave：主倍频。如果噪声设置里的 legacy_random_source为true，必须为小于等于1的整数，否则取值范围不限。
- amplitudes：振幅列表。将此列表记为 $\{a_0,a_1,a_2,...,a_n\}$ $\{a_{0},a_{1},a_{2},...,a_{n}\}$ ，则列表中第i项（从0开始数）的子噪声的频率为 $2^{i+o}$ $2^{i+o}$ ，其中o为 firstOctave的值；此子噪声的振幅（与值域相关）为 $\frac{2^{n-i}a_i}{2^{n+1}-1}$ ${\frac {2^{n-i}a_{i}}{2^{n+1}-1}}$ 。各频率的子噪声值相加以得到总噪声值，取值上下限为 $\pm\frac{10r(l+1)\sum_{i=0}^n2^{n-i}a_i}{3(l+2)(2^{n+1}-1)}$ $\pm {\frac {10r(l+1)\sum _{i=0}^{n}2^{n-i}a_{i}}{3(l+2)(2^{n+1}-1)}}$ ，其中l是非零振幅子噪声的最大与最小编号之差，r为3维改进版柏林噪声的最大值，此值为常数，大于1且小于 $\sqrt{1.5}$ ${\sqrt {1.5}}$ ，可以取为1.036353811211803^[1]。如果噪声设置里的 legacy_random_source为true，则此列表长度必须小于等于 $1-o$ $1-o$ ，否则长度不限。
  - ：此倍频下的值。