MCreator 流体元素 Type 参数详解:水/岩浆类型如何控制地图颜色、灭火、溺水与游泳等行为
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)两份生成代码,属于"一处选择、多处生效"的全局性参数。
六、实操建议
- 先定 Type 再调其他参数:Type 决定了一组默认行为(如水的
fallDistanceModifier(0F)),后续再通过密度(density,默认 1000)、粘度(viscosity,默认 1000)、温度(temperature,默认 300)、流动强度(flowStrength,影响motionScale,即流体推动实体的力度)等参数微调,见 Fluid.java。 - 不要试图在 LAVA 型上实现游泳/灭火:模板中的
canSwim(false)、canDrown(false)是岩浆分支硬编码的,界面帮助文档也标注了这些行为"(仅水)"。若需要"可游泳但不灭火"的流体,应从 WATER 型出发,并结合其余参数实现差异化,而非在 LAVA 型上打补丁。 - 地图颜色可二次定制:若不想让流体在小地图上显示为默认的水蓝或火红,请使用流体元素中的"地图颜色"(colorOnMap)独立配置项,它会覆盖 Type 决定的默认色。
- 关注目标版本差异: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 代码的完整映射关系,从而在创建自定义流体时做出正确的类型选择。