MCreator 流体编辑器「滴落粒子」（Drip Particle）参数详解：从界面配置到代码生成-优快云博客

【免费下载链接】MCreator

MCreator 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 流体（Fluid）编辑器中的 滴落粒子（Drip Particle） 参数展开，讲解它如何在游戏内呈现流体从方块边缘滴落的视觉效果、在图形界面中如何配置、可选粒子有哪些，以及最终是如何通过代码生成器转化为真实可运行的 Minecraft Mod 代码的。读完本文，你将掌握该参数的完整配置路径、与「生成粒子」开关的联动关系，以及底层数据模型与模板生成机制。

什么是「滴落粒子」参数

在 MCreator 的流体编辑器中，「滴落粒子」参数用于控制流体从方块上滴落时将会生成的粒子类型。该帮助条目在仓库中的原文为：

该参数控制流体从方块上滴落时将会生成的粒子。

它定义的不是流体本体在静态状态下的外观，而是流体与方块接触边界处的动态细节——例如水从岩石边缘滴落、岩浆从洞穴顶渗出等场景中，游戏渲染出的那一颗颗下坠的粒子。

该参数的生效依赖一个前置开关：编辑器中的 Spawn particles（生成粒子）选项。其帮助条目说明如下：

启用后，当流体位于实心方块上方且下方是空气时，流体将产生粒子。

也就是说，只有当「生成粒子」被勾选，且流体的位置满足「上方为实心方块、下方为空气」这一物理条件时，滴落粒子参数才会真正起作用。

在图形界面中的配置方式

在流体编辑器的界面中，滴落粒子是一个与「生成粒子」复选框联动的下拉选择框。从 FluidGUI.java 的源码可以看到它的完整交互逻辑：

第 83 行创建了下拉框组件：private final DataListComboBox dripParticle = new DataListComboBox(mcreator);；
第 469 行通过 refreshDripSettings() 方法实现联动：dripParticle.setEnabled(spawnParticles.isSelected());，即只有勾选「生成粒子」后，滴落粒子下拉框才可操作，否则处于置灰状态；
第 491 行加载可选粒子列表：ComboBoxUtil.updateComboBoxContents(dripParticle, ElementUtil.loadAllParticles(mcreator.getWorkspace()));，下拉框内容来自工作区已注册的粒子数据列表；
第 509 行在打开编辑模式时回填已保存的取值：dripParticle.setSelectedItem(fluid.dripParticle);；
第 569 行在保存时把下拉框取值包装成数据模型字段：fluid.dripParticle = new ParticleEntry(mcreator.getWorkspace(), dripParticle.getSelectedItem());。

实际操作为：在 MCreator 中新建/编辑流体元素 → 进入流体编辑器 → 勾选「生成粒子（Spawn particles）」→ 在「滴落粒子（Drip particle）」下拉框中选择一种粒子 → 保存并生成代码。

可选粒子一览

下拉框中的候选粒子来自仓库的 particles.yaml 数据列表，包含大量原版粒子类型，与滴落场景强相关且常用的一批包括：

DRIP_WATER（水滴）、DRIP_LAVA（岩浆滴）、FALL_LAVA（下落岩浆）、LAND_LAVA（落地岩浆）
DRIPPING_HONEY / FALLING_HONEY / LANDING_HONEY（蜂蜜滴落系列）
DRIPPING_OBSIDIAN_TEAR / FALLING_OBSIDIAN_TEAR / LANDING_OBSIDIAN_TEAR（黑曜石泪滴系列）
DRIPPING_DRIPSTONE_LAVA / FALLING_DRIPSTONE_LAVA（滴水石锥岩浆系列）
DRIPPING_DRIPSTONE_WATER / FALLING_DRIPSTONE_WATER（滴水石锥水滴系列）
以及 WATER_DROP、WATER_SPLASH、BUBBLE_POP、GLOW、SNOWFLAKE、FLAME、ASH 等通用粒子

水、岩浆类流体分别搭配 DRIP_WATER / DRIP_LAVA 即可获得贴近原版的滴落观感；蜂蜜、黑曜石泪、滴水石锥等系列粒子则适合用于自定义材质的特殊流体，让流体主题更鲜明。列表中还包含 EXPLOSION_NORMAL、PORTAL、HEART、END_ROD 等大量其他粒子，可根据创意自由选择。

数据模型：参数如何被存储

在数据模型层，滴落粒子参数定义在 Fluid.java 中，与「生成粒子」开关构成依赖关系：

public boolean spawnParticles;
@NonNullIf("spawnParticles") public ParticleEntry dripParticle;

spawnParticles 是布尔开关，决定流体是否产生滴落粒子；
dripParticle 是 ParticleEntry 类型的粒子条目，标注了 @NonNullIf("spawnParticles")，意味着当「生成粒子」为 true 时该字段必须有值——这正是界面上开关与下拉框联动、校验器要求二者同步的底层原因。

ParticleEntry 定义于 ParticleEntry.java，它继承自 MappableElement，通过 new NameMapper(owner, "particles") 将界面中选中的粒子名称映射到目标 Minecraft 版本对应的粒子注册名，从而保证同一份工作区数据在不同生成器目标版本下都能正确输出代码。

代码生成：模板如何产出 Java 代码

流体生成器模板 fluid.java.ftl 负责把上述字段翻译成 Neoforge 模组源码。其中与滴落粒子相关的片段是：

<#if data.spawnParticles>
@Override public ParticleOptions getDripParticle() {
    return ${data.dripParticle};
}
</#if>

可以看到：只有当 spawnParticles 为 true 时，模板才会在生成的流体类中重写 getDripParticle() 方法并返回所选粒子的 ParticleOptions；若开关为 false，则不会生成该方法，流体将完全继承原版流体基类的默认行为。这正是界面联动逻辑在代码层面的最终落地。

该模板的注册与输出路径定义在 fluid.definition.yaml 中，模板会被输出到 @SRCROOT/@BASEPACKAGEPATH/fluid/@NAMEFluid.java，即生成的工作区源码目录下对应包路径的 @NAMEFluid.java 文件。

生成代码在游戏内的行为

从生成的源码结构看，重写 getDripParticle() 后，游戏引擎会在流体滴落判定发生时调用该方法，取得滴落粒子类型并进行渲染。配合「生成粒子」的物理条件（上方为实心方块、下方为空气），生成的粒子会在方块下缘出现并下坠，形成类似原版水从岩石滴落、岩浆从矿洞顶渗出的动态效果。

对于希望自定义滴落观感的模组作者，可参考以下几点实战建议：

水基流体：选择 DRIP_WATER 或 WATER_DROP，贴近原版视觉；
岩浆/热源流体：选择 DRIP_LAVA、FALL_LAVA，并可通过 LAND_LAVA 搭配表现落地溅射；
特殊主题流体（如蜂蜜、药水、魔法液）：优先从蜂蜜滴落、黑曜石泪、滴水石锥及魔法类粒子（SPELL_WITCH、ENCHANTMENT_TABLE 等）中挑选，让流体外观与主题一致；
注意性能与氛围平衡：粒子数量越多越消耗客户端渲染资源，实际生成 Mod 后在游戏内观察滴落频率，必要时切换更轻量的粒子。

小结

滴落粒子参数是 MCreator 流体编辑器中一个虽小但效果直观的视觉配置项：它由「生成粒子」开关控制可用性，通过下拉框在 particles.yaml 提供的原版粒子集中选择，最终由 fluid.java.ftl 生成 getDripParticle() 重写方法写入模组代码。理解这条从「界面配置 → 数据模型 → 模板生成 → 游戏渲染」的完整链路，有助于你更自如地控制自定义流体在 Minecraft 世界中的表现细节。