上一篇：
下一篇：
回到二级页：点我跳转
回到总目录：点我跳转
文档原链接：点我跳转
JSON 示例（仅供参考，不推荐在新项目中使用）：
气候类别说明：
变换类型说明：
⚠️ 重要提醒：
上一篇：
下一篇：
回到二级页：点我跳转
回到总目录：点我跳转
下一篇：
回到二级页：点我跳转
回到总目录：点我跳转
文档原链接：点我跳转
生物群系文档 - minecraft:overworld_generation_rules（主世界生成规则组件）
控制此生物群系在主世界（Overworld）世界生成过程中如何被实例化（以及随后可能被修改）。⚠️ 注意
这是一个 "洞穴与山崖"（Caves and Cliffs）更新之前 的组件，不用于自定义生物群系。
- 已弃用组件 — 此组件是 Minecraft 1.17 "洞穴与山崖" 更新之前的旧版生成系统的一部分。
- 不适用于自定义生物群系 — 如果您正在创建自定义生物群系，不应使用此组件，而应使用更新的生成规则组件。
- 主世界专用 — 此组件原本用于控制主世界的生物群系生成逻辑。
- 替代方案 — 对于新版 Minecraft（1.18+），建议使用以下组件替代：
- minecraft:overworld_height — 主世界高度控制
- minecraft:mountain_parameters — 山脉参数
- minecraft:surface_builder — 地表构建器
- 其他新版地形生成组件
- 向后兼容 — 此组件可能仍存在于旧版世界中，但在新内容开发中不应使用。
- 文档参考 — 如果您正在开发 Addon，请查阅最新的生物群系文档以获取推荐的生成规则组件。
生物群系主世界生成规则属性 (Biome Overworld Generation Rules Properties)
| 名称 | 默认值 | 类型 | 描述 | 示例值 |
|---|---|---|---|---|
| generate_for_climates | 未设置 | 字符串 (String) | 控制此生物群系可以生成的世界生成气候类别。 每个条目是一个 [climate_name, weight] 数组，其中 climate_name 为 'medium'（温和）、'warm'（温暖）、'lukewarm'（微温）、'cold'（寒冷）或 'frozen'（冰冻）。 | 见下方示例 |
| hills_transformation | 未设置 | 字符串数组 (Array of strings) | 任意大小的数组，包含恰好两个元素的数组。 对于每个包含的数组，第一个元素是气候类别字符串（'medium'、'warm'、'lukewarm'、'cold' 或 'frozen'）。 第二个元素是正整数，表示该条目相对于其他条目的权重。 | 见下方示例 |
| hills_transformation (备选方案 1) | 未设置 | 字符串 (String) | 简化格式，直接指定丘陵变换的生物群系。 | "minecraft:forest_hills" |
| mutate_transformation | 未设置 | 字符串数组 (Array of strings) | 转换为突变生物群系时切换到的生物群系。 | 见下方示例 |
| mutate_transformation (备选方案 1) | 未设置 | 字符串 (String) | 简化格式，直接指定突变变换的生物群系。 | "minecraft:jungle_mutated" |
| river_transformation | 未设置 | 字符串数组 (Array of strings) | 转换为河流生物群系时切换到的生物群系（如果不是原版 'river' 生物群系）。 | 见下方示例 |
| river_transformation (备选方案 1) | 未设置 | 字符串 (String) | 简化格式，直接指定河流变换的生物群系。 | "minecraft:river" |
| shore_transformation | 未设置 | 字符串数组 (Array of strings) | 与海洋生物群系相邻时切换到的生物群系。 | 见下方示例 |
| shore_transformation (备选方案 1) | 未设置 | 字符串 (String) | 简化格式，直接指定海岸变换的生物群系。 | "minecraft:beach" |
JSON 示例（仅供参考，不推荐在新项目中使用）：
JSON：
// ⚠️ 此组件已弃用，仅用于参考
"minecraft:overworld_generation_rules": {
"generate_for_climates": [
["medium", 1.0],
["warm", 0.5]
],
"hills_transformation": [
["medium", 1],
["warm", 2]
],
"mutate_transformation": "minecraft:jungle_mutated",
"river_transformation": "minecraft:river",
"shore_transformation": "minecraft:beach"
}气候类别说明：
| 气候类别 | 译法 | 说明 |
|---|---|---|
| medium | 温和 | 温带气候，如平原、森林 |
| warm | 温暖 | 热带气候，如丛林、沙漠 |
| lukewarm | 微温 | 介于温和与温暖之间 |
| cold | 寒冷 | 寒带气候，如针叶林 |
| frozen | 冰冻 | 极地气候，如冰原、雪地 |
变换类型说明：
| 变换类型 | 说明 | 示例 |
|---|---|---|
| hills_transformation | 丘陵地形变换 | 平原 → 丘陵 |
| mutate_transformation | 突变生物群系变换 | 丛林 → 突变丛林 |
| river_transformation | 河流生物群系变换 | 任意生物群系 → 河流 |
| shore_transformation | 海岸生物群系变换 | 陆地生物群系 → 海滩 |
⚠️ 重要提醒：
- 已弃用组件 — 这是 Minecraft 1.17 "洞穴与山崖" 更新之前的旧版生成系统组件。
- 不适用于自定义生物群系 — 创建新的自定义生物群系时不应使用此组件。
- 替代方案 — 对于新版 Minecraft（1.18+），请使用：
- minecraft:overworld_height — 主世界高度控制
- minecraft:mountain_parameters — 山脉参数
- minecraft:surface_builder — 地表构建器
- minecraft:climate — 气候组件
- 权重系统 — 数组格式中的第二个元素是权重值，值越高表示该选项被选中的概率越大。
- 字符串简化格式 — 备选方案 1 允许使用简单字符串格式，适用于单一变换目标。
- 生物群系 ID — 所有变换目标必须使用有效的 Minecraft 生物群系 ID（如 minecraft:forest）。
上一篇：
下一篇：
回到二级页：点我跳转
回到总目录：点我跳转
