MCreator 维度自定义:启用浓雾(Enable Dense Fog / hasFog)参数完全指南

原创2026-10-15 19:54:341,344 阅读
文章标签:低代码代码生成桌面应用游戏开发

MCreator 维度自定义:启用浓雾(Enable Dense Fog / hasFog)参数完全指南

本指南围绕 MCreator 维度(Dimension)编辑器中的「启用浓雾」参数展开,说明该参数的作用机制、在界面中的位置、与渲染距离的关系,以及它在 Java 模组生成与数据包生成两条代码路径中的底层实现。读完本文,你将理解为何勾选该参数后即使把渲染距离调到很大维度内依然迷雾重重,并能像原版下界(Nether)那样营造压迫感十足的环境氛围。

一、参数概述:什么是维度浓雾

在 MCreator 中创建自定义维度时,「启用浓雾」(界面文案为 Enable dense fog:)是一个布尔型开关参数。官方帮助文档对它的描述非常直接:

勾选该参数以启用浓雾。即使调大渲染距离,也会出现浓雾,在下界可以看到这样的例子。

它的核心语义可以拆解为两点:

  1. 强制浓雾:启用后维度内始终存在密度很高的雾效;
  2. 不受渲染距离影响:雾效是独立的视觉覆盖层,即使玩家把游戏渲染距离调到很大的数值,浓雾依然存在,不会因为能见范围变大而消失。

原版游戏中最好的参照物就是下界(Nether)。下界的特殊环境效果(DimensionSpecialEffects)通过 isFoggyAt 返回 true 实现了永不消散的浓雾,这也是帮助文档建议用户直接进下界观察效果的原因。

二、界面位置与操作路径

该参数位于维度元素的**「Dimension effects(维度效果)」设置分区**中。在 DimensionGUI.java 中可以看到,勾选框与帮助按钮按如下顺序挂载:

dimensionEffects.add(HelpUtils.wrapWithHelpButton(this.withEntry("dimension/has_fog"),
        L10N.label("elementgui.dimension.has_fog")));
dimensionEffects.add(hasFog);

其中 this.withEntry("dimension/has_fog") 即指向本文所依据的帮助文档条目(plugins/mcreator-localization/help/default/dimension/has_fog.md),点击标签旁的帮助按钮即可看到该说明。勾选框本体在 GUI 构造时初始化:

private final JCheckBox hasFog = L10N.checkbox("elementgui.common.enable");

界面标签文案 Enable dense fog: 定义于本地化文件 texts.properties,在 elementgui.dimension.has_fog 键下;其他语言版本(如简体中文 texts_zh_CN.properties 等)均有对应翻译。

关键前提:必须先启用自定义效果。 在 updateDimensionEffectSettings() 中有一个联动逻辑:

boolean hasCustomEffects = useCustomEffects.isSelected();
defaultEffects.setEnabled(!hasCustomEffects);
airColor.setEnabled(hasCustomEffects);
sunHeightAffectsFog.setEnabled(hasCustomEffects);
hasFog.setEnabled(hasCustomEffects);

即只有勾选「Use custom effects(使用自定义效果)」后,「启用浓雾」复选框才可交互。这是因为浓雾属于维度自定义环境效果的一部分,需要与自定义天空类型、雾色(airColor)、「太阳高度影响雾色」(sunHeightAffectsFog)等参数协同工作。

该参数的读写也非常简单,保存时 dimension.hasFog = hasFog.isSelected();,载入时 hasFog.setSelected(dimension.hasFog);,对应数据模型字段定义在 Dimension.java:

public boolean hasFog;

三、生成代码的底层实现:Java 模组路径

在 NeoForge 1.21.1 生成器中,维度效果通过 DimensionSpecialEffects 客户端类实现,模板为 dimension.java.ftl。当 useCustomEffects 为真时,生成器会产出如下的特殊效果处理器:

@EventBusSubscriber(Dist.CLIENT) public static class ${name}SpecialEffectsHandler {
    @SubscribeEvent public static void registerDimensionSpecialEffects(RegisterDimensionSpecialEffectsEvent event) {
        DimensionSpecialEffects customEffect = new DimensionSpecialEffects(
            <#if data.hasClouds>${data.cloudHeight}f<#else>Float.NaN</#if>,
            true,
            DimensionSpecialEffects.SkyType.${data.skyType},
            false,
            false
        ) {
            @Override public Vec3 getBrightnessDependentFogColor(Vec3 color, float sunHeight) {
                // 依据 airColor 与 sunHeightAffectsFog 计算雾色
            }

            @Override public boolean isFoggyAt(int x, int y) {
                return ${data.hasFog};
            }
        };
        event.register(ResourceLocation.parse("${modid}:${registryname}"), customEffect);
    }
}

这里 hasFog 直接映射为 DimensionSpecialEffects.isFoggyAt(int x, int y) 的返回值:

  • 返回 true 时,游戏在任意坐标都判定为"雾天",渲染距离再大也会被浓雾笼罩,这正是下界效果的原生行为;
  • 返回 false 时,雾效遵循常规渲染距离规则。

注意该段代码整体被包在 <#if data.useCustomEffects> 条件块内——如果未勾选自定义效果,则根本不会生成这段处理器代码,hasFog 参数自然也不会生效,这与 GUI 中的置灰联动逻辑完全一致。

从模板结构看,浓雾与下列参数是同一套"自定义效果"体系中的组成部分:

参数 字段 在模板中的作用
云层 hasClouds / cloudHeight 决定 DimensionSpecialEffects 构造参数的云高
天空类型 skyType 传入 SkyType.NORMAL / NONE / END
雾色 airColor 决定 getBrightnessDependentFogColor 返回的雾颜色
太阳高度影响雾色 sunHeightAffectsFog 控制是否按太阳高度对雾色做乘法调制
浓雾 hasFog 决定 isFoggyAt 是否恒为 true

四、生成代码的底层实现:数据包路径

数据包生成器(Datapack)走的是另一条路径:维度效果写进 dimension_type JSON。在 1.21.1 数据包模板 dimension_type.json.ftl 中:

<#if data.useCustomEffects>
"effects": "${modid}:${registryname}"
<#else>
"effects": "minecraft:${data.defaultEffects}"
</#if>

hasFog 参数在数据包路径下并不直接体现在 JSON 字段中,而是影响维度效果时间线(effects timeline)的生成。在 26.3.x 数据包模板 dimension_type.json.ftl 中可以更清晰地看到浓雾对应的视觉轨道:

<#if data.useCustomEffects>
  "minecraft:visual/ambient_light_color": "...",
  <#if data.hasFog>
  "minecraft:visual/fog_start_distance": 5,
  "minecraft:visual/fog_end_distance": 40,
  </#if>
  <#if data.airColor?has_content>
  "minecraft:visual/fog_color": "${thelper.colorToHexString(data.airColor)}",
  "minecraft:visual/sky_color": "${thelper.colorToHexString(data.airColor)}",
  </#if>
  ...

可见,在较新版本的数据包生成中,勾选 hasFog 会把雾的起始距离(fog_start_distance)强制设为 5、结束距离(fog_end_distance)强制设为 40,让雾在很近的视野内就从稀薄变为浓密,从而实现"浓雾"效果。作为对比,模板中下界效果(the_nether)的默认参数是 fog_start_distance: 10、fog_end_distance: 96。

五、版本迁移中的特殊处理

hasFog 字段在维度元素升级转换器中还扮演着"旧数据迁移信号"的角色。在 DimensionSettingsConverter.java 中:

// Update dimension effect settings (data packs and Java mods are handled separately)
if (workspace.getGeneratorConfiguration().getGeneratorFlavor().getBaseLanguage()
        == GeneratorFlavor.BaseLanguage.JAVA) {
    dimension.useCustomEffects = true;
    dimension.hasClouds = dimension.imitateOverworldBehaviour;
    dimension.cloudHeight = 192;
    dimension.skyType = dimension.imitateOverworldBehaviour ? "NORMAL" : "NONE";
    dimension.sunHeightAffectsFog = dimension.airColor == null && dimension.imitateOverworldBehaviour;
} else {
    dimension.defaultEffects = dimension.hasFog ? "the_nether" : "overworld";
}

这段代码表明:

  • 对数据包(非 Java)生成器,旧版本中勾选过 hasFog 的维度会被自动迁移为使用 minecraft:the_nether 环境效果,借助原版下界效果来保留"浓雾"观感;
  • 对 Java 模组生成器,转换器会自动打开 useCustomEffects,并把是否勾选 hasFog 交由自定义效果处理器中的 isFoggyAt 决定。

这也从侧面印证:hasFog 与下界效果在视觉目标上是等价的,MCreator 在迁移时正是用下界效果来"兜底"旧的自定义浓雾维度。

六、测试与集成验证

在自动化集成测试数据提供器 TestWorkspaceDataProvider.java 中,测试用维度被显式构造为 dimension.hasFog = _true;,并与其他随机化的维度参数(defaultEffects、skyType、cloudHeight、ambientLight、coordinateScale 等)一起用于生成完整工作区的回归测试。这说明 hasFog 是维度生成测试覆盖的常规配置项之一,确保勾选浓雾后 Java 模组与数据包模板都能正常产出可编译、可运行的代码。

七、实战建议与小结

在实际设计自定义维度时,可以参考以下组合思路:

  • 想复刻下界压迫感:勾选「Use custom effects」→ 勾选「Enable dense fog」,配合较暗的雾色(airColor)与 SkyType.NONE,即可得到类似下界的浓雾环境;若再叠加「Nether like gen」世界生成类型,观感更接近原版。
  • 想保留开阔视野:保持「Enable dense fog」不勾选,此时雾效随渲染距离正常变化,适合平原、天空等强调纵深感的维度。
  • 注意触发条件:浓雾仅在自定义效果开启时生效;若使用预设效果(overworld / the_nether / the_end),浓雾观感由所选预设决定,hasFog 复选框会处于不可用状态。

总结一下:hasFog 是 MCreator 维度编辑器中一个实现成本极低但视觉影响极大的开关。它一端连接着 GUI 中的勾选框与帮助文档,另一端在 Java 模组中映射为 DimensionSpecialEffects.isFoggyAt 的恒真返回、在数据包中映射为极短的雾距离轨道,并以原版下界作为默认参照。理解它的生效前提与两条生成路径,能帮你精准掌控自定义维度的环境氛围,做出更具沉浸感的游戏内容。

登录后查看全文
MCreator