MCreator 生物群系地面方块(Ground Block)参数详解:选材规则、生成原理与性能优化

原创2026-10-15 12:15:331,433 阅读
文章标签:低代码代码生成桌面应用游戏开发

MCreator 生物群系地面方块(Ground Block)参数详解:选材规则、生成原理与性能优化

在 MCreator 的 Biome(生物群系)元素中,"Ground block"(地面方块)是控制生物群系地表最顶层方块的核心参数,直接决定玩家踩在群系地面上看到的第一个方块是什么。本文基于 MCreator 官方帮助文档 ground_block.md 展开,并结合仓库中生物群系元素模型、GUI 绑定逻辑与 NeoForge 代码生成模板,完整讲解该参数的定位、默认值、与地下/水下方块的配合关系、底层 SurfaceRules 生成原理,以及"必须避开复杂方块"的性能原因。读完本文,你将能正确地为自己创建的每个生物群系选择地面方块,并理解选错方块会在世界生成与运行层面引发哪些问题。

一、参数定位:决定生物群系最顶层方块

在 MCreator 的生物群系编辑器界面中,该参数位于 Biome generation(群系生成) 选项卡,界面标签为 "Surface builder ground block",并带有一个帮助按钮,点击后会直接打开本文所对应的帮助文档(见 BiomeGUI.java 中 this.withEntry("biome/ground_block") 的绑定)。

在数据模型层面,该参数对应 Biome.java 中的字段:

@NonNullMappable("Blocks.GRASS") public MItemBlock groundBlock;

这里有两个值得注意的细节:

  • @NonNullMappable("Blocks.GRASS") 表示该字段不允许为空,默认值为 Blocks.GRASS(原版草方块);
  • GUI 侧同样通过 requireValue(...) 强制校验:如果用户未填写地面方块,编辑器会提示 elementgui.biome.error_biome_needs_ground_block 错误(见 BiomeGUI.java)。

也就是说,任何生物群系都必须明确指定一个地面方块,且该方块只能从方块类元素(ElementUtil::loadBlocks,即只能选方块、不能选物品)中选择。

与地下方块、水下方块的区别

理解 ground block 必须放到"地表三层方块"的上下文中看。Biome.java 中同时定义了三个相关字段:

字段 默认值 作用
groundBlock Blocks.GRASS 地表最顶层的方块,玩家脚踩的这一层
undergroundBlock Blocks.DIRT#0 地面方块之下的地下方块层
underwaterBlock(可选) 未设置时回退到 undergroundBlock 水下(且上方有空气判定时)使用的表层方块

其中 underwaterBlock 是可选的,Biome.getUnderwaterBlock() 在未设置时会自动回退为 undergroundBlock(见 Biome.java)。

二、选材基本准则:草方块优先,配合 minecraft:dirt 标签

帮助文档给出的第一原则非常明确:在大多数生物群系中,应使用原版或自定义的草方块。

  • 如果你创建的是普通的陆地生物群系(平原、森林、山地等),默认值 Blocks.GRASS 就是最合适的起点;
  • 如果你的群系需要特殊地表(例如自定义的苔藓、沙化、晶化地表),可以选择自定义方块,但必须满足下文第四节中的约束;
  • 无论选择哪种方块,都要求该方块被标记在 minecraft:dirt 方块标签(Block Tag) 中。这一要求在多个本地化语言文件中都被强调,例如 texts.properties 中英文文案为 "It should be tagged in minecraft:dirt Blocks tag. Avoid using complex blocks.",中文文案见 texts_zh_CN.properties。

为什么必须带 minecraft:dirt 标签?因为原版植物与树木生成逻辑依赖该标签来判断"哪些方块可以充当可生长的土壤"。如果地面方块不在该标签内,群系中的草、花、树将无法正常生成,甚至无法在世界中正确生成。

三、底层生成原理:SurfaceRules 如何把方块铺到地表

理解该参数"最终去哪了",需要看 NeoForge 生成器模板 biomes.java.ftl。MCreator 在生成模组代码时,会通过 FreeMarker 宏 mappedBlockToBlockStateCode(biome.groundBlock) 把工作区中选中的方块映射为原版 BlockState,再注入到生物群系的 SurfaceRules(地表规则)中。

对于主世界生物群系,模板生成 preliminarySurfaceRule(...)(第 238-256 行),其核心逻辑为:

SurfaceRules.ifTrue(SurfaceRules.isBiome(biomeKey),
    SurfaceRules.ifTrue(SurfaceRules.abovePreliminarySurface(),
        SurfaceRules.sequence(
            // 表层 0 格(无洞穴覆盖):
            SurfaceRules.ifTrue(SurfaceRules.stoneDepthCheck(0, false, 0, CaveSurface.FLOOR),
                SurfaceRules.sequence(
                    // 水位检查:上方有水时用 underwaterBlock,否则用 groundBlock
                    SurfaceRules.ifTrue(SurfaceRules.waterBlockCheck(-1, 0),
                        SurfaceRules.state(groundBlock)
                    ),
                    SurfaceRules.state(underwaterBlock)
                )
            ),
            // 表层之下 0 格起:
            SurfaceRules.ifTrue(SurfaceRules.stoneDepthCheck(0, true, 0, CaveSurface.FLOOR),
                SurfaceRules.state(undergroundBlock)
            )
        )
    )
);

这段代码清晰展示了三个方块的协作方式:

  1. stoneDepthCheck(0, false, 0, CaveSurface.FLOOR):距离地表第 0 格(即最顶层)时,先做 waterBlockCheck(-1, 0) 判断——若该位置上方有水源,则铺设 underwaterBlock,否则铺设 groundBlock;
  2. 距离地表超过 0 格(进入地下)后,统一铺设 undergroundBlock。

而对于洞穴群系与下界群系,模板使用 anySurfaceRule(...)(第 260-280 行),额外加入了纵向范围约束(yBlockCheck(VerticalAnchor.aboveBottom(5), 0) 与 not(yBlockCheck(belowTop(5), 0))),即只在接近地形表面、且不在世界最顶部 5 格和最底部 5 格的范围内应用自定义地表规则。注意:该规则仅在下界或洞穴群系存在时才会被生成。

此外,模板还会把自定义群系的地表规则以 SurfaceRules.sequence 方式插入到原版主世界/下界地表规则链的最前面(见 injectOverworldSurfaceRules / injectNetherSurfaceRules),并通过 modifyOverworldParameterPoints / modifyNetherParameterPoints 把群系的气候参数(温度、湿度等)接入原版群系选择系统。

由此可以得出结论:ground block 并不是一个简单的"贴皮"参数,而是直接参与世界地表规则生成的关键输入,它会按世界生成管线逐块(Block)判定铺设,因此其复杂度会直接影响世界生成的耗时。

四、必须避免的"复杂方块"清单及原因

帮助文档明确列出五类不应用作地面方块的方块。这些警告并非泛泛而谈,而是基于世界生成管线的实际开销,逐一说明如下:

  1. 透明方块(durchsichtige Blöcke / transparent blocks):透明方块会引入额外的渲染层与光照处理,且地表规则逐块铺设时若使用透明方块,可能破坏地下光照计算,增加区块生成开销并造成视觉异常;
  2. 非完整方块(不是完整立方体的方块):例如台阶、楼梯、栅栏、按钮、植物等。地表规则假设地表方块是一个完整实体,非完整方块会破坏地表连续性,并可能让 stoneDepthCheck 的层数判定失效;
  3. 带 Tile Entity、NBT 标签或自带背包的方块:这类方块每次生成都需要初始化附加数据(NBT、容器内容等),在世界生成时会产生大量额外对象创建与序列化开销;
  4. 被用作 POI(Points of Interest,兴趣点,如村庄房屋、村民工作站点)的方块:POI 方块会被原版寻路与村庄系统跟踪,若遍布整个群系地表,会严重拖慢实体寻路与区块加载;
  5. 带 Tick(方块刻/随机刻逻辑)的方块:这类方块每个游戏刻都会执行更新逻辑。若整个群系地表都是这类方块,每一刻都有海量方块需要计算,会直接造成明显的帧率下降(lag)。

文档同时给出后果说明:使用此类方块后,世界生成会变慢,且已加载的世界会出现严重卡顿。原因正如第三节所示——地表规则是逐方块执行的,一个群系范围内地表方块的数量可达数百万个,任何附加逻辑都会被放大到整个群系规模。

五、对群系预览图的影响

ground block 还会影响 MCreator 编辑器内生物群系元素的预览图。在 MinecraftImageGenerator.java 的 generateBiomePreviewPicture 中:

Color topColor;
if (groundBlock.getUnmappedValue().equals("Blocks.GRASS"))
    if (grassColor != null)
        topColor = grassColor;
    else
        topColor = new Color(0x35A351);
else
    topColor = groundColor;

即:当地面方块恰好是原版草方块(Blocks.GRASS)时,预览图顶部的"草色"会使用群系自定义的 grassColor(未设置时回退到默认绿色 0x35A351);若选择了其他方块,则直接取该方块材质的平均颜色作为地表颜色。这也侧面解释了为什么文档推荐默认使用草方块——它能让群系外观与自定义草色设置保持一致,视觉表现最自然。

六、实战检查清单

综合官方帮助文档与仓库源码,创建生物群系时请按以下清单自检:

  1. 地面方块必填:该参数不可为空,未填写时编辑器会阻止保存(requireValue 校验);
  2. 默认用草方块:绝大多数群系直接保留 Blocks.GRASS 即可;自定义地表时优先选择带 minecraft:dirt 标签的方块;
  3. 检查方块标签:在 MCreator 中确认所选方块已加入 minecraft:dirt 方块标签,否则植物与树无法正常生成;
  4. 避开五类复杂方块:透明、非完整、含 Tile Entity/NBT/背包、POI、带 Tick 的方块一律不要用;
  5. 与地下方块配套:groundBlock 与 undergroundBlock 相互配合形成地表剖面,通常草方块 + 泥土(Blocks.DIRT#0)是标准组合;
  6. 水下群系额外设置:若有水域,建议显式设置 underwaterBlock,否则会回退到地下方块(见 Biome.java);
  7. 预览图检查:保存前留意元素预览图,确认地表颜色符合预期(草方块时由 grassColor 驱动)。

遵循上述规则,你创建的生物群系既能拥有正确的地表外观,又不会因为复杂方块而拖慢世界生成与运行性能。相关帮助文档的配套说明可继续参考同目录下的 underground_block.md 与 underwater_block.md,它们与本文共同构成 MCreator 生物群系地表三要素(地面 / 地下 / 水下方块)的完整使用指南。

登录后查看全文
MCreator