Addons教程【MC官方文档汉化转载】生物群系文档 - minecraft:overworld_height（主世界高度组件）

Buildosaur_积木小恐龙 · 昨天 23:18

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

文档原链接：点我跳转

生物群系文档 - minecraft:overworld_height（主世界高度组件）

用于驱动主世界（Overworld）地形高度的噪声参数。

⚠️ 注意
这是一个 "洞穴与山崖"（Caves and Cliffs）更新之前 的组件。

它不会改变主世界高度，目前仅影响地图物品的渲染效果。

名称	默认值	类型	描述	示例值
noise_params	未设置	数字数组 (Array of numbers)	第一个值是深度——越负表示水下越深，越正表示越高。第二个值是缩放，影响噪声从地表移动时的变化程度。注意：数组必须包含至少 2 项，且最多 2 项（即 [深度，缩放]）。	[-0.5, 0.3], [0.0, 0.5]
noise_type	未设置	噪声类型选项 (Noise Type choices)	指定基于内置设置的预设，而非手动使用 noise_params。	"mountains", "ocean", "default"

JSON 示例：
方式 1：使用 noise_params（手动设置噪声参数）

JSON：

// ⚠️ 此组件已弃用，仅用于参考
"minecraft:overworld_height": {
    "noise_params": [-0.2, 0.4]
}

方式 2：使用 noise_type（使用预设类型）

JSON：

// ⚠️ 此组件已弃用，仅用于参考
"minecraft:overworld_height": {
    "noise_type": "mountains"
}

noise_params 参数详解：

参数位置	名称	说明	示例值效果
第一个值	depth（深度）	控制地形的基础高度/深度	负值=水下，正值=高山
第二个值	scale（缩放）	控制噪声变化的幅度	值越大，地形起伏越剧烈

示例对比：

JSON：

// 深海地形
"noise_params": [-1.0, 0.1]

// 平原地形
"noise_params": [0.0, 0.2]

// 高山地形
"noise_params": [0.5, 0.5]

⚠️ 重要提醒：

已弃用组件 — 这是 Minecraft 1.17 "洞穴与山崖" 更新之前的旧版组件。
不影响实际地形高度 — 此组件目前仅影响地图物品的渲染效果，不会改变实际游戏中的地形高度。
两种设置方式：
表格

方式优点缺点
noise_params 精确控制深度和缩放需要手动调整参数
noise_type 使用预设，简单快捷自定义程度较低
数组格式要求 — noise_params 必须恰好包含 2 个数字：[深度，缩放]。
替代方案 — 对于新版 Minecraft（1.18+），请使用：
- minecraft:mountain_parameters — 山脉参数
- minecraft:surface_builder — 地表构建器
- 其他新版地形生成组件
地图渲染 — 此组件主要影响地图物品上生物群系颜色的显示高度效果。

噪声类型可视化参考：

代码：

地形高度（从低到高）：
deep_ocean → ocean → river → beach → swamp → default →
lowlands → taiga → highlands → less_extreme → extreme → mountains

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

方式	优点	缺点
noise_params	精确控制深度和缩放	需要手动调整参数
noise_type	使用预设，简单快捷	自定义程度较低