Particle Animations

The Particle Module lets you create complex and beautiful particle effects. Unlike simple particle commands, this module allows you to define both the look of the particles and their movement pattern separately, giving you incredible creative control.

Manage your particle animations in /editmap -> Particles (Blaze Powder).

The Two Parts of an Animation

Every particle effect you create has two main components:

1. Particle Type: This defines the appearance of the individual particles.

   • Examples: Dust (colored), Flame, Note, Heart.
   • Some types, like Dust, have their own configuration where you can set things like Color and Size.

2. Animation Type: This defines the path or pattern the particles will follow.

   • Examples: Circle, Sphere, Helix, Vortex, Explosion Wave.
   • Most animations have configuration options like Radius, Speed, and Rate (particle density).

Creating a Particle Animation

1. Go to the Particles menu.
2. Click "Create Animation" and give it a name (e.g., Victory Sparkle, Heal Aura).
3. This will open the Animation Edit Menu.
4. Configure the Particle:
   • Click "Particle". You'll be shown a list of all available particle types. Select one.
   • After selecting, you can right-click the "Particle" item again to configure its specific options (like color for dust).
5. Configure the Animation:
   • Click "Animation". You'll see a list of all available movement patterns. Select one.
   • After selecting, right-click the "Animation" item to configure its options (like radius, height, or speed).

Displaying the Animation

Creating an animation only defines its template. To make it appear in your game, you must use the Show Particles action.

• Animation: Select the keyed particle animation you just created.
• Location: Where the animation should be centered. This can be a fixed spot or dynamic, like a player's current location.
• Show For All: If true, all players see it. If false, only the target player of the action sees it.
• Name: Give this specific instance of the animation a unique name. This is important if you want to stop it later.
• Duration: Set a time in ticks (20 ticks = 1 second) for how long the animation should play. If you set this, you don't need a name.

To stop a named particle animation, use the Destroy Particles action and provide the same name you used to start it. To stop all animations at once, use Destroy All Particles.

Example: Creating a Healing Aura

1. Create Animation: Create a new particle animation named Heal Aura.
2. Particle: Choose the HEART particle type. It has no extra configuration.
3. Animation: Choose the CIRCLE animation type.
   • Right-click to configure it and set the Radius to 1.5.
4. Create a Trigger: Set up an event, for example, a Player Interact event on a block.
5. Add Action: Add a Show Particles action.
   • Animation: Select Heal Aura.
   • Location: Set to Player Location.
   • Show For All: True.
   • Duration: 40 (for 2 seconds).

Now, when a player triggers the event, a circle of hearts will appear around them for two seconds.