MCreator 生物群系地面方块(Ground Block)参数详解:选材规则、生成原理与性能优化
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)
)
)
)
);
这段代码清晰展示了三个方块的协作方式:
stoneDepthCheck(0, false, 0, CaveSurface.FLOOR):距离地表第 0 格(即最顶层)时,先做waterBlockCheck(-1, 0)判断——若该位置上方有水源,则铺设underwaterBlock,否则铺设groundBlock;- 距离地表超过 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)判定铺设,因此其复杂度会直接影响世界生成的耗时。
四、必须避免的"复杂方块"清单及原因
帮助文档明确列出五类不应用作地面方块的方块。这些警告并非泛泛而谈,而是基于世界生成管线的实际开销,逐一说明如下:
- 透明方块(durchsichtige Blöcke / transparent blocks):透明方块会引入额外的渲染层与光照处理,且地表规则逐块铺设时若使用透明方块,可能破坏地下光照计算,增加区块生成开销并造成视觉异常;
- 非完整方块(不是完整立方体的方块):例如台阶、楼梯、栅栏、按钮、植物等。地表规则假设地表方块是一个完整实体,非完整方块会破坏地表连续性,并可能让
stoneDepthCheck的层数判定失效; - 带 Tile Entity、NBT 标签或自带背包的方块:这类方块每次生成都需要初始化附加数据(NBT、容器内容等),在世界生成时会产生大量额外对象创建与序列化开销;
- 被用作 POI(Points of Interest,兴趣点,如村庄房屋、村民工作站点)的方块:POI 方块会被原版寻路与村庄系统跟踪,若遍布整个群系地表,会严重拖慢实体寻路与区块加载;
- 带 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);若选择了其他方块,则直接取该方块材质的平均颜色作为地表颜色。这也侧面解释了为什么文档推荐默认使用草方块——它能让群系外观与自定义草色设置保持一致,视觉表现最自然。
六、实战检查清单
综合官方帮助文档与仓库源码,创建生物群系时请按以下清单自检:
- 地面方块必填:该参数不可为空,未填写时编辑器会阻止保存(
requireValue校验); - 默认用草方块:绝大多数群系直接保留
Blocks.GRASS即可;自定义地表时优先选择带minecraft:dirt标签的方块; - 检查方块标签:在 MCreator 中确认所选方块已加入
minecraft:dirt方块标签,否则植物与树无法正常生成; - 避开五类复杂方块:透明、非完整、含 Tile Entity/NBT/背包、POI、带 Tick 的方块一律不要用;
- 与地下方块配套:
groundBlock与undergroundBlock相互配合形成地表剖面,通常草方块 + 泥土(Blocks.DIRT#0)是标准组合; - 水下群系额外设置:若有水域,建议显式设置
underwaterBlock,否则会回退到地下方块(见 Biome.java); - 预览图检查:保存前留意元素预览图,确认地表颜色符合预期(草方块时由 grassColor 驱动)。
遵循上述规则,你创建的生物群系既能拥有正确的地表外观,又不会因为复杂方块而拖慢世界生成与运行性能。相关帮助文档的配套说明可继续参考同目录下的 underground_block.md 与 underwater_block.md,它们与本文共同构成 MCreator 生物群系地表三要素(地面 / 地下 / 水下方块)的完整使用指南。