MCreator 生物群系水雾颜色（Water Fog Color）参数详解：从界面配置到数据包 JSON 生成原理-北京尧图网络

低代码代码生成桌面应用游戏开发【免费下载链接】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点击查看免费下载水雾颜色Water Fog Color是 MCreator 生物群系Biome元素中用于控制水下视野氛围的核心视觉参数。本文将围绕该参数完整说明它在 MCreator 编辑器中的配置入口、与水体颜色Water Color等相近参数的区分、在数据包与模组代码中的实际落地方式以及 Java 版不同生成器版本之间的写法差异帮助读者在制作自定义生物群系时精准调出水体内部的环境色调。一、参数是什么一句话定位water_fog_color水雾颜色控制的是生物群系内水雾的颜色——即玩家浸入水中、被水体包围时透过水面看到的雾气色调。这一概念在原文档中有明确表述德语de_DEDieser Parameter steuert die Farbe des Wassernebels im Biom简体中文zh_CN此参数控制该生物群系内水雾的颜色默认英文default / en_GBThis parameter controls the color of the water fog inside the biome简言之它是一个纯视觉visual参数不改变水的材质与透明度只改变玩家位于水中时所看到的水体雾气颜色用于营造不同水质下的沉浸感——例如深海偏暗蓝、沼泽偏浑浊绿。二、在 MCreator 界面中的配置入口在 MCreator 中打开生物群系元素的图形化编辑界面后水雾颜色与天空颜色、雾颜色、草颜色、树叶颜色、水体颜色一同排列在视觉参数区。其 UI 侧实现位于 BiomeGUI.javasbbp4.add(HelpUtils.wrapWithHelpButton(this.withEntry(biome/water_fog_color), L10N.label(elementgui.biome.water_fog_color))); sbbp4.add(waterFogColor);其中waterFogColor是一个颜色选择控件JColorprivate final JColor waterFogColor new JColor(mcreator, true, false);两个要点帮助按钮每个颜色参数前都有带问号的帮助按钮点击后即会弹出本文所依据的这份帮助文档biome/water_fog_color条目对应 water_fog_color.md 这一系列多语言文档。读写绑定编辑器打开既有生物群系时调用waterFogColor.setColor(biome.waterFogColor)BiomeGUI.java把已存颜色回填到控件保存时通过biome.waterFogColor waterFogColor.getColor()BiomeGUI.java写回数据模型。颜色选择器支持透明度JColor(mcreator, true, false)的第一个true参数但实际生成时对颜色值有专门处理详见下文“生成逻辑”。三、与相近参数的区别生物群系视觉参数组里有一组容易混淆的颜色需要区分清楚。它们全部定义在数据模型 Biome.java 中字段控制内容说明airColor天空颜色sky_color天空穹顶的主色调fogColor雾颜色fog_color地面/空中远处的雾气颜色waterColor水体颜色water_color水的表面着色waterFogColor水雾颜色water_fog_color水下雾气/水下视野色调grassColor草颜色grass_color草地色foliageColor树叶颜色foliage_color树木叶片色核心区别水面之上看远处是fogColor潜入水中看周围是waterFogColor。两者数值上常常不同——经典海洋群系天空雾偏浅、水雾偏深蓝才能形成“水面上下两重天”的观感。从源码结构看二者都是可空的颜色字段Nullable public Color即不配置时交由生成器填充默认值。四、从数据模型到 JSON 的生成链路4.1 数据模型的存储生物群系的水雾颜色在数据层是一个可空nullable的 JavaColor对象位于 Biome.javaNullable public Color waterFogColor;可空意味着用户可以在 GUI 中留空不设置。此时生成模板会回退到 Minecraft 原版的默认水雾颜色329011即十六进制0x050533等价于 RGB(5, 5, 51) 的深蓝。4.2 Java 版 1.21.1 数据包生成MCreator 的生物群系数据包 JSON 由 FreeMarker 模板 plugins/generator-1.21.1/datapack-1.21.1/templates/biome/biome.json.ftl 渲染视觉参数集中在effects块中foliage_color: ${data.foliageColor?has_content?then(data.foliageColor.getRGB(), 10387789)}, grass_color: ${data.grassColor?has_content?then(data.grassColor.getRGB(), 9470285)}, sky_color: ${data.airColor?has_content?then(data.airColor.getRGB(), 7972607)}, fog_color: ${data.fogColor?has_content?then(data.fogColor.getRGB(), 12638463)}, water_color: ${data.waterColor?has_content?then(data.waterColor.getRGB(), 4159204)}, water_fog_color: ${data.waterFogColor?has_content?then(data.waterFogColor.getRGB(), 329011)}这条water_fog_color行就是本文主题参数的最终产物其取值逻辑可拆解为已设置data.waterFogColor.getRGB()——把 GUI 选中的 JavaColor对象转换成 RGB 整数值0xRRGGBB写入 JSON未设置3290110x050533——沿用原版默认深蓝水雾。该数据包模板通过 neoforge-1.21.1/biome.definition.yaml 注册到 NeoForge 生成器并输出到MODDATAROOT/worldgen/biome/registryname.json。4.3 新版本26.3.x生成器的写法差异在新一代生成器 plugins/generator-26.3.x/datapack-26.3.x/templates/biome/biome.json.ftl 中生物群系 JSON 结构升级为命名空间键形式水雾颜色写作minecraft:visual/water_fog_color: ${data.waterFogColor?has_content?then(data.waterFogColor.getRGB(), 329011)},与之并列的还有minecraft:visual/sky_color与minecraft:visual/fog_color且这两者在 26.3.x 模板中同样仅在字段有内容时才输出。但默认值逻辑完全一致未配置时同样回退到3290110x050533。因此无论使用哪一代生成器留空水雾颜色都会得到原版一致的深蓝水下雾气。4.4 生成器默认值速查综合两代模板water_fog_color相关数值如下十进制为模板内实际写入值参数未配置默认值十进制十六进制备注water_fog_color3290110x050533RGB(5,5,51)原版默认深蓝水雾water_color41592040x3F76E4原版默认水体蓝五、基岩版Bedrock Edition的水雾颜色该视觉参数并非 Java 版独有。基岩版生物群系数据模型 BEBiome.java 同样声明了Nullable public Color waterFogColor并且public boolean hasVisualSettings() { return fogColor ! null || waterFogColor ! null; }从源码结构看waterFogColor与fogColor一起构成了基岩版生物群系的“可视设置”判定条件——当用户在基岩版生物群系中配置了任一颜色时该生物群系即被视为带有自定义视觉外观从而触发相应颜色信息的写入。六、测试与验证仓库的集成测试数据提供器为生物群系注入了确定性的水雾颜色用于验证生成与保存链路Java 版生物群系biome.waterFogColor Color.cyan;TestWorkspaceDataProvider.java基岩版生物群系bebiome.waterFogColor Color.cyan;TestWorkspaceDataProvider.java以青色cyan作为测试值配合上述 JSON 模板的getRGB()输出逻辑可在集成测试中检验水雾颜色从 UI 模型到生成产物全链路的正确性。七、实战建议先确定水体主色再定水雾色通常waterColor定水面观感waterFogColor定水下观感。建议两者同色系、深度拉开层次避免水下出现与水面严重割裂的色差。水下氛围优先用色值说话深海 / 寒带生物群系可偏向0x050533这类深蓝热带浅海可偏向偏青的浅蓝沼泽可尝试偏绿调以表现浑浊水质。留空即用原版默认如果不需要特殊水下氛围直接留空该颜色即可生成器会自动写入3290110x050533与 Minecraft 原版行为完全一致。注意新旧生成器的键名差异1.21.1 产物中是effects.water_fog_color26.3.x 产物中是minecraft:visual/water_fog_color直接阅读或手改生成 JSON 时务必区分。八、小结water_fog_color水雾颜色是 MCreator 生物群系元素中一个“小却关键”的视觉参数负责水下雾气色调。它的完整链路是GUI 颜色控件BiomeGUI.java→ 数据模型可空字段Biome.java→ FreeMarker 模板渲染biome.json.ftl未配置时回退到原版默认值3290110x050533。掌握该参数后你可以在自定义生物群系中轻松还原深海、沼泽、热带浅海等不同水质下的沉浸式水下视野。赞分享低代码代码生成桌面应用游戏开发【免费下载链接】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 生物群系草颜色Grass Color参数详解从界面设置到代码生成全流程MCreator 生物群系草颜色Grass Color参数详解从界面设置到代码生成全流程本篇指南围绕 MCreator 生物群系Biome元素中的低代码代码生成桌面应用游戏开发MCreator 生物群系 water_color 参数详解从编辑器取色到生成世界的水色MCreator 生物群系 water_color 参数详解从编辑器取色到生成世界的水色本文以 MCreator 本地化帮助文档 water_color.m低代码代码生成桌面应用游戏开发MCreator 生物群系自定义树的果实方块参数详解从界面配置到代码生成原理MCreator 生物群系自定义树的果实方块参数详解从界面配置到代码生成原理本文讲解 MCreator 生物群系Biome定义中的果实方块Frui低代码代码生成桌面应用游戏开发上一篇Jellyfin ThePornDB 插件安装与配置从零开始的完整指南下一篇穿越机总在抖用 PIDtoolbox 把黑盒日志变成调参结论创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

MCreator 生物群系水雾颜色（Water Fog Color）参数详解：从界面配置到数据包 JSON 生成原理

相关推荐

Argos Translate离线翻译排错全手册

基于ODConv动态卷积的YOLO26小目标检测与多尺度感知改进

Buzz 完整指南：5 分钟搭起本地离线语音转文字工作流

更多资讯

AI影片制作全流程拆解：从分镜脚本到批量渲染的完整工作流

WebSocket抓包分析实战：从协议帧到真实问题排查

C++节点编辑器实战：命令模式、编组与命中检测优化

AI多模态创作：把ADHD抽象感受拆解成可视化视频

基于窗函数反求法的NLFM信号设计与脉压验证

Microsoft Remote Desktop for macOS 深度指南：RDP 协议、ARM64 原生与 macOS 系统集成

今日更新

Cephadm实战指南：Linux系统工程师的生产级Ceph集群部署与排障

不想再被 Token 额度卡脖子？把免费 API 接入 WorkBuddy 的完整教程

ITK中SpatialObject几何体系解析：坐标系、变换与管道集成

本周精选

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

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

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

本月热门

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

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

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

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