粒子是一种强大的工具， 可以为美丽的场景增添氛围，也可以为你的 boss 战添加紧张感。 让我们创建一个自定义粒子吧！

注册自定义粒子

我们会添加新的火花粒子，模仿末地烛的粒子移动。

首先，需要在你的模组初始化器中，使用你的模组 ID，注册 ParticleType。

// This DefaultParticleType gets called when you want to use your particle in code.
public static final SimpleParticleType SPARKLE_PARTICLE = FabricParticleTypes.simple();

	// Register our custom particle type in the mod initializer.
	Registry.register(BuiltInRegistries.PARTICLE_TYPE, Identifier.fromNamespaceAndPath(MOD_ID, "sparkle_particle"), SPARKLE_PARTICLE);

小写字母“sparkle_particle”是粒子纹理的 JSON 路径。 稍后就会以这个名字，创建新的 JSON 文件。

客户端注册

在模组的初始化器中注册粒子后，还需要在客户端的初始化器中注册粒子。

// For this example, we will use the end rod particle behaviour.
ParticleFactoryRegistry.getInstance().register(ExampleMod.SPARKLE_PARTICLE, EndRodParticle.Provider::new);

在这个例子中，我们在客户端注册我们的粒子。 使用末地烛粒子的 factory，给予粒子一些移动。 这意味着，我们的粒子就会像末地烛那样移动。

TIP

你可以查看 ParticleFactory 接口的所有实现，从而查看所有的粒子 factory。 这有助于你为你自己的粒子使用其他粒子的行为。

• IntelliJ 的快捷键：Ctrl+Alt+B
• Visual Studio Code 的快捷键：Ctrl+F12

创建 JSON 文件并添加纹理

你需要在你的 resources/assets/example-mod/ 文件夹中创建两个文件夹。

文件夹路径	说明
/textures/particle	particle 文件夹会包含你的所有粒子的纹理。
/particles	particle 文件夹会包含你的所有 json 文件

例如，我们在 textures/particle 中只有一个纹理，叫做 sparkle_particle_texture.png。

然后，在 particles 中创建新的 JSON 文件，名称与用于创建你的 ParticleType 的 JSON 路径相同。 例如，我们需要创建 sparkle_particle.json。 这个文件很重要，因为让 Minecraft 知道我们的粒子应该使用哪个纹理。

{
  "textures": ["example-mod:sparkle_particle_texture"]
}

TIP

可以给 textures 数组添加更多纹理以创建粒子动画。 粒子会在这个数组中循环纹理，以第一个纹理开始。

测试新的粒子

完成了 JSON 文件并保存你的作品后，就能够载入 Minecraft 并测试好一切了！

可以输入以下命令，看看是否一切正常：

/particle example-mod:sparkle_particle ~ ~1 ~

INFO

用这个命令，粒子会生成在玩家内。 你可能需要往后走才能实际看到。

你也可以使用相同命令，用命令方块召唤粒子。