MCreator Bedrock 生物群系 ground_block 参数详解：surface_builder 顶部物块的选取原则与生成性能边界-北京尧图网络

低代码代码生成桌面应用游戏开发【免费下载链接】MCreatorMCreator is an open-source software used to make Minecraft Java Edition mods, Minecraft Bedrock Edition Add-Ons, resource packs, and data packs using an intuitive easy-to-learn interface or with an integrated code editor. It is used worldwide by Minecraft players, aspiring mod developers, for education, online classes, and STEM workshops.项目地址https://gitcode.com/gh_mirrors/mc/MCreator点击查看免费下载本文基于 MCreator 中 Bedrock 版Add-On生物群系元素BEBiome的官方帮助文档 ground_block.md讲清ground_block地表顶层物块这一参数的作用、它在 MCreator 编辑器中的定义方式、最终如何被生成模板写入 Bedrock 的minecraft:surface_builder组件以及为什么该位置严禁使用透明、带 Tile Entity、会 tick 等复杂物块。读完后你可以安全地为自定义生物群系配置地表物块组合并理解从 GUI 到生成 JSON 的完整映射链路。参数定义ground_block 控制的是生物群系最顶层的物块帮助文档对该参数的原始定义非常直接This parameter controls the block on the top layer of the biome.该参数控制生物群系最顶层的物块 Generally, vanilla or custom grass is used here for most biomes.大多数生物群系此处使用原版或自定义的草方块从 MCreator 源码结构看这个“最顶层物块”对应的正是 Bedrock 生物群系 JSON 中minecraft:surface_builder组件的top_material字段。在 Bedrock 的世界生成worldgen流程中surface builder 负责决定地表三层结构top_material最顶层即本文的ground_block文档原文称“top layer of the biome”mid_material表层之下的一层对应 MCreator 的 middle_block.md 文档foundation_material底层即underground_block。在数据模型层BEBiome.java 中三个表层物块字段被标注为NonNullMappable即“必填且可映射为 Bedrock 注册名”其默认值分别是NonNullMappable(Blocks.GRASS) public MItemBlock topMaterial; // ground_block默认草方块 NonNullMappable(Blocks.DIRT#0) public MItemBlock midMaterial; // middle_block默认泥土 NonNullMappable(Blocks.STONE#0)public MItemBlock foundationMaterial; // underground_block默认石头也就是说一个“标准”Bedrock 生物群系的默认地表组合就是grass表层 dirt中层 stone底层这与原文档“大多数生物群系使用原版或自定义草方块”的建议完全一致。GUI 层的定义必填项、默认值与帮助入口在 Bedrock 生物群系编辑界面 BEBiomeGUI.java 中topMaterial被初始化为一个“必须选中值”的MCItemHoldertopMaterial new MCItemHolder(mcreator, ElementUtil::loadBlocks).requireValue( elementgui.biome.error_biome_needs_ground_block);这里有两点值得注意ElementUtil::loadBlocks限定了可选范围选择器只会加载“方块”类元素不会列出物品从源头上保证填入的是合法方块.requireValue(...)使其成为校验项。该错误文案在 texts.properties 中定义为Biome needs a ground block生物群系需要一个 ground block。三个表层物块含ground_block都被注册进了同一校验组BEBiomeGUI.java若ground_block为空保存时会被拦截。新建生物群系时GUI 会自动填入默认组合BEBiomeGUI.javaif (!isEditingMode()) { topMaterial.setBlock(new MItemBlock(mcreator.getWorkspace(), Blocks.GRASS)); midMaterial.setBlock(new MItemBlock(mcreator.getWorkspace(), Blocks.DIRT#0)); foundationMaterial.setBlock(new MItemBlock(mcreator.getWorkspace(), Blocks.STONE#0)); }界面标签与帮助按钮的绑定在 BEBiomeGUI.javamaterialsPanel.add(HelpUtils.wrapWithHelpButton(this.withEntry(bebiome/ground_block), L10N.label(elementgui.bebiome.ground_block)));其中withEntry(bebiome/ground_block)正是本文所依据的帮助文档 ground_block.md 的挂载点界面标签 texts.properties 的英文原文为 “Surface builder ground block: Avoid using complex blocks”与文档核心告诫一致。此外该参数还参与生物群系预览图的生成——BEBiome.java 中generateModElementPicture()会用topMaterial与foundationMaterial渲染元素缩略图即你在元素列表里看到的地表纹理正是由ground_block决定的。生成链路ground_block 如何变成 surface_builder 的 top_materialMCreator 生成 Bedrock Add-On 时topMaterial会被写入服务端生物群系文件。生成规则由 bebiome.definition.yaml 声明输出到 Add-On 的biomes/registryname.json核心模板 biome.json.ftl 中的 surface builder 片段如下minecraft:surface_builder: { builder: { type: minecraft:overworld, top_material: ${mappedMCItemToRegistryNameNoTags(data.topMaterial)}, mid_material: ${mappedMCItemToRegistryNameNoTags(data.midMaterial)}, foundation_material: ${mappedMCItemToRegistryNameNoTags(data.foundationMaterial)}, sea_floor_material: ${mappedMCItemToRegistryNameNoTags(data.getUnderwaterBlock())}, sea_material: ${mappedMCItemToRegistryNameNoTags(data.getOceanBlock())}, sea_floor_depth: ${data.seaFloorDepth} } }物块名称的转换由 mcitems.ftl 中的mappedMCItemToRegistryNameNoTags函数完成从源码看其映射规则为原版方块补全命名空间输出minecraft:grass这类带前缀的注册名自定义方块CUSTOM:前缀输出${modid}:注册名即你在 MCreator 中定义的方块块标签block tag一律降级为minecraft:air。这一点很关键——与部分 Java 版生成器不同Bedrock 的 surface builder 物块位置不接受标签因此ground_block处选择标签类条目最终会被替换为空气等于地表留空。实操中应直接选择具体方块。为什么必须避免复杂物块原文档的完整告诫帮助文档 ground_block.md 明确列出了五类应避免用作地表顶层物块的情况以下完整继承原文Avoid using complex blocks such as:transparent blocks透明方块blocks that are not full cube非完整方块的方块blocks with tile entity, NBT tags, or inventory带 Tile Entity、NBT 标签或容器的方块blocks that are used as POI用作 POI 的方块blocks that tick会 tick 的方块If you use such blocks, the worldgen will be slow and the loaded world may lag severely.如果使用了这类方块世界生成会变慢加载后的世界可能出现严重卡顿逐条对照 surface builder 的工作方式可以理解其危害透明 / 非完整方块顶层物块本应是地表“皮肤”。透明或非实心方块如玻璃、地毯类、台阶会破坏地表视觉与光照/遮挡面的常规假设且生成器无法保证其在边界噪声插值处的连续性带 Tile Entity / NBT / 容器的方块如箱子、营火等实体方块。surface builder 在整片区块尺度上批量铺设物块每多一个 Tile Entity 就多一份额外数据与同步开销且这些方块通常依赖额外 NBT 才能表现正常直接铺在地表会出现行为异常用作 POI 的方块床、灵魂营火、制图师工作台等 POI 方块被世界生成器特殊索引和寻路系统引用大面积铺设会造成定位系统负担会 tick 的方块如活塞、红石元件、会随时间变化的方块。地表是玩家视野内密度最高的方块层tick 类方块在此处意味着每个区块持续消耗 tick 预算是卡顿的主要来源。文档给出的结论很明确使用此类方块会同时拖慢世界生成速度和运行时的加载性能“worldgen will be slow and the loaded world may lag severely”。这是对该参数最核心的性能边界约束与mid_material、foundation_material位置同理——middle_block.md 给出了完全相同的告诫。实操建议与默认组合综合原文档与源码证据为ground_block选块可遵循以下清单检查项建议方块类型优先原版或自定义的“草类”全实心方块如Blocks.GRASS默认值透明度避免透明 / 半透明方块形状必须为 full cube完整方块Tile Entity避免带 Tile Entity、NBT、容器的方块POI避免床、灵魂营火等 POI 方块tick 行为避免会持续 tick 的方块块标签不要选择 block tag否则生成时会被 mappedMCItemToRegistryNameNoTags 降级为minecraft:air若不做任何修改MCreator 会使用grass dirt stone的默认组合BEBiome.java这一组合即为原文档所称的“大多数生物群系”的通用方案也是新手的稳妥起点。相关源码与文档索引参数帮助文档本文主体ground_block.md相邻参数文档middle_block.md数据模型与默认值BEBiome.java编辑器界面、校验与帮助入口BEBiomeGUI.java生成模板与 surface_builder 输出biome.json.ftl物块注册名映射函数mcitems.ftl界面文案英文原文texts.properties赞分享低代码代码生成桌面应用游戏开发【免费下载链接】MCreatorMCreator is an open-source software used to make Minecraft Java Edition mods, Minecraft Bedrock Edition Add-Ons, resource packs, and data packs using an intuitive easy-to-learn interface or with an integrated code editor. It is used worldwide by Minecraft players, aspiring mod developers, for education, online classes, and STEM workshops.项目地址https://gitcode.com/gh_mirrors/mc/MCreator点击查看免费下载相关推荐MCreator 生物群系地面方块Ground Block参数详解选材规则、生成原理与性能优化MCreator 生物群系地面方块Ground Block参数详解选材规则、生成原理与性能优化在 MCreator 的 Biome生物群系元素中低代码代码生成桌面应用游戏开发MCreator Bedrock 生物群系生成替换biome_replacements参数详解从 GUI 到 minecraft:replace_biomes JSONMCreator Bedrock 生物群系生成替换biome_replacements参数详解从 GUI 到 minecraft:replace_biom低代码代码生成桌面应用游戏开发MCreator Bedrock 生物群系生成实战biome_replacement_freq_scale 噪声频率缩放参数详解MCreator Bedrock 生物群系生成实战biome_replacement_freq_scale 噪声频率缩放参数详解本文聚焦 MCreator低代码代码生成桌面应用游戏开发上一篇ECC 规则库中的 PHP 架构模式薄控制器、DTO 与依赖边界工程实践下一篇openai-agents-python 输出 Schema 机制完全指南AgentOutputSchema 与 AgentOutputSchemaBase 深入解析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

MCreator Bedrock 生物群系 ground_block 参数详解：surface_builder 顶部物块的选取原则与生成性能边界

相关推荐

F3D 轻量级3D查看器：3 秒打开多格式模型的开源桌面方案

一条命令、三个模型文件：DeepFilterNet ONNX 导出与多端部署实践

YOLOv8鸡蛋检测系统：从数据集制作到Web部署全流程

更多资讯

大模型生产级后训练：从微调到可落地的流水线

生产级后训练实战：从数据准备到模型部署的完整指南

Muse Code新计划解读：本地AI辅助编码与批量任务实践指南

AI应用工程化实践：从模型选型、本地部署到批量任务落地

VC++ 通过 USB 直连 GT800 打印 ZPL 标签：通道选型、指令拼装与避坑指南

WPE封包全套实战：从Winsock Hook到封包修改重放指南

今日更新

NetSpot 实战：用信道分析与频宽优化解决 Wi-Fi 卡顿

C++ split() 字符串分割的五种实现与性能实测

R语言坐标轴范围设置：从xlim/ylim到coord_cartesian的完整指南

本周精选

交通拥堵预测毕设：基于Python+LSTM的车辆流量预测系统全流程解析

MATLAB/Simulink搭建10机39节点电力系统暂态稳定仿真实战

无人机航拍三维重建全流程：从SfM到网格生成的避坑指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？