Addons教程 【MC官方文件汉化转载】生物群系文档 - minecraft:replace_biomes（生物群系替换组件）

上一篇：
下一篇：
回到二级页：点我跳转
回到总目录：点我跳转

---

文档原链接：点我跳转

生物群系文档 - minecraft:replace_biomes（生物群系替换组件）​

本文内容

• 生物群系替换属性 (Biome Replace Biomes Properties)
• 生物群系替换 (Biome Replacement)

替换一个或多个 Minecraft 生物群系的指定部分。

---

生物群系替换属性 (Biome Replace Biomes Properties)​

名称	默认值	类型	描述	示例值
replacements	未设置	替换项 (Replacements item)	生物群系替换配置的列表。 注意：在此列表前端追溯性地添加新替换会导致世界生成发生变化。请将任何新替换添加到列表末尾。 请确保数组中至少有一个值，没有重复项，且维度为 minecraft:overworld 或 minecraft:nether。	见下方示例

---

生物群系替换 (Biome Replacement)​

表示用于确定覆盖生物群系放置的替换信息。

生物群系替换属性 (Biome Replacement Properties)​

名称	默认值	类型	描述	示例值
amount	未设置	小数 (Decimal number)	用于确定是否尝试替换的噪声值，类似于百分比。 必须在 (0.0, 1.0] 范围内。 注意：值必须 ≤ 1.0 且 > 0.0。	0.1, 0.5, 1.0
dimension	未设置	字符串 (String)	此替换可以发生的维度。 可以是 'minecraft:overworld' 或 'minecraft:nether'。	"minecraft:overworld", "minecraft:nether"
noise_frequency_scale	未设置	小数 (Decimal number)	用于更改替换尝试频率的缩放值。 较低频率 = 更大但较少出现的连续生物群系区域 较高频率 = 更小但较常出现的连续生物群系区域 必须在 (0.0, 100.0] 范围内。 注意：值必须 ≤ 100.0 且 > 0.0。	1.0, 10.0, 50.0
targets	未设置	对象数组 (Array of objects)	将被覆盖生物群系替换的生物群系。 注意：目标生物群系不能包含命名空间。数组必须至少有 1 项。	见下方示例

JSON 示例：

"minecraft:replace_biomes": {
    "replacements": [
        {
            "amount": 0.3,
            "dimension": "minecraft:overworld",
            "noise_frequency_scale": 5.0,
            "targets": [
                "plains",
                "forest"
            ]
        },
        {
            "amount": 0.5,
            "dimension": "minecraft:nether",
            "noise_frequency_scale": 10.0,
            "targets": [
                "nether_wastes"
            ]
        }
    ]
}

参数详解：

参数	取值范围	说明
amount	0.0 - 1.0	替换尝试的概率/比例（类似百分比）
dimension	固定值	替换发生的维度（主世界或下界）
noise_frequency_scale	0.0 - 100.0	控制替换区域的频率和大小
targets	数组	要被替换的目标生物群系列表

noise_frequency_scale 效果对比：

值	效果
1.0（低）	大块连续区域，出现频率较低
10.0（中）	中等大小区域，出现频率适中
50.0+（高）	小块分散区域，出现频率较高

注意事项：

1. 列表顺序重要 — 在 replacements 列表前端添加新替换会改变世界生成，应将新替换添加到末尾。
2. 目标生物群系格式 — targets 数组中的生物群系 ID 不能包含命名空间：
   
   • ✅ 正确："plains", "forest", "nether_wastes"
   • ❌ 错误："minecraft:plains", "minecraft:forest"
3. 维度限制 — dimension 只能是以下两个值之一：
   
   • "minecraft:overworld" — 主世界
   • "minecraft:nether" — 下界
4. 值范围验证：
   

   参数	最小值	最大值
   amount	> 0.0	≤ 1.0
   noise_frequency_scale	> 0.0	≤ 100.0

5. 数组要求 — replacements 和 targets 数组都必须至少包含 1 项。
6. 无重复项 — replacements 列表中不能有重复的替换配置。
7. 世界生成影响 — 修改此组件会影响世界生成，已生成的区块不会受影响，但新生成的区块会应用新规则。

---

---

上一篇：
下一篇：
回到二级页：点我跳转
回到总目录：点我跳转