创建自定义粒子

粒子是一种强大的工具， 可以为美丽的场景增添氛围，也可以为你的 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(Registries.PARTICLE_TYPE, Identifier.of(MOD_ID, "sparkle_particle"), SPARKLE_PARTICLE);

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

客户端注册

将粒子注册到 ModInitializer 入口点后，还需要将粒子注册到 ClientModInitializer 入口点。

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

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

TIP

You can see all the particle factories by looking at all the implementations of the ParticleFactory interface. This is helpful if you want to use another particle's behaviour for your own particle.

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

创建 JSON 文件并添加纹理

你需要在你的 resources/assets/<mod id here>/ 文件夹中创建两个文件夹。

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

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

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

{
  "textures": [
    "fabric-docs-reference:sparkle_particle_texture"
  ]
}

TIP

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

测试新的粒子

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

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

/particle <mod id here>:sparkle_particle ~ ~1 ~

INFO

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

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