Addons教程 【MC官方文档汉化转载】生物群系文档 - minecraft:mountain_parameters（山脉参数组件）

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

文档原链接：点我跳转

生物群系文档 - minecraft:mountain_parameters（山脉参数组件）​

本文内容
生物群系山脉参数属性 (Biome Mountain Parameters Properties)​
陡峭材料调整 (Steep Material Adjustment)​
材料 (Material)​
顶部滑动 (Top Slide)​
​
用于驱动主世界（Overworld）山脉地形生成的噪声参数。

生物群系山脉参数属性 (Biome Mountain Parameters Properties)​

名称默认值类型描述示例值
east_slopes未设置布尔值 (Boolean true/false)启用朝东的斜坡生成。true, false
material未设置对象 (Object)用作陡峭地形的方块类型定义。见下方示例
north_slopes未设置布尔值 (Boolean true/false)启用朝北的斜坡生成。true, false
south_slopes未设置布尔值 (Boolean true/false)启用朝南的斜坡生成。true, false
steep_material_adjustment未设置陡峭材料调整项 (Steep Material Adjustment item)定义陡峭斜坡的地表材料。见下方示例
top_slide未设置顶部滑动项 (Top Slide item)控制世界顶部的密度渐变，以防止地形生成得过高。见下方示例
west_slopes未设置布尔值 (Boolean true/false)启用朝西的斜坡生成。true, false


JSON 结构示例：
JSON： 
"minecraft:mountain_parameters": {
    "east_slopes": true,
    "west_slopes": true,
    "north_slopes": false,
    "south_slopes": false,
    "material": {
        "blocks": [
            {
                "name": "minecraft:stone",
                "weight": 1.0
            }
        ]
    },
    "steep_material_adjustment": {
        "min_steepness": 0.6,
        "max_steepness": 1.0,
        "material": {
            "primary_block": "minecraft:stone",
            "surface_block": "minecraft:grass"
        }
    },
    "top_slide": {
        "target": 0.5,
        "size": 0.3,
        "offset": 0.0
    }
}

陡峭材料调整 (Steep Material Adjustment)​

定义陡峭斜坡的地表材料。

山脉参数 - 陡峭材料调整设置属性 (Mountain Parameters - Steep Material Adjustment Settings Properties)​

名称默认值类型描述示例值
east_slopes未设置布尔值 (Boolean true/false)启用朝东的斜坡。true, false
material未设置字符串 (String)用作陡峭材料的方块类型（字符串格式）。"minecraft:stone"
material (备选方案 1)未设置材料项 (Material item)用作陡峭材料的方块类型（对象格式）。见下方示例
north_slopes未设置布尔值 (Boolean true/false)启用朝北的斜坡。true, false
south_slopes未设置布尔值 (Boolean true/false)启用朝南的斜坡。true, false
west_slopes未设置布尔值 (Boolean true/false)启用朝西的斜坡。true, false


JSON 示例：
方式 1：使用字符串定义材料
JSON： 
"steep_material_adjustment": {
    "east_slopes": true,
    "west_slopes": true,
    "north_slopes": false,
    "south_slopes": false,
    "material": "minecraft:stone"
}

方式 2：使用材料项对象定义材料
JSON： 
"steep_material_adjustment": {
    "east_slopes": true,
    "west_slopes": true,
    "north_slopes": false,
    "south_slopes": false,
    "material": {
        "name": "minecraft:stone",
        "weight": 1.0
    }
}

注意事项：
  1. 方向控制 — 四个方向（东、南、西、北）的斜坡可以独立启用或禁用，允许创建具有特定走向的山脉。
  2. 材料定义两种方式：
    表格

    格式说明
    字符串简单格式，直接指定方块 ID
    材料项对象高级格式，可指定方块 ID 和权重
  3. 陡峭阈值 — 陡峭材料调整通常与 min_steepness 和 max_steepness 配合使用，定义何时应用此材料。
  4. 常见用途：
    • 在陡峭处暴露石头或裸岩
    • 在平缓处保留草方块或雪层
    • 创建不同生物群系的山脉特征
  5. 与 top_slide 配合 — 陡峭材料调整与顶部滑动参数配合使用，可创建更自然的山脉地形。
  6. 性能考虑 — 复杂的材料调整可能会轻微影响地形生成性能。

Material（材料）​

定义用于地形生成的方块类型及其状态属性。

材料属性 (Material Properties)​

名称默认值类型描述示例值
name未设置对象 (Object)方块的名称（方块 ID）。"minecraft:stone"
states{}键控数字集合 (Keyed set of numbers)包含以每个状态命名的成员，值为布尔值、整数或字符串。见下方示例
states (备选方案 1)未设置键控布尔值集合 (Keyed collection of boolean values)状态值为布尔值格式。见下方示例
states (备选方案 2)未设置键控字符串集合 (Keyed set of strings)状态值为字符串格式。见下方示例



JSON 示例：
方式 1：基础材料定义（仅名称）
JSON： 
"material": {
    "name": "minecraft:stone"
}

方式 2：带状态的 material（数字值）
JSON： 
"material": {
    "name": "minecraft:log",
    "states": {
        "axis": 0,
        "age": 3
    }
}

方式 3：带状态的 material（布尔值）
JSON： 
"material": {
    "name": "minecraft:door",
    "states": {
        "open": true,
        "powered": false
    }
}

方式 4：带状态的 material（字符串值）
JSON： 
"material": {
    "name": "minecraft:log",
    "states": {
        "axis": "y",
        "wood_type": "oak"
    }
}

常见方块状态示例：
方块状态名类型示例值
minecraft:logaxis字符串"x", "y", "z"
minecraft:dooropen布尔值true, false
minecraft:doorpowered布尔值true, false
minecraft:cropsage整数0 到 7
minecraft:woolcolor字符串"red", "blue", "green"
minecraft:stonestone_type字符串"stone", "granite", "diorite"

注意事项：
  1. name 字段 — 必须使用有效的 Minecraft 方块 ID，格式为 namespace:block_name（如 minecraft:stone）。
  2. states 字段 — 可选，用于指定方块的特殊状态。不是所有方块都有状态。
  3. 状态值类型 — 根据方块的不同，状态值可以是：
    • 布尔值：true / false
    • 整数：如 0, 1, 2, 3...
    • 字符串：如 "x", "y", "z", "red", "blue"...
  4. 状态验证 — 确保使用方块支持的有效状态名称和值，否则可能导致游戏崩溃或方块显示错误。
  5. 查询方块状态 — 可使用 F3 调试屏幕或游戏内命令查看方块的有效状态。
  6. 与陡峭材料配合 — 在 steep_material_adjustment 中使用材料定义时，可指定特定状态的方块以创建更丰富的地形效果。

Top Slide（顶部滑动）​

控制世界顶部发生的密度渐变，以防止地形生成得过高。

山脉参数 - 顶部滑动设置属性 (Mountain Parameters - Top Slide Settings Properties)​

名称默认值类型描述示例值
enabled未设置布尔值 (Boolean true/false)如果为 false，将禁用顶部滑动功能。
如果为 true，将考虑其他参数（如 target、size、offset）。		true, false


JSON 示例：
JSON： 
"top_slide": {
    "enabled": true,
    "target": 0.5,
    "size": 0.3,
    "offset": 0.0
}

完整 Top Slide 参数说明：
虽然当前表格仅显示 enabled 属性，但完整的 Top Slide 设置通常包含以下参数：
名称类型描述示例值
enabled布尔值是否启用顶部滑动功能true, false
target小数目标密度值，控制地形在顶部的密度0.5
size小数渐变区域的大小，值越大渐变范围越广0.3
offset小数渐变开始的偏移量，控制从哪个高度开始渐变0.0

注意事项：
  1. 启用/禁用 — 设置 enabled: false 将完全禁用顶部滑动，可能导致地形直插世界高度上限，形成不自然的"切割"效果。
  2. 密度渐变原理：
    参数作用
    target目标密度值，决定顶部地形的"稀疏"程度
    size渐变区域大小，决定过渡的平滑程度
    offset偏移量，决定从哪个高度开始应用渐变
  3. 视觉效果：
    • 启用顶部滑动：山峰自然变尖，过渡平滑
    • 禁用顶部滑动：地形可能在高处突然截断，形成平顶或不自然的山峰
  4. 推荐设置：
    JSON： 
    "top_slide": {
    "enabled": true,
    "target": 0.5,
    "size": 0.3,
    "offset": 0.0
}
    这数生物群系的推荐默认值，可创建自然的山脉顶部。
  5. 与其他参数配合 — Top Slide 与 height、steepness、jaggedness 等噪声参数配合使用，共同控制山脉的整体形状。
  6. 世界高度限制 — 顶部滑动有助于确保地形不会超过世界的最大高度限制（如 Y=320 在 1.18+ 版本中）。

上一篇：
下一篇：
回到二级页：点我跳转
回到总目录：点我跳转
 
点击展开...
您必须登录或注册才可回复。
广告位招租

最近话题

在线管理员

在线会员

当前在线： 192 （会员： 2, 游客： 190）
顶部 底部