MCreator 生物群系树叶颜色(Foliage Color)参数详解:从界面配置到数据包 JSON 生成

原创2026-10-16 19:52:401,818 阅读
文章标签:桌面应用游戏开发代码生成低代码开发工具模板引擎

MCreator 生物群系树叶颜色(Foliage Color)参数详解:从界面配置到数据包 JSON 生成

MCreator 的生物群系(Biome)编辑器中提供了一组颜色参数,用于控制自定义生物群系的环境色调。本文聚焦其中的 树叶颜色(Foliage Color) 参数:它决定该生物群系中树叶(leaves)等植被的着色。本文将结合 MCreator 仓库中的 GUI 源码、数据模型与生成器模板,完整讲解该参数的作用范围、配置方式、底层存储结构,以及最终如何被写入 Minecraft 数据包 JSON,帮助你打造色调统一、视觉自然的自定义生物群系。

参数的作用:控制生物群系内树叶的颜色

根据 MCreator 内置帮助文档 foliage_color.md 的定义:

This parameter controls the color of the foliage (leaves) in this biome.

即:该参数控制当前生物群系中树叶(foliage / leaves)的颜色。它是 MCreator 生物群系颜色体系中的一员,与草色(grass_color)、天空色(air_color)、雾色(fog_color)、水色(water_color)、水下雾色(water_fog_color)共同决定群系的整体视觉观感。

需要特别注意的是:在默认情况下(未开启自定义颜色时),生物群系会使用原版 Minecraft 的通用颜色逻辑,树叶颜色会随温度/湿度等气候参数产生生物群系特有的渐变(例如丛林偏深绿、桦木林偏黄绿)。而启用本参数后,该群系内的树叶将被固定为你指定的颜色。

在编辑器中如何配置

界面入口

在 MCreator 中打开生物群系编辑器,进入「通用属性(General properties)」页面,即可看到一组颜色选择器。树叶颜色对应的界面标签在简体中文语言包中定义为 elementgui.biome.foliage_color=树叶颜色:(见 texts_zh_CN.properties)。

从 GUI 源码 BiomeGUI.java 可以看到,树叶颜色选择器通过 withEntry("biome/foliage_color") 将帮助按钮挂接到本文档条目,并作为 JColor 组件添加到「通用属性」面板中:

sbbp4.add(HelpUtils.wrapWithHelpButton(this.withEntry("biome/foliage_color"),
        L10N.label("elementgui.biome.foliage_color")));
sbbp4.add(foliageColor);

颜色选择器的交互细节

树叶颜色控件在 BiomeGUI.java 中与其他颜色控件一同声明:

private final JColor airColor = new JColor(mcreator, true, false);
private final JColor fogColor = new JColor(mcreator, true, false);
private final JColor grassColor = new JColor(mcreator, true, false);
private final JColor foliageColor = new JColor(mcreator, true, false);
private final JColor dryFoliageColor = new JColor(mcreator, true, false);
private final JColor waterColor = new JColor(mcreator, true, false);
private final JColor waterFogColor = new JColor(mcreator, true, false);

由 JColor.java 的实现可知,该组件提供以下交互能力:

  • 点击弹出系统颜色选择对话框,选择后以 #RRGGBB 十六进制格式显示当前颜色(如 #9E814D);
  • 通过 setColor(null) 可清空颜色,即"不设置该参数",此时生成器会回退到默认值;
  • 颜色文本前景色会根据背景亮度自动在黑白间切换,保证可读性。

编辑完成后,控件颜色通过 biome.foliageColor = foliageColor.getColor() 保存到数据模型(见 BiomeGUI.java),打开既有生物群系时则通过 foliageColor.setColor(biome.foliageColor) 回填(见 BiomeGUI.java)。

源码中的数据模型

树叶颜色在数据模型类 Biome.java 中被定义为可空颜色字段:

@Nullable public Color foliageColor;
  • @Nullable 表示该字段允许为空:用户未设置时,值为 null;
  • 该字段会被 GSON 序列化保存到工作区的 .mcreator 模型文件中,是整个颜色体系(airColor、fogColor、grassColor、foliageColor、dryFoliageColor、waterColor、waterFogColor)中的一员;
  • 由于所有颜色字段在默认构造器中均未被显式初始化,新建生物群系的树叶颜色默认为 null(即不设置)。

这也解释了帮助文档 colors.md 的表述——"该参数为你的生物群系启用自定义颜色",各颜色字段在置空时均可回退到原版默认着色逻辑。

生成器如何将颜色写入数据包 JSON

颜色配置最终会被 FreeMarker 模板转换为 Minecraft 数据包中生物群系的 effects.foliage_color 字段。MCreator 同时维护 1.21.1 与 26.3.x 两套生成器,二者的处理逻辑略有差异。

1.21.1 数据包生成器

在 biome.json.ftl 中:

"foliage_color": ${data.foliageColor?has_content?then(data.foliageColor.getRGB(), 10387789)},

即:若用户设置了颜色,则输出该颜色的十进制 RGB 值;否则输出默认值 10387789(即十六进制 #9E814D,一种偏黄的浅绿色)。其他颜色参数也遵循同样的"有值取值、无值用默认"策略,例如草色默认 9470285(#90814D)、水色默认 4159204、水下雾色默认 329011。

26.3.x 数据包生成器

在 biome.json.ftl 中,树叶颜色逻辑相同,同时新增了**干树叶颜色(dry foliage)**的条件输出:

"foliage_color": ${data.foliageColor?has_content?then(data.foliageColor.getRGB(), 10387789)},
"grass_color": ${data.grassColor?has_content?then(data.grassColor.getRGB(), 9470285)},
"water_color": ${data.waterColor?has_content?then(data.waterColor.getRGB(), 4159204)}
<#if data.dryFoliageColor?has_content>, "dry_foliage_color": ${data.dryFoliageColor.getRGB()}</#if>

关键差异点:

  • 树叶/草/水色:未设置时输出 MCreator 预设默认值;
  • 干树叶颜色(dry_foliage_color):仅在用户显式设置时输出,未设置则整个字段都不出现在 JSON 中(对应帮助文档 dry_foliage_color.md 所述的"枯叶/落叶层"着色)。

与其他颜色参数的关系与联动

理解树叶颜色,还需理清它与相邻参数的区别与联动:

参数 帮助文档 作用对象
树叶颜色 foliage_color.md 树叶(leaves)
草色 grass_color.md 草方块;同时也会改变其他植物(foliage)的颜色
干树叶颜色 dry_foliage_color.md 枯叶/落叶层(26.3.x 起支持)

尤其值得注意 grass_color.md 中的补充说明:草色参数"同样会改变其他植物(foliage)的颜色"。因此在设计群系色调时,草色与树叶色会共同影响植被观感,二者需协同调整,否则可能出现"草绿树黄"的割裂效果。

此外,从生成器模板 block.java.ftl 与 plant.java.ftl 可以看到,方块/植物支持 Default foliage、Birch foliage、Spruce foliage、Dry foliage 等染色(tint)类型——其中使用 foliage 系染色类型的方块,其渲染着色正是由生物群系的树叶颜色决定的。这意味着树叶颜色不仅作用于自然生成的树叶,还会影响你放置在改群系中的、使用了 foliage 染色类型的自定义方块与植物,从而实现全局一致的植被配色。

实战建议与注意事项

  1. 参考原版群系取色:默认值 #9E814D 是偏黄的暖绿色,适合温带平原;若做丛林类群系可向深绿(如 #2E8B57 附近)调整,桦木林可用更亮的黄绿。调色时可同时微调草色与树叶色,保持二者色相接近、明度略有层次。
  2. 善用"不设置"回退:若只想微调局部效果,可将树叶颜色留空,让生成器使用默认值,避免颜色字段与后续版本的原版着色逻辑冲突。
  3. 注意版本差异:干树叶颜色(dry_foliage_color)仅在 26.3.x 生成器中输出,1.21.1 生成器的 biome.json.ftl 不会生成该字段;跨版本迁移项目时需留意。
  4. 联动自定义方块:如果你的自定义方块/植物选择了 "Default foliage" 等 foliage 染色类型,请到对应群系中实测着色效果,确保树叶颜色参数与方块 tint 设置搭配合理。

通过以上配置与原理,你可以在 MCreator 中精准控制自定义生物群系的植被色调,并结合草色、干树叶色与 foliage 染色方块,构建出视觉统一、风格鲜明的自然环境。

登录后查看全文
MCreator