上一篇：
下一篇：
回到二级页：点我跳转
回到总目录：点我跳转
文档原链接：点我跳转
本文内容
JSON 示例：
方式 1：黏土材料定义（仅名称）
方式 2：带状态的黏土材料（数字值）
方式 3：带状态的黏土材料（布尔值）
方式 4：带状态的黏土材料（字符串值）
常见黏土相关方块状态示例：
注意事项：
恶地地层结构中的黏土材料位置：
常见黏土材料选择：
恶地彩色地层提示：
虽然可以指定 clay_material，但恶地的彩色地层颜色主要由游戏自动生成，包括：
JSON 示例：
方式 1：硬黏土材料定义（仅名称）
方式 2：带状态的硬黏土材料（数字值）
方式 3：带状态的硬黏土材料（布尔值）
方式 4：带状态的硬黏土材料（字符串值）
常见硬黏土相关方块状态示例：
注意事项：
恶地地层结构中的硬黏土材料位置：
常见硬黏土材料选择：
恶地彩色地层中的硬黏土使用：
版本兼容性提示：
JSON 示例：
方式 1：使用字符串格式（简洁）
方式 2：使用对象格式（可指定方块状态）
沼泽特色效果：
地层结构示意：
沼泽特有属性详解：
注意事项：
常见沼泽材料组合：
JSON 示例：
方式 1：使用字符串格式（简洁）
方式 2：使用对象格式（可指定方块状态）
覆盖型构建器特色效果：
地层结构示意（覆盖型）：
覆盖型特有属性详解：
注意事项：
覆盖型生物群系完整示例：
常见覆盖型材料组合：
JSON 示例：
方式 1：海滩材料定义（仅名称）
方式 2：带状态的海滩材料（数字值）
方式 3：带状态的海滩材料（布尔值）
方式 4：带状态的海滩材料（字符串值）
常见海滩相关方块状态示例：
注意事项：
覆盖型地层结构中的海滩材料位置：
常见海滩材料选择：
海滩材料颜色选择（混凝土/羊毛）：
覆盖型生物群系完整示例（使用海滩材料）：
JSON 示例：
方式 1：天花板材料定义（仅名称）
方式 2：带状态的天花板材料（数字值）
方式 3：带状态的天花板材料（布尔值）
方式 4：带状态的天花板材料（字符串值）
方式 5：多种天花板材料（数组）
常见天花板相关方块状态示例：
注意事项：
覆盖型地层结构中的天花板材料位置：
常见天花板材料选择：
天花板材料效果对比：
覆盖型生物群系完整示例（使用天花板材料）：
JSON 示例：
方式 1：地面材料定义（仅名称）
方式 2：带状态的地面材料（数字值）
方式 3：带状态的地面材料（布尔值）
方式 4：带状态的地面材料（字符串值）
方式 5：多种地面材料（数组）
常见地面相关方块状态示例：
注意事项：
覆盖型地层结构中的地面材料位置：
常见地面材料选择：
地面材料效果对比：
覆盖型生物群系完整示例（使用地面材料）：
JSON 示例：
末地生物群系完整示例：
末地特色效果：
末地地形结构示意：
注意事项：
上一篇：
下一篇：
回到二级页：点我跳转
回到总目录：点我跳转
下一篇：
回到二级页：点我跳转
回到总目录：点我跳转
文档原链接：点我跳转
生物群系文档 - minecraft:surface_builder（地表构建器组件）
本文内容
- 黏土材料 (Clay Material)
- 硬黏土材料 (Hard Clay Material)
- 沼泽生物群系 (Biome Swamp)
- 覆盖生物群系 (Biome Capped)
- 海滩材料 (Beach Material)
- 天花板材料 (Ceiling Materials)
- 地面材料 (Floor Materials)
- 末地生物群系 (Biome The End)
Clay Material（黏土材料）
定义用于恶地生物群系地形生成的基础黏土方块类型及其状态属性。黏土材料属性 (Clay Material Properties)
| 名称 | 默认值 | 类型 | 描述 | 示例值 |
|---|---|---|---|---|
| name | 未设置 | 对象 (Object) | 方块的名称（方块 ID）。 | "minecraft:clay" |
| states | {} | 键控数字集合 (Keyed set of numbers) | 包含以每个状态命名的成员，值为布尔值、整数或字符串。 | 见下方示例 |
| states (备选方案 1) | 未设置 | 键控布尔值集合 (Keyed collection of boolean values) | 状态值为布尔值格式。 | 见下方示例 |
| states (备选方案 2) | 未设置 | 键控字符串集合 (Keyed set of strings) | 状态值为字符串格式。 | 见下方示例 |
JSON 示例：
方式 1：黏土材料定义（仅名称）
JSON：
"clay_material": {
"name": "minecraft:clay"
}方式 2：带状态的黏土材料（数字值）
JSON：
"clay_material": {
"name": "minecraft:clay",
"states": {
"variant": 0
}
}方式 3：带状态的黏土材料（布尔值）
JSON：
"clay_material": {
"name": "minecraft:clay",
"states": {
"waterlogged": false
}
}方式 4：带状态的黏土材料（字符串值）
JSON：
"clay_material": {
"name": "minecraft:terracotta",
"states": {
"color": "orange"
}
}常见黏土相关方块状态示例：
| 方块 | 状态名 | 类型 | 示例值 |
|---|---|---|---|
| minecraft:clay | - | - | 无状态 |
| minecraft:terracotta | - | - | 无状态 |
| minecraft:hardened_clay | - | - | 无状态 |
| minecraft:white_terracotta | - | - | 无状态 |
| minecraft:orange_terracotta | - | - | 无状态 |
| minecraft:concrete | color | 字符串 | "white", "orange", "blue" |
注意事项：
- name 字段 — 必须使用有效的 Minecraft 方块 ID，格式为 namespace:block_name（如 minecraft:clay）。
- states 字段 — 可选，用于指定方块的特殊状态。黏土类方块通常没有状态。
- 状态值类型 — 根据方块的不同，状态值可以是：
- 布尔值：true / false
- 整数：如 0, 1, 2, 3...
- 字符串：如 "x", "y", "z", "red", "blue"...
- 状态验证 — 确保使用方块支持的有效状态名称和值，否则可能导致游戏崩溃或方块显示错误。
- 查询方块状态 — 可使用 F3 调试屏幕或游戏内命令查看方块的有效状态。
- 与恶地构建器配合 — 在 minecraft:surface_builder 的恶地类型中使用黏土材料定义时，可指定特定类型的黏土或陶土方块。
- 黏土材料用途 — 黏土材料通常用于恶地生物群系中的基础黏土层，与硬化黏土材料配合创建彩色地层效果。
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": "minecraft:stone",
"mid_material": "minecraft:dirt",
"top_material": "minecraft:orange_terracotta",
"sea_floor_depth": 30,
"sea_floor_material": "minecraft:gravel",
"sea_material": "minecraft:water"
}
}恶地地层结构中的黏土材料位置：
代码：
┌─────────────────┐
│ top_material │ ← 地表（橙色陶土等）
├─────────────────┤
│ 彩色陶土地层 │ ← 多层不同颜色的陶土
│ (自动多色) │
├─────────────────┤
┌────────────►│ clay_material │ ← 基础黏土层 ★ 此处
│ ├─────────────────┤
│ │hard_clay_material│ ← 硬化黏土层
│ ├─────────────────┤
│ │ mid_material │ ← 中层（泥土等）
│ ├─────────────────┤
│ │ foundation_ │ ← 基础层（石头等）
│ │ material │
│ └─────────────────┘
│
└── 黏土材料位于彩色地层区域常见黏土材料选择：
| 方块 ID | 译法 | 适用场景 |
|---|---|---|
| minecraft:clay | 黏土块 | 标准黏土层 |
| minecraft:terracotta | 陶土 | 未染色陶土 |
| minecraft:hardened_clay | 硬化黏土 | 经典恶地材料 |
| minecraft:orange_terracotta | 橙色陶土 | 恶地地表 |
| minecraft:white_terracotta | 白色陶土 | 浅色地层 |
| minecraft:red_terracotta | 红色陶土 | 深色地层 |
恶地彩色地层提示：
虽然可以指定 clay_material，但恶地的彩色地层颜色主要由游戏自动生成，包括：
| 颜色 | 对应陶土 |
|---|---|
| 橙色 | orange_terracotta |
| 红色 | red_terracotta |
| 黄色 | yellow_terracotta |
| 白色 | white_terracotta |
| 棕色 | brown_terracotta |
| 黑色 | black_terracotta |
Hard Clay Material（硬黏土材料）
定义用于恶地生物群系地形生成的硬化黏土方块类型及其状态属性。硬黏土材料属性 (Hard Clay Material Properties)
| 名称 | 默认值 | 类型 | 描述 | 示例值 |
|---|---|---|---|---|
| name | 未设置 | 对象 (Object) | 方块的名称（方块 ID）。 | "minecraft:hardened_clay" |
| states | {} | 键控数字集合 (Keyed set of numbers) | 包含以每个状态命名的成员，值为布尔值、整数或字符串。 | 见下方示例 |
| states (备选方案 1) | 未设置 | 键控布尔值集合 (Keyed collection of boolean values) | 状态值为布尔值格式。 | 见下方示例 |
| states (备选方案 2) | 未设置 | 键控字符串集合 (Keyed set of strings) | 状态值为字符串格式。 | 见下方示例 |
类型选项 (Type Choices)
⚠️ 注意：此表格与硬黏土材料本身无直接关系，是地表构建器的类型选项，可能为文档结构重复。
| 值 | 标题 | 描述 |
|---|---|---|
| minecraft:capped | Minecraft: 覆盖 | 覆盖型地表构建器 |
| minecraft:frozen_ocean | Minecraft: 冰冻海洋 | 冰冻海洋地表构建器 |
| minecraft:mesa | Minecraft: 恶地 | 恶地地表构建器 |
| minecraft:overworld | Minecraft: 主世界 | 主世界地表构建器 |
| minecraft:swamp | Minecraft: 沼泽 | 沼泽地表构建器 |
| minecraft:the_end | Minecraft: 末地 | 末地地表构建器 |
JSON 示例：
方式 1：硬黏土材料定义（仅名称）
JSON：
"hard_clay_material": {
"name": "minecraft:hardened_clay"
}方式 2：带状态的硬黏土材料（数字值）
JSON：
"hard_clay_material": {
"name": "minecraft:terracotta",
"states": {
"variant": 0
}
}方式 3：带状态的硬黏土材料（布尔值）
JSON：
"hard_clay_material": {
"name": "minecraft:terracotta",
"states": {
"waterlogged": false
}
}方式 4：带状态的硬黏土材料（字符串值）
JSON：
"hard_clay_material": {
"name": "minecraft:orange_terracotta",
"states": {
"color": "orange"
}
}常见硬黏土相关方块状态示例：
| 方块 | 状态名 | 类型 | 示例值 |
|---|---|---|---|
| minecraft:hardened_clay | - | - | 无状态 |
| minecraft:terracotta | - | - | 无状态 |
| minecraft:orange_terracotta | - | - | 无状态 |
| minecraft:white_terracotta | - | - | 无状态 |
| minecraft:red_terracotta | - | - | 无状态 |
| minecraft:concrete | color | 字符串 | "white", "orange", "blue" |
注意事项：
- name 字段 — 必须使用有效的 Minecraft 方块 ID，格式为 namespace:block_name（如 minecraft:hardened_clay）。
- states 字段 — 可选，用于指定方块的特殊状态。硬化黏土/陶土类方块通常没有状态。
- 状态值类型 — 根据方块的不同，状态值可以是：
- 布尔值：true / false
- 整数：如 0, 1, 2, 3...
- 字符串：如 "x", "y", "z", "red", "blue"...
- 状态验证 — 确保使用方块支持的有效状态名称和值，否则可能导致游戏崩溃或方块显示错误。
- 查询方块状态 — 可使用 F3 调试屏幕或游戏内命令查看方块的有效状态。
- 与恶地构建器配合 — 在 minecraft:surface_builder 的恶地类型中使用硬黏土材料定义时，可指定特定类型的硬化黏土或陶土方块。
- 硬黏土材料用途 — 硬黏土材料通常用于恶地生物群系中的硬化黏土层，与基础黏土材料配合创建彩色地层效果。
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": "minecraft:stone",
"mid_material": "minecraft:dirt",
"top_material": "minecraft:orange_terracotta",
"sea_floor_depth": 30,
"sea_floor_material": "minecraft:gravel",
"sea_material": "minecraft:water"
}
}恶地地层结构中的硬黏土材料位置：
代码：
┌─────────────────┐
│ top_material │ ← 地表（橙色陶土等）
├─────────────────┤
│ 彩色陶土地层 │ ← 多层不同颜色的陶土
│ (自动多色) │
├─────────────────┤
┌────────────►│ clay_material │ ← 基础黏土层
│ ├─────────────────┤
│ │hard_clay_material│ ← 硬化黏土层 ★ 此处
│ ├─────────────────┤
│ │ mid_material │ ← 中层（泥土等）
│ ├─────────────────┤
│ │ foundation_ │ ← 基础层（石头等）
│ │ material │
│ └─────────────────┘
│
└── 硬黏土材料位于黏土层下方常见硬黏土材料选择：
| 方块 ID | 译法 | 适用场景 |
|---|---|---|
| minecraft:hardened_clay | 硬化黏土 | 经典恶地材料 |
| minecraft:terracotta | 陶土 | 未染色陶土 |
| minecraft:orange_terracotta | 橙色陶土 | 恶地地表 |
| minecraft:white_terracotta | 白色陶土 | 浅色地层 |
| minecraft:red_terracotta | 红色陶土 | 深色地层 |
| minecraft:yellow_terracotta | 黄色陶土 | 黄色地层 |
| minecraft:brown_terracotta | 棕色陶土 | 棕色地层 |
| minecraft:black_terracotta | 黑色陶土 | 黑色地层 |
恶地彩色地层中的硬黏土使用：
| 地层颜色 | 推荐硬黏土方块 |
|---|---|
| 橙色 | minecraft:orange_terracotta |
| 红色 | minecraft:red_terracotta |
| 黄色 | minecraft:yellow_terracotta |
| 白色 | minecraft:white_terracotta |
| 棕色 | minecraft:brown_terracotta |
| 黑色 | minecraft:black_terracotta |
| 灰色 | minecraft:gray_terracotta |
| 蓝色 | minecraft:blue_terracotta |
版本兼容性提示：
| Minecraft 版本 | 方块名称变化 |
|---|---|
| 1.12 之前 | stained_hardened_clay（染色硬化黏土） |
| 1.12+ | terracotta（陶土）+ 颜色前缀 |
| 当前版本 | minecraft:orange_terracotta 等 |
沼泽生物群系 (Biome Swamp)
用于在沼泽生物群系地表添加装饰，如睡莲。沼泽生物群系属性 (Biome Swamp Properties)
| 名称 | 默认值 | 类型 | 描述 | 示例值 |
|---|---|---|---|---|
| foundation_material | 未设置 | 字符串 (String) | 控制此生物群系地下深处使用的方块类型。 | "minecraft:stone" |
| foundation_material (备选方案 1) | 未设置 | 基础材料项 (Foundation Material item) | 对象格式的基础材料定义（可包含方块状态）。 | 见下方示例 |
| max_puddle_depth_below_sea_level | 未设置 | 整数 (Integer number) | 控制地表方块可被水替换形成水坑的深度。 该数字表示海平面下方要向下查找地表方块的方块数量（0 到 127）。 注意：值必须 ≤ 127。 | 10, 20, 50 |
| 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:swamp" |
类型选项 (Type Choices)
| 值 | 标题 | 描述 |
|---|---|---|
| minecraft:capped | Minecraft: 覆盖 | 覆盖型地表构建器 |
| minecraft:frozen_ocean | Minecraft: 冰冻海洋 | 冰冻海洋地表构建器 |
| minecraft:mesa | Minecraft: 恶地 | 恶地地表构建器 |
| minecraft:overworld | Minecraft: 主世界 | 主世界地表构建器 |
| minecraft:swamp | Minecraft: 沼泽 | 沼泽地表构建器 |
| minecraft:the_end | Minecraft: 末地 | 末地地表构建器 |
JSON 示例：
方式 1：使用字符串格式（简洁）
JSON：
"minecraft:surface_builder": {
"builder": {
"type": "minecraft:swamp",
"max_puddle_depth_below_sea_level": 20,
"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:swamp",
"max_puddle_depth_below_sea_level": 20,
"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│ ← 海床（沙砾/黏土等）
│ │
▼沼泽特有属性详解：
| 属性 | 作用 | 推荐值 |
|---|---|---|
| max_puddle_depth_below_sea_level | 控制水坑生成的最大深度 | 10 - 30（浅水坑）或 50+（深水坑） |
| type | 启用沼泽地表构建器特性 | "minecraft:swamp" |
注意事项：
- 类型字段 — type 必须设置为 "minecraft:swamp" 以启用沼泽特性（包括睡莲生成）。
- 水坑深度 — max_puddle_depth_below_sea_level 控制地表可形成水坑的最大深度：
值 效果 0 不生成水坑 10 - 20 浅水坑 30 - 50 中等深度水坑 50+ 深水坑 - 睡莲自动生成 — 使用此类型时，游戏会自动在水面上生成睡莲，无需额外配置。
- 材料格式 — 所有材料字段支持两种格式（字符串或对象）。
- 深度限制 — sea_floor_depth 和 max_puddle_depth_below_sea_level 的值都必须 ≤ 127。
- 沼泽植被 — 沼泽生物群系还会自动生成藤蔓、蘑菇、柳树等特有植被。
- 生物生成 — 配合 minecraft:tags 组件可控制青蛙、沼泽特有生物的生成。
JSON：
{
"format_version": "1.20.0",
"minecraft:biome": {
"description": {
"identifier": "myaddon:swamp"
},
"components": {
"minecraft:climate": {
"temperature": 0.5,
"downfall": 0.8,
"precipitation": "rain"
},
"minecraft:surface_builder": {
"builder": {
"type": "minecraft:swamp",
"max_puddle_depth_below_sea_level": 20,
"foundation_material": "minecraft:stone",
"mid_material": "minecraft:dirt",
"top_material": "minecraft:grass",
"sea_floor_depth": 30,
"sea_floor_material": "minecraft:clay",
"sea_material": "minecraft:water"
}
}
}
}
}常见沼泽材料组合：
| 字段 | 推荐值 | 说明 |
|---|---|---|
| type | "minecraft:swamp" | 启用沼泽特性 |
| max_puddle_depth_below_sea_level | 20 | 中等深度水坑 |
| top_material | "minecraft:grass" 或 "minecraft:mud" | 草地或泥巴地表 |
| mid_material | "minecraft:dirt" | 标准泥土层 |
| foundation_material | "minecraft:stone" | 石头基础层 |
| sea_material | "minecraft:water" | 水体 |
| sea_floor_material | "minecraft:clay" 或 "minecraft:gravel" | 黏土或沙砾海床 |
| sea_floor_depth | 30 - 40 | 中等深度海床 |
覆盖生物群系 (Biome Capped)
在上方或下方有非固体方块的方块上生成地表。覆盖生物群系属性 (Biome Capped Properties)
| 名称 | 默认值 | 类型 | 描述 | 示例值 |
|---|---|---|---|---|
| beach_material | 未设置 | 字符串 (String) | 用于装饰海平面附近地表的材料。 | "minecraft:sand" |
| beach_material (备选方案 1) | 未设置 | 海滩材料项 (Beach Material item) | 对象格式的海滩材料定义（可包含方块状态）。 | 见下方示例 |
| ceiling_materials | 未设置 | 字符串 (String) | 用于地表天花板的材料。 注意：数组必须至少有 1 项。 | "minecraft:stone" |
| ceiling_materials (备选方案 1) | 未设置 | 天花板材料项 (Ceiling Materials item) | 对象格式的天花板材料定义（可包含方块状态）。 | 见下方示例 |
| floor_materials | 未设置 | 字符串 (String) | 用于地表地面的材料。 注意：数组必须至少有 1 项。 | "minecraft:stone" |
| floor_materials (备选方案 1) | 未设置 | 地面材料项 (Floor Materials item) | 对象格式的地面材料定义（可包含方块状态）。 | 见下方示例 |
| foundation_material | 未设置 | 字符串 (String) | 用于替换非地表固体方块的材料。 | "minecraft:stone" |
| foundation_material (备选方案 1) | 未设置 | 基础材料项 (Foundation Material item) | 对象格式的基础材料定义（可包含方块状态）。 | 见下方示例 |
| sea_material | 未设置 | 字符串 (String) | 用于替换海平面以下空气方块的材料。 | "minecraft:water" |
| sea_material (备选方案 1) | 未设置 | 海洋材料项 (Sea Material item) | 对象格式的海洋材料定义（可包含方块状态）。 | 见下方示例 |
| type | 未设置 | 类型选项 (Type choices) | 控制要使用的地表构建器类型。 | "minecraft:capped" |
类型选项 (Type Choices)
| 值 | 标题 | 描述 |
|---|---|---|
| minecraft:capped | Minecraft: 覆盖 | 覆盖型地表构建器 |
| minecraft:frozen_ocean | Minecraft: 冰冻海洋 | 冰冻海洋地表构建器 |
| minecraft:mesa | Minecraft: 恶地 | 恶地地表构建器 |
| minecraft:overworld | Minecraft: 主世界 | 主世界地表构建器 |
| minecraft:swamp | Minecraft: 沼泽 | 沼泽地表构建器 |
| minecraft:the_end | Minecraft: 末地 | 末地地表构建器 |
JSON 示例：
方式 1：使用字符串格式（简洁）
JSON：
{
"format_version": "1.20.0",
"minecraft:biome": {
"description": {
"identifier": "myaddon:swamp"
},
"components": {
"minecraft:climate": {
"temperature": 0.5,
"downfall": 0.8,
"precipitation": "rain"
},
"minecraft:surface_builder": {
"builder": {
"type": "minecraft:swamp",
"max_puddle_depth_below_sea_level": 20,
"foundation_material": "minecraft:stone",
"mid_material": "minecraft:dirt",
"top_material": "minecraft:grass",
"sea_floor_depth": 30,
"sea_floor_material": "minecraft:clay",
"sea_material": "minecraft:water"
}
}
}
}
}方式 2：使用对象格式（可指定方块状态）
JSON：
"minecraft:surface_builder": {
"builder": {
"type": "minecraft:capped",
"beach_material": {
"name": "minecraft:sand",
"states": {}
},
"ceiling_materials": [
{
"name": "minecraft:stone",
"states": {}
}
],
"floor_materials": [
{
"name": "minecraft:stone",
"states": {}
}
],
"foundation_material": {
"name": "minecraft:stone",
"states": {}
},
"sea_material": {
"name": "minecraft:water",
"states": {
"level": 0
}
}
}
}覆盖型构建器特色效果：
| 特性 | 说明 |
|---|---|
| 🏗️ 非固体方块支持 | 可在非固体方块（如空气）上方或下方生成地表 |
| 🏖️ 海滩装饰 | 海平面附近可生成海滩材料装饰 |
| سقف 天花板材料 | 支持定义地表上方的天花板方块 |
| 🏠 地面材料 | 支持定义地表下方的地面方块 |
| 🌊 海平面填充 | 可填充海平面以下的空气方块 |
地层结构示意（覆盖型）：
代码：
┌─────────────────┐
│ceiling_materials│ ← 天花板材料
├─────────────────┤
🏖️ 🏖️ │ top_surface │ ← 地表表面
海滩区域 ├─────────────────┤
(海平面附近) │ floor_materials │ ← 地面材料
├─────────────────┤
│ foundation_ │ ← 基础材料
│ material │
│ │
────────────────┴─────────────────┴─────── 海平面
🌊 🌊 │ sea_material │ ← 海洋材料（填充空气）
│ │
▼覆盖型特有属性详解：
| 属性 | 作用 | 推荐值 |
|---|---|---|
| beach_material | 海平面附近的地表装饰材料 | "minecraft:sand" 或 "minecraft:gravel" |
| ceiling_materials | 地表上方的天花板方块（数组） | ["minecraft:stone"] |
| floor_materials | 地表下方的地面方块（数组） | ["minecraft:stone"] |
| foundation_material | 替换非地表固体方块的材料 | "minecraft:stone" |
| sea_material | 填充海平面以下空气的材料 | "minecraft:water" |
注意事项：
- 类型字段 — type 必须设置为 "minecraft:capped" 以启用覆盖型地表构建器。
- 数组要求 — ceiling_materials 和 floor_materials 必须是数组，且至少包含 1 项：
JSON：// ✅ 正确 "ceiling_materials": ["minecraft:stone"] // ❌ 错误（空数组） "ceiling_materials": [] - 非固体方块支持 — 覆盖型构建器的主要特点是可以在非固体方块（如空气、水）的上方或下方生成地表，适用于特殊地形生成场景。
- 材料格式 — 所有材料字段支持两种格式（字符串或对象）。
- 海滩材料 — beach_material 用于在海平面附近创建海滩过渡效果。
- 海平面填充 — sea_material 用于填充海平面以下的空气方块，通常设置为水。
- 适用场景— 覆盖型构建器适用于：
- 浮空岛屿
- 洞穴地形
- 特殊维度地形
- 自定义结构生成
覆盖型生物群系完整示例：
JSON：
{
"format_version": "1.20.0",
"minecraft:biome": {
"description": {
"identifier": "myaddon:capped_biome"
},
"components": {
"minecraft:climate": {
"temperature": 0.5,
"downfall": 0.5,
"precipitation": "rain"
},
"minecraft:surface_builder": {
"builder": {
"type": "minecraft:capped",
"beach_material": "minecraft:sand",
"ceiling_materials": [
"minecraft:stone"
],
"floor_materials": [
"minecraft:stone"
],
"foundation_material": "minecraft:stone",
"sea_material": "minecraft:water"
}
}
}
}
}常见覆盖型材料组合：
| 字段 | 推荐值 | 说明 |
|---|---|---|
| type | "minecraft:capped" | 启用覆盖型特性 |
| beach_material | "minecraft:sand" | 沙滩装饰 |
| ceiling_materials | ["minecraft:stone"] | 石头天花板 |
| floor_materials | ["minecraft:stone"] | 石头地面 |
| foundation_material | "minecraft:stone" | 石头基础 |
| sea_material | "minecraft:water" | 水体填充 |
Beach Material（海滩材料）
定义用于覆盖型生物群系地形生成的海滩装饰方块类型及其状态属性。海滩材料属性 (Beach Material Properties)
| 名称 | 默认值 | 类型 | 描述 | 示例值 |
|---|---|---|---|---|
| name | 未设置 | 对象 (Object) | 方块的名称（方块 ID）。 | "minecraft:sand" |
| states | {} | 键控数字集合 (Keyed set of numbers) | 包含以每个状态命名的成员，值为布尔值、整数或字符串。 | 见下方示例 |
| states (备选方案 1) | 未设置 | 键控布尔值集合 (Keyed collection of boolean values) | 状态值为布尔值格式。 | 见下方示例 |
| states (备选方案 2) | 未设置 | 键控字符串集合 (Keyed set of strings) | 状态值为字符串格式。 | 见下方示例 |
JSON 示例：
方式 1：海滩材料定义（仅名称）
JSON：
"beach_material": {
"name": "minecraft:sand"
}方式 2：带状态的海滩材料（数字值）
JSON：
"beach_material": {
"name": "minecraft:sand",
"states": {
"variant": 0
}
}方式 3：带状态的海滩材料（布尔值）
JSON：
"beach_material": {
"name": "minecraft:sand",
"states": {
"waterlogged": false
}
}方式 4：带状态的海滩材料（字符串值）
JSON：
"beach_material": {
"name": "minecraft:sand",
"states": {
"waterlogged": false
}
}常见海滩相关方块状态示例：
| 方块 | 状态名 | 类型 | 示例值 |
|---|---|---|---|
| minecraft:sand | - | - | 无状态 |
| minecraft:gravel | - | - | 无状态 |
| minecraft:concrete | color | 字符串 | "white", "yellow", "blue" |
| minecraft:wool | color | 字符串 | "white", "yellow", "blue" |
| minecraft:sea_pickle | waterlogged | 布尔值 | true, false |
| minecraft:sea_pickle | pickles | 整数 | 1, 2, 3, 4 |
注意事项：
- name 字段 — 必须使用有效的 Minecraft 方块 ID，格式为 namespace:block_name（如 minecraft:sand）。
- states 字段 — 可选，用于指定方块的特殊状态。沙滩类方块通常没有状态。
- 状态值类型 — 根据方块的不同，状态值可以是：
- 布尔值：true / false
- 整数：如 0, 1, 2, 3...
- 字符串：如 "x", "y", "z", "red", "blue"...
- 状态验证 — 确保使用方块支持的有效状态名称和值，否则可能导致游戏崩溃或方块显示错误。
- 查询方块状态 — 可使用 F3 调试屏幕或游戏内命令查看方块的有效状态。
- 与覆盖型构建器配合 — 在 minecraft:surface_builder 的覆盖型中使用海滩材料定义时，可指定特定类型的沙滩方块用于海平面附近的地表装饰。
- 海滩材料用途 — 海滩材料通常用于覆盖型生物群系中海平面附近的地表装饰，创建海滩过渡效果。
JSON：
"minecraft:surface_builder": {
"builder": {
"type": "minecraft:capped",
"beach_material": {
"name": "minecraft:sand",
"states": {}
},
"ceiling_materials": [
"minecraft:stone"
],
"floor_materials": [
"minecraft:stone"
],
"foundation_material": "minecraft:stone",
"sea_material": "minecraft:water"
}
}覆盖型地层结构中的海滩材料位置：
代码：
┌─────────────────┐
│ceiling_materials│ ← 天花板材料
├─────────────────┤
🏖️ 🏖️ │ top_surface │ ← 地表表面
海滩区域 ├─────────────────┤
(海平面附近) │ floor_materials │ ← 地面材料
├─────────────────┤
│ foundation_ │ ← 基础材料
│ material │
│ │
────────────────┴─────────────────┴─────── 海平面
🌊 🌊 │ sea_material │ ← 海洋材料
│ │
▼
↑
└── 海滩材料用于海平面附近的地表装饰常见海滩材料选择：
| 方块 ID | 译法 | 适用场景 |
|---|---|---|
| minecraft:sand | 沙子 | 标准沙滩 |
| minecraft:gravel | 沙砾 | 沙砾海滩 |
| minecraft:red_sand | 红沙 | 热带/特殊海滩 |
| minecraft:concrete | 混凝土 | 自定义颜色海滩 |
| minecraft:wool | 羊毛 | 装饰性海滩 |
| minecraft:terracotta | 陶土 | 特殊风格海滩 |
海滩材料颜色选择（混凝土/羊毛）：
| 颜色 | 方块 ID | 视觉效果 |
|---|---|---|
| 白色 | minecraft:white_concrete | 白沙海滩 |
| 黄色 | minecraft:yellow_concrete | 金色海滩 |
| 橙色 | minecraft:orange_concrete | 日落海滩 |
| 棕色 | minecraft:brown_concrete | 深色海滩 |
| 黑色 | minecraft:black_concrete | 黑沙海滩 |
| 蓝色 | minecraft:blue_concrete | 特殊装饰海滩 |
覆盖型生物群系完整示例（使用海滩材料）：
JSON：
{
"format_version": "1.20.0",
"minecraft:biome": {
"description": {
"identifier": "myaddon:capped_beach"
},
"components": {
"minecraft:climate": {
"temperature": 0.6,
"downfall": 0.5,
"precipitation": "rain"
},
"minecraft:surface_builder": {
"builder": {
"type": "minecraft:capped",
"beach_material": {
"name": "minecraft:sand",
"states": {}
},
"ceiling_materials": [
"minecraft:stone"
],
"floor_materials": [
"minecraft:stone"
],
"foundation_material": "minecraft:stone",
"sea_material": "minecraft:water"
}
}
}
}
}Ceiling Materials（天花板材料）
定义用于覆盖型生物群系地形生成的地表天花板方块类型及其状态属性。天花板材料属性 (Ceiling Materials 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：
"ceiling_materials": [
{
"name": "minecraft:stone"
}
]方式 2：带状态的天花板材料（数字值）
JSON：
"ceiling_materials": [
{
"name": "minecraft:stone",
"states": {
"stone_type": 0
}
}
]方式 3：带状态的天花板材料（布尔值）
JSON：
"ceiling_materials": [
{
"name": "minecraft:glowstone",
"states": {}
}
]方式 4：带状态的天花板材料（字符串值）
JSON：
"ceiling_materials": [
{
"name": "minecraft:concrete",
"states": {
"color": "gray"
}
}
]方式 5：多种天花板材料（数组）
JSON：
"ceiling_materials": [
{
"name": "minecraft:stone",
"states": {}
},
{
"name": "minecraft:cobblestone",
"states": {}
},
{
"name": "minecraft:glowstone",
"states": {}
}
]常见天花板相关方块状态示例：
| 方块 | 状态名 | 类型 | 示例值 |
|---|---|---|---|
| minecraft:stone | stone_type | 字符串 | "stone", "granite", "diorite" |
| minecraft:concrete | color | 字符串 | "white", "gray", "black" |
| minecraft:glowstone | - | - | 无状态（发光效果） |
| minecraft:sea_lantern | - | - | 无状态（发光效果） |
| minecraft:shroomlight | - | - | 无状态（发光效果） |
| minecraft:slime_block | - | - | 无状态（弹性效果） |
注意事项：
- name 字段 — 必须使用有效的 Minecraft 方块 ID，格式为 namespace:block_name（如 minecraft:stone）。
- states 字段 — 可选，用于指定方块的特殊状态。不是所有方块都有状态。
- 状态值类型— 根据方块的不同，状态值可以是：
- 布尔值：true / false
- 整数：如 0, 1, 2, 3...
- 字符串：如 "x", "y", "z", "red", "blue"...
- 状态验证 — 确保使用方块支持的有效状态名称和值，否则可能导致游戏崩溃或方块显示错误。
- 查询方块状态 — 可使用 F3 调试屏幕或游戏内命令查看方块的有效状态。
- 与覆盖型构建器配合 — 在 minecraft:surface_builder 的覆盖型中使用天花板材料定义时，可指定地表上方的天花板方块类型。
- 天花板材料用途 — 天花板材料通常用于覆盖型生物群系中地表上方的方块，适用于洞穴、浮空岛屿等特殊地形。
- 数组格式 — ceiling_materials 在 surface_builder 中是数组格式，可定义多种天花板材料。
JSON：
"minecraft:surface_builder": {
"builder": {
"type": "minecraft:capped",
"beach_material": "minecraft:sand",
"ceiling_materials": [
{
"name": "minecraft:stone",
"states": {}
},
{
"name": "minecraft:glowstone",
"states": {}
}
],
"floor_materials": [
"minecraft:stone"
],
"foundation_material": "minecraft:stone",
"sea_material": "minecraft:water"
}
}覆盖型地层结构中的天花板材料位置：
代码：
┌────────────►│ceiling_materials│ ← 天花板材料 ★ 此处
│ ├─────────────────┤
│ │ top_surface │ ← 地表表面
│ ├─────────────────┤
│ │ floor_materials │ ← 地面材料
│ ├─────────────────┤
│ │ foundation_ │ ← 基础材料
│ │ material │
│ └─────────────────┘
│
└── 天花板材料位于地表上方常见天花板材料选择：
| 方块 ID | 译法 | 适用场景 |
|---|---|---|
| minecraft:stone | 石头 | 标准洞穴天花板 |
| minecraft:cobblestone | 圆石 | 粗糙天花板 |
| minecraft:glowstone | 荧石 | 发光天花板 |
| minecraft:sea_lantern | 海晶灯 | 发光天花板 |
| minecraft:shroomlight | 菌光体 | 发光天花板 |
| minecraft:concrete | 混凝土 | 自定义颜色天花板 |
| minecraft:glass | 玻璃 | 透明天花板 |
| minecraft:bedrock | 基岩 | 不可破坏天花板 |
天花板材料效果对比：
| 材料类型 | 视觉效果 | 功能特点 |
|---|---|---|
| 石头/圆石 | 自然洞穴风格 | 标准天花板材料 |
| 荧石/海晶灯 | 发光效果 | 提供照明 |
| 菌光体 | 暖色发光 | 下界风格照明 |
| 玻璃 | 透明效果 | 可见上方空间 |
| 混凝土 | 自定义颜色 | 装饰性天花板 |
| 基岩 | 不可破坏 | 世界边界天花板 |
覆盖型生物群系完整示例（使用天花板材料）：
JSON：
{
"format_version": "1.20.0",
"minecraft:biome": {
"description": {
"identifier": "myaddon:capped_cave"
},
"components": {
"minecraft:climate": {
"temperature": 0.5,
"downfall": 0.5,
"precipitation": "rain"
},
"minecraft:surface_builder": {
"builder": {
"type": "minecraft:capped",
"beach_material": "minecraft:sand",
"ceiling_materials": [
{
"name": "minecraft:stone",
"states": {}
},
{
"name": "minecraft:glowstone",
"states": {}
}
],
"floor_materials": [
{
"name": "minecraft:stone",
"states": {}
}
],
"foundation_material": "minecraft:stone",
"sea_material": "minecraft:water"
}
}
}
}
}Floor Materials（地面材料）
定义用于覆盖型生物群系地形生成的地表地面方块类型及其状态属性。地面材料属性 (Floor Materials Properties)
| 名称 | 默认值 | 类型 | 描述 | 示例值 |
|---|---|---|---|---|
| name | 未设置 | 对象 (Object) | 方块的名称（方块 ID）。 | "minecraft:stone" |
| states | {} | 键控数字集合 (Keyed set of numbers) | 包含以每个状态命名的成员，值为布尔值、整数或字符串。 | 见下方示例 |
| states (备选方案 1) | 未设置 | 键控布尔值集合 (Keyed collection of boolean values) | 状态值为布尔值格式。 | 见下方示例 |
| states (备选方案 2) | 未设置 | 键控字符串集合 (Keyed set of strings) | 状态值为字符串格式。 | 见下方示例 |
类型选项 (Type Choices)
⚠️ 注意：此表格与地面材料本身无直接关系，是地表构建器的类型选项，可能为文档结构重复。
| 值 | 标题 | 描述 |
|---|---|---|
| minecraft:capped | Minecraft: 覆盖 | 覆盖型地表构建器 |
| minecraft:frozen_ocean | Minecraft: 冰冻海洋 | 冰冻海洋地表构建器 |
| minecraft:mesa | Minecraft: 恶地 | 恶地地表构建器 |
| minecraft:overworld | Minecraft: 主世界 | 主世界地表构建器 |
| minecraft:swamp | Minecraft: 沼泽 | 沼泽地表构建器 |
| minecraft:the_end | Minecraft: 末地 | 末地地表构建器 |
JSON 示例：
方式 1：地面材料定义（仅名称）
JSON：
"floor_materials": [
{
"name": "minecraft:stone"
}
]方式 2：带状态的地面材料（数字值）
JSON：
"floor_materials": [
{
"name": "minecraft:stone",
"states": {
"stone_type": 0
}
}
]方式 3：带状态的地面材料（布尔值）
JSON：
"floor_materials": [
{
"name": "minecraft:magma",
"states": {}
}
]方式 4：带状态的地面材料（字符串值）
JSON：
"floor_materials": [
{
"name": "minecraft:concrete",
"states": {
"color": "gray"
}
}
]方式 5：多种地面材料（数组）
JSON：
"floor_materials": [
{
"name": "minecraft:stone",
"states": {}
},
{
"name": "minecraft:cobblestone",
"states": {}
},
{
"name": "minecraft:magma",
"states": {}
}
]常见地面相关方块状态示例：
| 方块 | 状态名 | 类型 | 示例值 |
|---|---|---|---|
| minecraft:stone | stone_type | 字符串 | "stone", "granite", "diorite" |
| minecraft:concrete | color | 字符串 | "white", "gray", "black" |
| minecraft:magma | - | - | 无状态（伤害效果） |
| minecraft:soul_sand | - | - | 无状态（减速效果） |
| minecraft:slime_block | - | - | 无状态（弹性效果） |
| minecraft:ice | - | - | 无状态（滑动效果） |
注意事项：
- name 字段 — 必须使用有效的 Minecraft 方块 ID，格式为 namespace:block_name（如 minecraft:stone）。
- states 字段 — 可选，用于指定方块的特殊状态。不是所有方块都有状态。
- 状态值类型 — 根据方块的不同，状态值可以是：
- 布尔值：true / false
- 整数：如 0, 1, 2, 3...
- 字符串：如 "x", "y", "z", "red", "blue"...
- 状态验证 — 确保使用方块支持的有效状态名称和值，否则可能导致游戏崩溃或方块显示错误。
- 查询方块状态 — 可使用 F3 调试屏幕或游戏内命令查看方块的有效状态。
- 与覆盖型构建器配合 — 在 minecraft:surface_builder 的覆盖型中使用地面材料定义时，可指定地表下方的地面方块类型。
- 地面材料用途 — 地面材料通常用于覆盖型生物群系中地表下方的方块，适用于洞穴、浮空岛屿等特殊地形。
- 数组格式 — floor_materials 在 surface_builder 中是数组格式，可定义多种地面材料。
- 数组要求 — floor_materials 必须至少包含 1 项，不能为空数组。
JSON：
"minecraft:surface_builder": {
"builder": {
"type": "minecraft:capped",
"beach_material": "minecraft:sand",
"ceiling_materials": [
{
"name": "minecraft:stone",
"states": {}
}
],
"floor_materials": [
{
"name": "minecraft:stone",
"states": {}
},
{
"name": "minecraft:magma",
"states": {}
}
],
"foundation_material": "minecraft:stone",
"sea_material": "minecraft:water"
}
}覆盖型地层结构中的地面材料位置：
代码：
┌─────────────────┐
│ceiling_materials│ ← 天花板材料
├─────────────────┤
│ top_surface │ ← 地表表面
├─────────────────┤
┌────────────►│ floor_materials │ ← 地面材料 ★ 此处
│ ├─────────────────┤
│ │ foundation_ │ ← 基础材料
│ │ material │
│ └─────────────────┘
│
└── 地面材料位于地表下方常见地面材料选择：
| 方块 ID | 译法 | 适用场景 |
|---|---|---|
| minecraft:stone | 石头 | 标准洞穴地面 |
| minecraft:cobblestone | 圆石 | 粗糙地面 |
| minecraft:magma | 岩浆块 | 伤害地面（下界风格） |
| minecraft:soul_sand | 灵魂沙 | 减速地面（下界风格） |
| minecraft:slime_block | 黏液块 | 弹跳地面 |
| minecraft:ice | 冰 | 滑动地面 |
| minecraft:concrete | 混凝土 | 自定义颜色地面 |
| minecraft:bedrock | 基岩 | 不可破坏地面 |
地面材料效果对比：
| 材料类型 | 视觉效果 | 功能特点 |
|---|---|---|
| 石头/圆石 | 自然洞穴风格 | 标准地面材料 |
| 岩浆块 | 橙红色发光 | 对玩家造成伤害 |
| 灵魂沙 | 深色纹理 | 减速玩家移动 |
| 黏液块 | 绿色透明 | 玩家弹跳效果 |
| 冰 | 透明滑动 | 玩家滑动效果 |
| 混凝土 | 自定义颜色 | 装饰性地面 |
| 基岩 | 黑色纹理 | 不可破坏地面 |
覆盖型生物群系完整示例（使用地面材料）：
JSON：
{
"format_version": "1.20.0",
"minecraft:biome": {
"description": {
"identifier": "myaddon:capped_cave"
},
"components": {
"minecraft:climate": {
"temperature": 0.5,
"downfall": 0.5,
"precipitation": "rain"
},
"minecraft:surface_builder": {
"builder": {
"type": "minecraft:capped",
"beach_material": "minecraft:sand",
"ceiling_materials": [
{
"name": "minecraft:stone",
"states": {}
},
{
"name": "minecraft:glowstone",
"states": {}
}
],
"floor_materials": [
{
"name": "minecraft:stone",
"states": {}
},
{
"name": "minecraft:magma",
"states": {}
}
],
"foundation_material": "minecraft:stone",
"sea_material": "minecraft:water"
}
}
}
}
}末地生物群系 (Biome The End)
将生物群系标记为使用末地维度地形生成。具有此组件的生物群系将使用典型的末地地形风格，包括末地石和虚空生成。末地生物群系属性 (Biome The End Properties)
| 名称 | 默认值 | 类型 | 描述 | 示例值 |
|---|---|---|---|---|
| type | 未设置 | 类型选项 (Type choices) | 使用默认 Minecraft 末地地形生成。 | "minecraft:the_end" |
类型选项 (Type Choices)
| 值 | 标题 | 描述 |
|---|---|---|
| minecraft:capped | Minecraft: 覆盖 | 覆盖型地表构建器 |
| minecraft:frozen_ocean | Minecraft: 冰冻海洋 | 冰冻海洋地表构建器 |
| minecraft:mesa | Minecraft: 恶地 | 恶地地表构建器 |
| minecraft:overworld | Minecraft: 主世界 | 主世界地表构建器 |
| minecraft:swamp | Minecraft: 沼泽 | 沼泽地表构建器 |
| minecraft:the_end | Minecraft: 末地 | 末地地表构建器 |
JSON 示例：
JSON：
"minecraft:surface_builder": {
"builder": {
"type": "minecraft:the_end"
}
}末地生物群系完整示例：
JSON：
{
"format_version": "1.20.0",
"minecraft:biome": {
"description": {
"identifier": "myaddon:the_end"
},
"components": {
"minecraft:climate": {
"temperature": 0.5,
"downfall": 0.0,
"precipitation": "none"
},
"minecraft:surface_builder": {
"builder": {
"type": "minecraft:the_end"
}
}
}
}
}末地特色效果：
| 特性 | 说明 |
|---|---|
| 🪨 末地石地形 | 自动生成末地石为主要地表方块 |
| 🕳️ 虚空生成 | 地形周围生成虚空区域 |
| 🏝️ 浮空岛屿 | 典型的末地浮空岛屿风格 |
| 🌑 黑暗天空 | 末地特有的黑暗天空效果 |
| 🐉 末影龙栖息地 | 适合末影龙等末地生物生成 |
末地地形结构示意：
代码：
┌─────────────────┐
│ 末地主岛 │ ← 中央岛屿（黑曜石柱）
├─────────────────┤
│ │
🏝️ 🏝️ │ 浮空岛屿 │ ← 外围浮空岛屿
🏝️ 🏝️ │ │
│ │
──────────────────────────────────────── 虚空边界
│ │
│ 虚空 │ ← 无尽虚空
│ │
▼注意事项：
- 类型字段 — type 必须设置为 "minecraft:the_end" 以启用末地地形生成特性。
- 简化配置 — 末地构建器是最简单的地表构建器类型，通常只需要设置 type 字段即可。
- 末地石自动生成 — 使用此类型时，游戏会自动使用末地石作为主要地表方块，无需手动配置材料。
- 虚空生成 — 末地构建器会自动在地形边缘生成虚空，这是末地的标志性特征。
- 维度限制 — 此构建器类型专为末地维度设计，在主世界或下界使用可能产生意外效果。
- 生物生成 — 配合 minecraft:tags 组件可控制末影人、末影龙等末地特有生物的生成。
- 结构生成 — 末地构建器支持末地城、末地船等末地特有结构的生成。
上一篇：
下一篇：
回到二级页：点我跳转
回到总目录：点我跳转
