Addons教程 【MC官方文档汉化转载】生物群系文档 - minecraft:surface_builder（地表构建器组件）（上）

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

文档原链接：点我跳转

生物群系文档 - minecraft:surface_builder（地表构建器组件）​





本文内容
控制用于地形生成的材料。




生物群系地表构建器属性 (Biome Surface Builder Properties)​

名称默认值类型描述示例值
builder (主世界生物群系)未设置构建器项 (Builder item)控制用于地形生成的方块类型。见下方示例
builder (备选方案 1)未设置构建器项 (Builder item)适用于其他生物群系类型（如冰冻海洋）的构建器配置。见下方示例
builder (备选方案 2)未设置构建器项 (Builder item)适用于其他生物群系类型（如恶地）的构建器配置。见下方示例
builder (备选方案 3)未设置构建器项 (Builder item)适用于其他生物群系类型（如沼泽）的构建器配置。见下方示例
builder (备选方案 4)未设置构建器项 (Builder item)适用于其他生物群系类型（如覆盖型）的构建器配置。见下方示例
builder (备选方案 5)未设置构建器项 (Builder item)适用于其他生物群系类型（如末地）的构建器配置。见下方示


JSON 结构示例：
builder 字段的具体内容取决于您选择的生物群系类型（通过内部的 type 字段区分）。以下是几种常见类型的结构示例：
1. 主世界类型 (minecraft:overworld)
JSON： 
"minecraft:surface_builder": {
    "builder": {
        "type": "minecraft:overworld",
        "top_material": "minecraft:grass",
        "mid_material": "minecraft:dirt",
        "foundation_material": "minecraft:stone",
        "sea_material": "minecraft:water",
        "sea_floor_material": "minecraft:gravel",
        "sea_floor_depth": 30
    }
}

2. 恶地类型 (minecraft:mesa)
JSON： 
"minecraft:surface_builder": {
    "builder": {
        "type": "minecraft:mesa",
        "top_material": "minecraft:orange_terracotta",
        "clay_material": "minecraft:terracotta",
        "hard_clay_material": "minecraft:hardened_clay",
        "bryce_pillars": true,
        "has_forest": false
        // 其他基础材料字段...
    }
}

3. 冰冻海洋类型 (minecraft:frozen_ocean)
JSON： 
"minecraft:surface_builder": {
    "builder": {
        "type": "minecraft:frozen_ocean",
        "top_material": "minecraft:grass",
        // ... 其他标准字段，会自动生成冰山
    }
}

注意事项：
  1. 多态性 — builder 字段是一个多态对象。虽然文档列出了多个“备选方案”，但在实际 JSON 文件中，您只需要根据所需的生物群系类型填写一个 builder 对象。
  2. 类型决定结构 — builder 对象内部的 type 字段决定了该对象需要包含哪些具体属性（例如，mesa 类型需要 clay_material，而 overworld 类型不需要）。
  3. 必填字段 — 无论哪种类型，通常都需要定义 top_material（表层）、mid_material（中层）和 foundation_material（基础层）。
  4. 海平面相关 — 如果生物群系涉及水体，通常需要定义 sea_material、sea_floor_material 和 sea_floor_depth。
  5. 版本兼容性 — 确保使用的方块 ID 和属性与您目标 Minecraft 版本兼容。

主世界生物群系 (Biome Overworld)​

控制用于默认 Minecraft 主世界地形生成的方块。

主世界生物群系属性 (Biome Overworld Properties)​

名称默认值类型描述示例值
foundation_material未设置字符串 (String)控制此生物群系地下深处使用的方块类型。"minecraft:stone"
foundation_material (备选方案 1)未设置基础材料项 (Foundation Material item)对象格式的基础材料定义（可包含方块状态）。见下方示例
mid_material未设置字符串 (String)控制此生物群系地表下方层使用的方块类型。"minecraft:dirt"
mid_material (备选方案 1)未设置中层材料项 (Mid Material item)对象格式的中层材料定义（可包含方块状态）。见下方示例
sea_floor_depth未设置整数 (Integer number)控制海床应出现在世界水位下方多深的位置。
注意：值必须 ≤ 127。		30, 50, 127
sea_floor_material未设置字符串 (String)控制此生物群系中水体底部使用的方块类型。"minecraft:gravel"
sea_floor_material (备选方案 1)未设置海床材料项 (Sea Floor Material item)对象格式的海床材料定义（可包含方块状态）。见下方示例
sea_material未设置字符串 (String)控制此生物群系中水体使用的方块类型。"minecraft:water"
sea_material (备选方案 1)未设置海洋材料项 (Sea Material item)对象格式的海洋材料定义（可包含方块状态）。见下方示例
top_material未设置字符串 (String)控制此生物群系地表使用的方块类型。"minecraft:grass"
top_material (备选方案 1)未设置表层材料项 (Top Material item)对象格式的表层材料定义（可包含方块状态）。见下方示例
type未设置类型选项 (Type choices)控制要使用的地表构建器类型。"minecraft:overworld"


JSON 示例：
方式 1：使用字符串格式（简洁）
JSON： 
"minecraft:surface_builder": {
    "builder": {
        "type": "minecraft:overworld",
        "foundation_material": "minecraft:stone",
        "mid_material": "minecraft:dirt",
        "top_material": "minecraft:grass",
        "sea_floor_depth": 30,
        "sea_floor_material": "minecraft:gravel",
        "sea_material": "minecraft:water"
    }
}

方式 2：使用对象格式（可指定方块状态）
JSON： 
"minecraft:surface_builder": {
    "builder": {
        "type": "minecraft:overworld",
        "foundation_material": {
            "name": "minecraft:stone",
            "states": {}
        },
        "mid_material": {
            "name": "minecraft:dirt",
            "states": {
                "snowy": false
            }
        },
        "top_material": {
            "name": "minecraft:grass",
            "states": {
                "snowy": false
            }
        },
        "sea_floor_depth": 30,
        "sea_floor_material": {
            "name": "minecraft:gravel",
            "states": {}
        },
        "sea_material": {
            "name": "minecraft:water",
            "states": {
                "level": 0
            }
        }
    }
}

地层结构示意：
代码： 
                    ┌─────────────────┐
                    │  top_material   │  ← 地表（草方块/沙子等）
                    ├─────────────────┤
                    │  mid_material   │  ← 中层（泥土等）
                    ├─────────────────┤
                    │                 │
                    │ foundation_     │  ← 基础层（石头等）
                    │ material        │
                    │                 │
    ────────────────┴─────────────────┴─────── 海平面
                    │  sea_material   │  ← 水体（水）
                    ├─────────────────┤
                    │sea_floor_material│  ← 海床（沙砾/沙子等）
                    │                 │
                    ▼

注意事项：
  1. 两种材料格式 — 所有材料字段支持两种格式：
    格式优点适用场景
    字符串简洁快速不需要方块状态时
    对象可指定方块状态需要控制方块变体时
  2. 深度限制 — sea_floor_depth 的值必须 ≤ 127，表示海平面下方的最大深度。
  3. 类型字段 — type 必须设置为 "minecraft:overworld" 以使用主世界地表构建器。
  4. 地层顺序 — 从地表到地下深处的顺序为：
    top_material → mid_material → foundation_material
  5. 水体相关 — 如果生物群系包含水体，建议定义 sea_material、sea_floor_material 和 sea_floor_depth。
  6. 方块状态 — 使用对象格式时可指定方块状态，但需确保状态对该方块有效（如 snowy 对草方块有效）。
  7. 默认值 — 如果未设置某些字段，游戏将使用默认的主世界材料配置。
常见材料组合示例：
生物群系类型top_materialmid_materialfoundation_materialsea_floor_material
平原minecraft:grassminecraft:dirtminecraft:stoneminecraft:gravel
沙漠minecraft:sandminecraft:sandminecraft:stoneminecraft:sand
海滩minecraft:sandminecraft:sandminecraft:stoneminecraft:gravel
雪原minecraft:snowminecraft:dirtminecraft:stoneminecraft:gravel


Foundation Material（基础材料）​

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

基础材料属性 (Foundation 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： 
"foundation_material": {
    "name": "minecraft:stone"
}

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

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

方式 4：带状态的 foundation_material（字符串值）
JSON： 
"foundation_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. 与地表构建器配合 — 在 minecraft:surface_builder 中使用基础材料定义时，可指定特定状态的方块以创建更丰富的地形效果。
  7. 基础材料用途 — 基础材料通常用于定义生物群系地下深处的主要方块，如石头、深层石头等。

Mid Material（中层材料）​

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

中层材料属性 (Mid Material Properties)​

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


JSON 示例：
方式 1：中层材料定义（仅名称）
JSON： 
"mid_material": {
    "name": "minecraft:dirt"
}

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

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

方式 4：带状态的中层材料（字符串值）
JSON： 
"mid_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"
minecraft:dirtsnowy布尔值true, false

注意事项：
  1. name 字段 — 必须使用有效的 Minecraft 方块 ID，格式为 namespace:block_name（如 minecraft:dirt）。
  2. states 字段 — 可选，用于指定方块的特殊状态。不是所有方块都有状态。
  3. 状态值类型 — 根据方块的不同，状态值可以是：
    • 布尔值：true / false
    • 整数：如 0, 1, 2, 3...
    • 字符串：如 "x", "y", "z", "red", "blue"...
  4. 状态验证 — 确保使用方块支持的有效状态名称和值，否则可能导致游戏崩溃或方块显示错误。
  5. 查询方块状态 — 可使用 F3 调试屏幕或游戏内命令查看方块的有效状态。
  6. 与地表构建器配合 — 在 minecraft:surface_builder 中使用中层材料定义时，可指定特定状态的方块以创建更丰富的地形效果。
  7. 中层材料用途 — 中层材料通常用于定义生物群系地表下方的主要方块，如泥土、沙砾等，位于表层材料和基础材料之间。
完整地表构建器示例（使用中层材料）：
JSON： 
"minecraft:surface_builder": {
    "builder": {
        "type": "minecraft:overworld",
        "foundation_material": "minecraft:stone",
        "mid_material": {
            "name": "minecraft:dirt",
            "states": {
                "snowy": false
            }
        },
        "top_material": "minecraft:grass",
        "sea_floor_depth": 30,
        "sea_floor_material": "minecraft:gravel",
        "sea_material": "minecraft:water"
    }
}

地层结构中的中层材料位置：
代码： 
                    ┌─────────────────┐
                    │  top_material   │  ← 地表（草方块/沙子等）
                    ├─────────────────┤
      ┌────────────►│  mid_material   │  ← 中层（泥土等）★ 此处
      │             ├─────────────────┤
      │             │                 │
      │             │ foundation_     │  ← 基础层（石头等）
      │             │ material        │
      │             │                 │
      │             └─────────────────┘
      │
      └── 中层材料位于表层和基础层之间

常见中层材料选择：
生物群系类型推荐中层材料说明
平原/森林minecraft:dirt标准泥土层
沙漠minecraft:sand沙层延伸至地下
雪原minecraft:dirt泥土层，表层为雪
海滩minecraft:sand沙层
恶地minecraft:terracotta陶土层
沼泽minecraft:dirt泥土层，可能有黏土


Sea Floor Material（海床材料）​

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

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


JSON 示例：
方式 1：海床材料定义（仅名称）
JSON： 
"sea_floor_material": {
    "name": "minecraft:gravel"
}

方式 2：带状态的海床材料（数字值）
JSON： 
"sea_floor_material": {
    "name": "minecraft:stone",
    "states": {
        "stone_type": 0
    }
}

方式 3：带状态的海床材料（布尔值）
JSON： 
"sea_floor_material": {
    "name": "minecraft:sea_pickle",
    "states": {
        "waterlogged": true,
        "pickles": 4
    }
}

方式 4：带状态的海床材料（字符串值）
JSON： 
"sea_floor_material": {
    "name": "minecraft:concrete",
    "states": {
        "color": "blue"
    }
}

常见方块状态示例：
方块状态名类型示例值
minecraft:gravel--无状态
minecraft:sand--无状态
minecraft:stonestone_type字符串"stone", "granite", "diorite"
minecraft:sea_picklewaterlogged布尔值true, false
minecraft:sea_picklepickles整数1, 2, 3, 4
minecraft:concretecolor字符串"white", "blue", "red"
minecraft:coral_blockdead_bit布尔值true, false

注意事项：
  1. name 字段 — 必须使用有效的 Minecraft 方块 ID，格式为 namespace:block_name（如 minecraft:gravel）。
  2. states 字段 — 可选，用于指定方块的特殊状态。不是所有方块都有状态。
  3. 状态值类型 — 根据方块的不同，状态值可以是：
    • 布尔值：true / false
    • 整数：如 0, 1, 2, 3...
    • 字符串：如 "x", "y", "z", "red", "blue"...
  4. 状态验证 — 确保使用方块支持的有效状态名称和值，否则可能导致游戏崩溃或方块显示错误。
  5. 查询方块状态 — 可使用 F3 调试屏幕或游戏内命令查看方块的有效状态。
  6. 与地表构建器配合 — 在 minecraft:surface_builder 中使用海床材料定义时，可指定特定状态的方块以创建更丰富的水下地形效果。
  7. 海床材料用途 — 海床材料通常用于定义生物群系水体底部的主要方块，如沙砾、沙子、石头等。

完整地表构建器示例（使用海床材料）：
JSON： 
"minecraft:surface_builder": {
    "builder": {
        "type": "minecraft:overworld",
        "foundation_material": "minecraft:stone",
        "mid_material": "minecraft:dirt",
        "top_material": "minecraft:grass",
        "sea_floor_depth": 30,
        "sea_floor_material": {
            "name": "minecraft:gravel",
            "states": {}
        },
        "sea_material": "minecraft:water"
    }
}

地层结构中的海床材料位置：
代码： 
    ──────────────────────────────────────── 海平面
                    │  sea_material   │  ← 水体（水）
                    ├─────────────────┤
      ┌────────────►│sea_floor_material│  ← 海床（沙砾/沙子等）★ 此处
      │             │                 │
      │             │ foundation_     │  ← 基础层（石头等）
      │             │ material        │
      │             │                 │
      │             └─────────────────┘
      │
      └── 海床材料位于水体下方

常见海床材料选择：
生物群系类型推荐海床材料说明
海洋minecraft:gravel标准沙砾海床
深海minecraft:gravel沙砾海床，可能有海底遗迹
河流minecraft:gravel沙砾河床
海滩minecraft:sand沙质海床
热带海洋minecraft:sand沙质海床，可能有珊瑚
冰冻海洋minecraft:gravel沙砾海床，上方有冰
沼泽minecraft:clay黏土海床

海床装饰建议：
如果需要在水下添加装饰性方块（如海泡菜、珊瑚、海草等），可考虑：
  1. 使用对象格式指定状态 — 如 sea_pickle 的 pickles 状态控制数量。
  2. 配合其他组件 — 使用 minecraft:surface_material_adjustments 添加更精细的水下装饰。
  3. 考虑生物群系标签 — 使用 minecraft:tags 控制水下结构的生成。

Sea Material（海洋材料）​

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

海洋材料属性 (Sea Material Properties)​

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


JSON 示例：
方式 1：海洋材料定义（仅名称）
JSON： 
"sea_material": {
    "name": "minecraft:water"
}

方式 2：带状态的海洋材料（数字值）
JSON： 
"sea_material": {
    "name": "minecraft:water",
    "states": {
        "level": 0
    }
}

方式 3：带状态的海洋材料（布尔值）
JSON： 
"sea_material": {
    "name": "minecraft:flowing_water",
    "states": {
        "falling": true
    }
}

方式 4：带状态的海洋材料（字符串值）
JSON： 
"sea_material": {
    "name": "minecraft:water",
    "states": {
        "liquid_type": "water"
    }
}

常见方块状态示例：
方块状态名类型示例值
minecraft:waterlevel整数0 到 15（0=满，15=最低）
minecraft:waterliquid_type字符串"water"
minecraft:flowing_waterfalling布尔值true, false
minecraft:flowing_waterlevel整数0 到 15
minecraft:lavalevel整数0 到 15
minecraft:flowing_lavafalling布尔值true, false

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

完整地表构建器示例（使用海洋材料）：
JSON： 
"minecraft:surface_builder": {
    "builder": {
        "type": "minecraft:overworld",
        "foundation_material": "minecraft:stone",
        "mid_material": "minecraft:dirt",
        "top_material": "minecraft:grass",
        "sea_floor_depth": 30,
        "sea_floor_material": "minecraft:gravel",
        "sea_material": {
            "name": "minecraft:water",
            "states": {
                "level": 0
            }
        }
    }
}

地层结构中的海洋材料位置：
JSON： 
    ──────────────────────────────────────── 海平面
      ┌────────────►│  sea_material   │  ← 水体（水）★ 此处
      │             ├─────────────────┤
      │             │sea_floor_material│  ← 海床（沙砾/沙子等）
      │             │                 │
      │             │ foundation_     │  ← 基础层（石头等）
      │             │ material        │
      │             │                 │
      │             └─────────────────┘
      │
      └── 海洋材料填充海平面以下的水体空间

常见海洋材料选择：
生物群系类型推荐海洋材料说明
海洋/河流minecraft:water标准水体
下界minecraft:lava熔岩海
特殊维度minecraft:flowing_water流动水
特殊维度minecraft:flowing_lava流动熔岩

水体方块状态详解：
状态名类型说明有效值
level整数液体高度等级0（满）到 15（最低）
liquid_type字符串液体类型"water", "lava"
falling布尔值是否为下落液体true, false


Top Material（表层材料）​

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

表层材料属性 (Top Material Properties)​

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

​

类型选项 (Type Choices)​

值标题描述
minecraft:cappedMinecraft: 覆盖覆盖型地表构建器
minecraft:frozen_oceanMinecraft: 冰冻海洋冰冻海洋地表构建器
minecraft:mesaMinecraft: 恶地恶地地表构建器
minecraft:overworldMinecraft: 主世界主世界地表构建器
minecraft:swampMinecraft: 沼泽沼泽地表构建器
minecraft:the_endMinecraft: 末地末地地表构建器


JSON 示例：
方式 1：表层材料定义（仅名称）
JSON： 
"top_material": {
    "name": "minecraft:grass"
}

方式 2：带状态的表层材料（数字值）
JSON： 
"top_material": {
    "name": "minecraft:grass",
    "states": {
        "snowy": 0
    }
}

方式 3：带状态的表层材料（布尔值）
JSON： 
"top_material": {
    "name": "minecraft:grass",
    "states": {
        "snowy": false
    }
}

方式 4：带状态的表层材料（字符串值）
JSON： 
"top_material": {
    "name": "minecraft:grass",
    "states": {
        "variant": "normal"
    }
}

常见方块状态示例：
方块状态名类型示例值
minecraft:grasssnowy布尔值true, false
minecraft:dirtsnowy布尔值true, false
minecraft:sand--无状态
minecraft:stonestone_type字符串"stone", "granite", "diorite"
minecraft:terracotta--无状态
minecraft:concretecolor字符串"white", "blue", "red"
minecraft:woolcolor字符串"white", "blue", "red"

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

完整地表构建器示例（使用表层材料）：
JSON： 
"minecraft:surface_builder": {
    "builder": {
        "type": "minecraft:overworld",
        "foundation_material": "minecraft:stone",
        "mid_material": "minecraft:dirt",
        "top_material": {
            "name": "minecraft:grass",
            "states": {
                "snowy": false
            }
        },
        "sea_floor_depth": 30,
        "sea_floor_material": "minecraft:gravel",
        "sea_material": "minecraft:water"
    }
}

地层结构中的表层材料位置：
代码： 
      ┌────────────►│  top_material   │  ← 地表（草方块/沙子等）★ 此处
      │             ├─────────────────┤
      │             │  mid_material   │  ← 中层（泥土等）
      │             ├─────────────────┤
      │             │                 │
      │             │ foundation_     │  ← 基础层（石头等）
      │             │ material        │
      │             │                 │
      │             └─────────────────┘
      │
      └── 表层材料是玩家直接接触的最上层方块

常见表层材料选择：
生物群系类型推荐表层材料说明
平原/森林minecraft:grass标准草方块
沙漠minecraft:sand沙子
雪原minecraft:snow雪层
海滩minecraft:sand沙子
恶地minecraft:orange_terracotta橙色陶土
沼泽minecraft:grass草方块（可能有睡莲）
冰原minecraft:ice冰
下界minecraft:netherrack下界岩
末地minecraft:end_stone末地石

表层材料状态详解（草方块）：
状态名类型说明有效值
snowy布尔值是否被雪覆盖true, false
示例：
JSON： 
// 普通草方块
"top_material": {
    "name": "minecraft:grass",
    "states": {
        "snowy": false
    }
}

// 雪覆盖的草方块
"top_material": {
    "name": "minecraft:grass",
    "states": {
        "snowy": true
    }
}

不同地表构建器类型的表层材料建议：
构建器类型推荐表层材料特殊效果
minecraft:overworldminecraft:grass标准主世界地表
minecraft:frozen_oceanminecraft:grass自动生成冰山
minecraft:mesaminecraft:orange_terracotta彩色地层
minecraft:swampminecraft:grass自动生成睡莲
minecraft:capped自定义支持非固体方块上方生成
minecraft:the_endminecraft:end_stone末地风格


冰冻海洋生物群系 (Biome Frozen Ocean)​

类似于主世界地表构建器，但会自动生成冰山。

冰冻海洋生物群系属性 (Biome Frozen Ocean Properties)​

名称默认值类型描述示例值
foundation_material未设置字符串 (String)控制此生物群系地下深处使用的方块类型。"minecraft:stone"
foundation_material (备选方案 1)未设置基础材料项 (Foundation Material item)对象格式的基础材料定义（可包含方块状态）。见下方示例
mid_material未设置字符串 (String)控制此生物群系地表下方层使用的方块类型。"minecraft:dirt"
mid_material (备选方案 1)未设置中层材料项 (Mid Material item)对象格式的中层材料定义（可包含方块状态）。见下方示例
sea_floor_depth未设置整数 (Integer number)控制海床应出现在世界水位下方多深的位置。
注意：值必须 ≤ 127。		30, 50, 127
sea_floor_material未设置字符串 (String)控制此生物群系中水体底部使用的方块类型。"minecraft:gravel"
sea_floor_material (备选方案 1)未设置海床材料项 (Sea Floor Material item)对象格式的海床材料定义（可包含方块状态）。见下方示例
sea_material未设置字符串 (String)控制此生物群系中水体使用的方块类型。"minecraft:water"
sea_material (备选方案 1)未设置海洋材料项 (Sea Material item)对象格式的海洋材料定义（可包含方块状态）。见下方示例
top_material未设置字符串 (String)控制此生物群系地表使用的方块类型。"minecraft:grass"
top_material (备选方案 1)未设置表层材料项 (Top Material item)对象格式的表层材料定义（可包含方块状态）。见下方示例
type未设置类型选项 (Type choices)控制要使用的地表构建器类型。"minecraft:frozen_ocean"

​

类型选项 (Type Choices)​

值标题描述
minecraft:cappedMinecraft: 覆盖覆盖型地表构建器
minecraft:frozen_oceanMinecraft: 冰冻海洋冰冻海洋地表构建器
minecraft:mesaMinecraft: 恶地恶地地表构建器
minecraft:overworldMinecraft: 主世界主世界地表构建器
minecraft:swampMinecraft: 沼泽沼泽地表构建器
minecraft:the_endMinecraft: 末地末地地表构建器


JSON 示例：
方式 1：使用字符串格式（简洁）
JSON： 
"minecraft:surface_builder": {
    "builder": {
        "type": "minecraft:frozen_ocean",
        "foundation_material": "minecraft:stone",
        "mid_material": "minecraft:dirt",
        "top_material": "minecraft:grass",
        "sea_floor_depth": 30,
        "sea_floor_material": "minecraft:gravel",
        "sea_material": "minecraft:water"
    }
}

方式 2：使用对象格式（可指定方块状态）
代码： 
"minecraft:surface_builder": {
    "builder": {
        "type": "minecraft:frozen_ocean",
        "foundation_material": {
            "name": "minecraft:stone",
            "states": {}
        },
        "mid_material": {
            "name": "minecraft:dirt",
            "states": {
                "snowy": false
            }
        },
        "top_material": {
            "name": "minecraft:grass",
            "states": {
                "snowy": true
            }
        },
        "sea_floor_depth": 30,
        "sea_floor_material": {
            "name": "minecraft:gravel",
            "states": {}
        },
        "sea_material": {
            "name": "minecraft:water",
            "states": {
                "level": 0
            }
        }
    }
}

冰冻海洋特色效果：
特性说明
🧊 冰山生成自动在水面上生成冰山结构
❄️ 冰层覆盖水面可能生成浮冰
🌨️ 雪地地表地表材料通常配合雪层使用
🌊 深海床海床深度通常设置较深

地层结构示意：
代码： 
                    ┌─────────────────┐
                    │  top_material   │  ← 地表（草方块/雪层等）
                    ├─────────────────┤
                    │  mid_material   │  ← 中层（泥土等）
                    ├─────────────────┤
                    │                 │
                    │ foundation_     │  ← 基础层（石头等）
                    │ material        │
                    │                 │
    ────────────────┴─────────────────┴─────── 海平面
        🧊 🧊       │  sea_material   │  ← 水体（水）+ 冰山
        🧊 🧊       ├─────────────────┤
        🧊 🧊       │sea_floor_material│  ← 海床（沙砾等）
                    │                 │
                    ▼

注意事项：
  1. 类型字段 — type 必须设置为 "minecraft:frozen_ocean" 以启用冰冻海洋特性（包括冰山生成）。
  2. 冰山自动生成 — 使用此类型时，游戏会自动在水面上生成冰山结构，无需额外配置。
  3. 材料格式 — 所有材料字段支持两种格式：
    格式优点适用场景
    字符串简洁快速不需要方块状态时
    对象可指定方块状态需要控制方块变体时
  4. 深度限制 — sea_floor_depth 的值必须 ≤ 127。
  5. 地表材料建议 — 冰冻海洋生物群系通常使用雪层或冰作为地表材料：
    JSON： 
    "top_material": "minecraft:snow"
    或
    JSON： 
    "top_material": "minecraft:ice"
  6. 与主世界构建器对比 — 冰冻海洋构建器与主世界构建器的主要区别是自动冰山生成，其他属性基本相同。
  7. 水体结冰 — 在冰冻海洋中，水面可能会自然结冰，这是由生物群系的气候组件控制的。
冰冻海洋生物群系完整示例：
JSON： 
{
    "format_version": "1.20.0",
    "minecraft:biome": {
        "description": {
            "identifier": "myaddon:frozen_ocean"
        },
        "components": {
            "minecraft:climate": {
                "temperature": 0.0,
                "downfall": 0.5,
                "precipitation": "snow"
            },
            "minecraft:surface_builder": {
                "builder": {
                    "type": "minecraft:frozen_ocean",
                    "foundation_material": "minecraft:stone",
                    "mid_material": "minecraft:dirt",
                    "top_material": "minecraft:snow",
                    "sea_floor_depth": 40,
                    "sea_floor_material": "minecraft:gravel",
                    "sea_material": "minecraft:water"
                }
            }
        }
    }
}

常见冰冻海洋材料组合：
字段推荐值说明
type"minecraft:frozen_ocean"启用冰冻海洋特性
top_material"minecraft:snow" 或 "minecraft:ice"雪层或冰地表
mid_material"minecraft:dirt"标准泥土层
foundation_material"minecraft:stone"石头基础层
sea_material"minecraft:water"水体（水面会结冰）
sea_floor_material"minecraft:gravel"沙砾海床
sea_floor_depth40 - 60较深的海床


恶地生物群系 (Biome Mesa)​

类似于主世界地表构建器，但会添加彩色地层和可选的柱子。

恶地生物群系属性 (Biome Mesa Properties)​

名称默认值类型描述示例值
bryce_pillars未设置布尔值 (Boolean true/false)恶地是否生成柱子（布莱斯柱状结构）。true, false
clay_material未设置字符串 (String)使用的基础黏土方块。"minecraft:clay"
clay_material (备选方案 1)未设置黏土材料项 (Clay Material item)对象格式的黏土材料定义（可包含方块状态）。见下方示例
foundation_material未设置字符串 (String)控制此生物群系地下深处使用的方块类型。"minecraft:stone"
foundation_material (备选方案 1)未设置基础材料项 (Foundation Material item)对象格式的基础材料定义（可包含方块状态）。见下方示例
hard_clay_material未设置字符串 (String)使用的硬化黏土方块。"minecraft:hardened_clay"
hard_clay_material (备选方案 1)未设置硬黏土材料项 (Hard Clay Material item)对象格式的硬黏土材料定义（可包含方块状态）。见下方示例
has_forest未设置布尔值 (Boolean true/false)在高海拔处放置粗泥土和草。true, false
mid_material未设置字符串 (String)控制此生物群系地表下方层使用的方块类型。"minecraft:dirt"
mid_material (备选方案 1)未设置中层材料项 (Mid Material item)对象格式的中层材料定义（可包含方块状态）。见下方示例
sea_floor_depth未设置整数 (Integer number)控制海床应出现在世界水位下方多深的位置。
注意：值必须 ≤ 127。		30, 50, 127
sea_floor_material未设置字符串 (String)控制此生物群系中水体底部使用的方块类型。"minecraft:gravel"
sea_floor_material (备选方案 1)未设置海床材料项 (Sea Floor Material item)对象格式的海床材料定义（可包含方块状态）。见下方示例
sea_material未设置字符串 (String)控制此生物群系中水体使用的方块类型。"minecraft:water"
sea_material (备选方案 1)未设置海洋材料项 (Sea Material item)对象格式的海洋材料定义（可包含方块状态）。见下方示例
top_material未设置字符串 (String)控制此生物群系地表使用的方块类型。"minecraft:orange_terracotta"
top_material (备选方案 1)未设置表层材料项 (Top Material item)对象格式的表层材料定义（可包含方块状态）。见下方示例
type未设置类型选项 (Type choices)控制要使用的地表构建器类型。"minecraft:mesa"


JSON 示例：
方式 1：使用字符串格式（简洁）
JSON： 
"minecraft:surface_builder": {
    "builder": {
        "type": "minecraft:mesa",
        "bryce_pillars": true,
        "has_forest": false,
        "clay_material": "minecraft:clay",
        "hard_clay_material": "minecraft:hardened_clay",
        "foundation_material": "minecraft:stone",
        "mid_material": "minecraft:dirt",
        "top_material": "minecraft:orange_terracotta",
        "sea_floor_depth": 30,
        "sea_floor_material": "minecraft:gravel",
        "sea_material": "minecraft:water"
    }
}

方式 2：使用对象格式（可指定方块状态）
JSON： 
"minecraft:surface_builder": {
    "builder": {
        "type": "minecraft:mesa",
        "bryce_pillars": true,
        "has_forest": false,
        "clay_material": {
            "name": "minecraft:clay",
            "states": {}
        },
        "hard_clay_material": {
            "name": "minecraft:hardened_clay",
            "states": {}
        },
        "foundation_material": {
            "name": "minecraft:stone",
            "states": {}
        },
        "mid_material": {
            "name": "minecraft:dirt",
            "states": {
                "snowy": false
            }
        },
        "top_material": {
            "name": "minecraft:orange_terracotta",
            "states": {}
        },
        "sea_floor_depth": 30,
        "sea_floor_material": "minecraft:gravel",
        "sea_material": "minecraft:water"
    }
}

恶地特色效果：
特性说明
🎨 彩色地层自动生成多种颜色的陶土地层
🏛️ 布莱斯柱子可选的柱状岩石结构（类似美国布莱斯峡谷）
🌲 高原森林高海拔处可生成粗泥土和草
🏜️ 干旱地貌典型的干旱/半干旱地形特征

地层结构示意（恶地特色）：
代码： 
                    ┌─────────────────┐
                    │  top_material   │  ← 地表（橙色陶土等）
                    ├─────────────────┤
                    │  彩色陶土地层   │  ← 多层不同颜色的陶土
                    │  (自动多色)     │
                    ├─────────────────┤
                    │  mid_material   │  ← 中层（泥土等）
                    ├─────────────────┤
                    │                 │
                    │ foundation_     │  ← 基础层（石头等）
                    │ material        │
                    │                 │
                    └─────────────────┘
                    
        🏛️ 🏛️      ← 布莱斯柱子（如果启用）

恶地特有属性详解：
属性作用推荐值
bryce_pillars控制是否生成柱状岩石结构true（经典恶地）或 false（平坦恶地）
has_forest高海拔处是否生成粗泥土和草false（典型恶地）或 true（森林恶地变种）
clay_material基础黏土方块类型"minecraft:clay"
hard_clay_material硬化黏土方块类型"minecraft:hardened_clay" 或各种颜色的陶土

注意事项：
  1. 类型字段 — type 必须设置为 "minecraft:mesa" 以启用恶地特性（包括彩色地层）。
  2. 彩色地层自动生成 — 使用此类型时，游戏会自动生成多层不同颜色的陶土地层，无需手动配置每层颜色。
  3. 布莱斯柱子 — bryce_pillars: true 会生成类似美国布莱斯峡谷的柱状岩石结构，是恶地的标志性特征。
  4. 高原森林 — has_forest: true 会在高海拔处放置粗泥土和草，创建恶地森林变种。
  5. 材料格式 — 所有材料字段支持两种格式（字符串或对象）。
  6. 深度限制 — sea_floor_depth 的值必须 ≤ 127。
  7. 陶土颜色 — 虽然可以指定 clay_material 和 hard_clay_material，但彩色地层的具体颜色由游戏自动生成。
恶地生物群系完整示例：
JSON： 
{
    "format_version": "1.20.0",
    "minecraft:biome": {
        "description": {
            "identifier": "myaddon:mesa"
        },
        "components": {
            "minecraft:climate": {
                "temperature": 0.8,
                "downfall": 0.0,
                "precipitation": "none"
            },
            "minecraft:surface_builder": {
                "builder": {
                    "type": "minecraft:mesa",
                    "bryce_pillars": true,
                    "has_forest": false,
                    "clay_material": "minecraft:clay",
                    "hard_clay_material": "minecraft:hardened_clay",
                    "foundation_material": "minecraft:stone",
                    "mid_material": "minecraft:dirt",
                    "top_material": "minecraft:orange_terracotta",
                    "sea_floor_depth": 30,
                    "sea_floor_material": "minecraft:gravel",
                    "sea_material": "minecraft:water"
                }
            }
        }
    }
}

常见恶地材料组合：
字段推荐值说明
type"minecraft:mesa"启用恶地特性
bryce_pillarstrue生成柱状结构（经典恶地）
has_forestfalse无高原森林（典型恶地）
clay_material"minecraft:clay"基础黏土
hard_clay_material"minecraft:hardened_clay"硬化黏土/陶土
top_material"minecraft:orange_terracotta"橙色陶土地表
mid_material"minecraft:dirt"标准泥土层
foundation_material"minecraft:stone"石头基础层

恶地变种对比：
变种类型bryce_pillarshas_forest特点
经典恶地truefalse有柱子，无森林
平坦恶地falsefalse无柱子，无森林
森林恶地falsetrue无柱子，有高原森林
侵蚀恶地truetrue有柱子，有高原森林


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

最近话题

在线会员

当前在线： 221 （会员： 1, 游客： 220）
顶部 底部