MCreator 流体元素 Type 参数详解:水/岩浆类型如何控制地图颜色、灭火、溺水与游泳等行为

原创2026-10-16 22:54:181,865 阅读
文章标签:低代码代码生成桌面应用游戏开发

MCreator 流体元素 Type 参数详解:水/岩浆类型如何控制地图颜色、灭火、溺水与游泳等行为

在 MCreator 中创建自定义流体(Fluid)时,"Type"(类型)是最基础也最容易忽视的配置项之一。本文基于 MCreator 官方帮助文档 fluid/type.md,结合仓库中流体元素的源码模型与 NeoForge 代码生成模板,系统讲解该参数控制的 7 类流体行为,并说明其底层是如何映射为生成的 Mod 代码的。读完本文,你将能在 MCreator 中准确选择水型或岩浆型流体,并理解为何部分选项只对"水"型生效。

一、Type 参数是什么

Type 是 MCreator 流体元素(Fluid)编辑界面中的核心下拉选项,取值只有两种:WATER(水)与 LAVA(岩浆)。从源码数据模型看,该字段定义于 Fluid.java:

@Nonnull @LimitedOptions({ "WATER", "LAVA" }) public String type;

界面侧,FluidGUI.java 通过注解反射生成下拉框,并将所选值写回 fluid.type:

private final JComboBox<String> fluidtype = ComponentFromAnnotation.options(Fluid.class, "type");

帮助文档明确指出,这个参数"控制部分流体参数",具体包括 7 项行为。虽然选项只有两个,但它会一次性决定一组默认物理与交互行为,是后续配置密度、粘度、温度、流动强度等参数之前必须做出的选择。

二、Type 控制的七类流体行为

根据 type.md 的说明,Type 影响以下行为:

行为 说明 适用类型
地图颜色(Color on the map) 小地图上流体区块显示的颜色 全部
掉落距离修饰符(Fall distance modifier) 实体落入流体时对摔落伤害计算的修正 全部
灭火能力(Extinguish fires) 流体能否扑灭火焰 仅水
承载船只(Supports boating) 流体能否支撑船在其上行驶 仅水
灌溉作物(Hydrate crops) 流体能否湿润耕地、促进作物生长 仅水
导致溺水(Causes drowning) 实体浸入流体时是否会溺水窒息 仅水
允许游泳(Swimming possible) 实体能否在流体中游泳 仅水

其中"掉落距离修饰符"和"地图颜色"对水、岩浆两种类型都生效,而其余 5 项行为在界面中仅对"水"型流体有意义——正如文档中反复标注的 "(water only)"。换言之,选择 LAVA 时,灭火、承载船只、灌溉、溺水、游泳这 5 项会以"岩浆的默认语义"被固化下来(岩浆不可游泳、不可承船、不可灭火、不可灌溉),而不是简单地不生效。

三、从源码看 Type 如何映射为 FluidType 属性

MCreator 为 NeoForge 1.21.1 生成流体类型代码的模板是 fluidtype.java.ftl,其中对 data.type 做了条件分支:

<#if data.type == "WATER">
    .fallDistanceModifier(0F)
    .canExtinguish(true)
    .supportsBoating(true)
    .canHydrate(true)
<#else>
    .canSwim(false)
    .canDrown(false)
    .pathType(PathType.LAVA)
    .adjacentPathType(null)
</#if>

这直接印证了帮助文档中的每一条描述:

  • 掉落距离修饰符:水型生成 .fallDistanceModifier(0F),即落入流体时摔落伤害修正为 0,这也是原版水"接住掉落"的机制;岩浆型则保留默认修正。
  • 灭火:水型生成 .canExtinguish(true),对应文档"能否灭火"。
  • 承载船只:水型生成 .supportsBoating(true),对应文档"能否承载船"。
  • 灌溉作物:水型生成 .canHydrate(true),对应文档"能否灌溉作物"。
  • 溺水:岩浆型强制 .canDrown(false),对应文档"水是否导致溺水"——岩浆中不会出现溺水判定(而是火焰伤害)。
  • 游泳:岩浆型强制 .canSwim(false),对应文档"是否可游泳"。

此外,岩浆分支还会额外生成 .pathType(PathType.LAVA) 与 .adjacentPathType(null),用于引导生物寻路 AI 将岩浆视为"危险路径"、相邻路径置空,这是帮助文档未展开、但源码中真实存在的岩浆专属行为。

在面向 26.3.x(新版)NeoForge 的模板 fluidtype.java.ftl 中,分支逻辑完全一致,并额外重写了 move() 方法,让非水型流体通过 travelInLava(...) 获得岩浆移动语义,水型则使用 travelInWater(...)——进一步说明 Type 选择直接决定生成流体的移动物理。

四、地图颜色的生成逻辑

地图颜色是唯一一项在流体方块模板中处理的 Type 相关行为。在 fluidblock.java.ftl 中:

.mapColor(MapColor.${(data.type=="WATER")?then("WATER","FIRE")})

即:Type 为 WATER 时,流体方块的 MapColor 使用原版水的 WATER 色;Type 为 LAVA 时使用 FIRE(火红)色。这与文档中"地图上的颜色"一一对应——不过要注意,MCreator 流体元素还提供了独立的"地图颜色"(colorOnMap)配置项,见 Fluid.java 的 public MapColor colorOnMap;,它可以在 fluidblock.java.ftl 中覆盖上述默认色(非 DEFAULT 时优先使用自定义 MapColor)。因此"地图颜色"的实际最终值 = 自定义 colorOnMap(若设置)> Type 决定的默认色。

五、Type 与 Fluid 元素整体架构的关系

Type 只是 MCreator 流体元素众多配置之一,但它与整个流体生成管线紧密关联。从 fluid.definition.yaml 可以看到,一个流体元素会同时生成:

  • @NAMEFluid.java(流体本体,含 Source/Flowing 两个静态内部类,由 fluid.java.ftl 生成);
  • @NAMEBlock.java(LiquidBlock 方块,地图颜色与方块属性在这里);
  • types/@NAMEFluidType.java(FluidType,本文所述参数的主要落点);
  • 可选 @NAMEItem.java 与桶模型 JSON(generateBucket 开启时)。

可见 Type 的选择会同时影响流体类型类(FluidType)与流体方块类(LiquidBlock)两份生成代码,属于"一处选择、多处生效"的全局性参数。

六、实操建议

  1. 先定 Type 再调其他参数:Type 决定了一组默认行为(如水的 fallDistanceModifier(0F)),后续再通过密度(density,默认 1000)、粘度(viscosity,默认 1000)、温度(temperature,默认 300)、流动强度(flowStrength,影响 motionScale,即流体推动实体的力度)等参数微调,见 Fluid.java。
  2. 不要试图在 LAVA 型上实现游泳/灭火:模板中的 canSwim(false)、canDrown(false) 是岩浆分支硬编码的,界面帮助文档也标注了这些行为"(仅水)"。若需要"可游泳但不灭火"的流体,应从 WATER 型出发,并结合其余参数实现差异化,而非在 LAVA 型上打补丁。
  3. 地图颜色可二次定制:若不想让流体在小地图上显示为默认的水蓝或火红,请使用流体元素中的"地图颜色"(colorOnMap)独立配置项,它会覆盖 Type 决定的默认色。
  4. 关注目标版本差异:1.21.1 与 26.3.x 两套生成模板在 Type 分支上行为一致,但 26.3.x 额外加入了 move() 委托逻辑;若你的 Mod 面向新版本 NeoForge,建议以 generator-26.3.x 模板 为基准核对行为。

总结

MCreator 流体元素的 Type 参数看似简单(只有 WATER 与 LAVA 两个选项),实则一次性锁定了地图颜色、掉落距离修正、灭火、承船、灌溉、溺水、游泳共 7 项行为,其中 5 项仅对水型开放。通过 type.md 的说明并结合 fluidtype.java.ftl 与 fluidblock.java.ftl 的生成逻辑,可以清晰地看到界面选项到最终 Mod 代码的完整映射关系,从而在创建自定义流体时做出正确的类型选择。

登录后查看全文
MCreator