> For the complete documentation index, see [llms.txt](https://pm2plugins.gitbook.io/advancedcrates/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pm2plugins.gitbook.io/advancedcrates/animations/particle-animations.md).

# Particle Animations

This page holds information regarding how to set up and customize particles for stationary crates.

The plugin currently has 4 particle animations which can be customized by speed, location and particle type. A crate can have multiple particle animations at the same time.

An example of all available particle animations as well as how a properly set up configuration looks like can be found in the default RoundCrateParticles.yml file inside of the Crates folder.

Currently you can only set up particles for stationary crates in individual crate .YML files. Examples of configuration code can be found below.

<figure><img src="https://3479755269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD2e4i7eNwVcD1Ka1HcqH%2Fuploads%2FwFLe2H05NDCOe9HZFQJy%2F1a.gif?alt=media&amp;token=8bbc37a5-bba5-497c-8937-7f53246e8a68" alt=""><figcaption><p>Tilted Rings animation</p></figcaption></figure>

The example above is of a TILTED\_RINGS animation lowered by -1 y block and particle type chosen to be FLAME, an example of the code used to achieve this is found below.

```
ParticleAnimations:
  Rings:
    type: FLAME
    range-x: 1.0
    range-y: -1.0
    range-z: 0.0
    speed: 0.0
    amount: 1
    animation: TILTED_RINGS
    center-x: 0
    center-y: 0
    center-z: 0
```

<figure><img src="https://3479755269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD2e4i7eNwVcD1Ka1HcqH%2Fuploads%2FKvDaDfb1A3mZshKeWnZK%2F2.gif?alt=media&amp;token=7e90fed4-136d-4dee-a5f5-fe53f74c3c5d" alt=""><figcaption><p>Offset Tilted Rings Animation</p></figcaption></figure>

The example above is of a OFFSET\_TILTED\_RINGS animation with particle type chosen to be CRIT\_MAGIC, an example of the code used to achieve this is found below.

```
ParticleAnimations:
  Spiral:
    type: CRIT
    range-x: 1.0
    range-y: 0.0
    range-z: 0.0
    speed: 1.0
    amount: 1
    animation: OFFSET_TILTED_RINGS
    center-x: 0
    center-y: 0
    center-z: 0
```

<figure><img src="https://3479755269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD2e4i7eNwVcD1Ka1HcqH%2Fuploads%2F6qQIUdRQHauTfuBCkYs7%2F3a.gif?alt=media&amp;token=46a35d65-dded-4c7a-8d22-c98feaeb6e79" alt=""><figcaption><p>Double Spiral Animation</p></figcaption></figure>

The example above is of a DOUBLE\_SPIRAL animation with particle type chosen to be FLAME, an example of the code used to achieve this is found below.

```
ParticleAnimations:
  FlameRing:
    type: FLAME
    range-x: 1.0
    range-y: 0.0
    range-z: 0.0
    speed: 1.0
    amount: 1
    animation: OFFSET_TILTED_RINGS
    center-x: 0
    center-y: 0
    center-z: 0
```

<figure><img src="https://3479755269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD2e4i7eNwVcD1Ka1HcqH%2Fuploads%2FGnUAkjL1TdkqpfE10z0T%2F4a.gif?alt=media&amp;token=f3e61874-80fb-4dd1-a480-62f3c85a6bcb" alt=""><figcaption><p>Circle Animation</p></figcaption></figure>

The example above is of a CIRCLE animation with particle type chosen to be ENCHANTMENT\_TABLE, speed set to 20 and particle amount to 16, an example of the code used to achieve this is found below.

```
ParticleAnimations:
  EnchantmentAnimation:
    type: ENCHANTMENT_TABLE
    range-x: 1.0
    range-y: 1.0
    range-z: 1.0
    center-x: 0.0
    center-y: 0.0
    center-z: 0.0
    speed: 20.0
    amount: 16
    animation: CIRCLE
```

## How to rotate an animation sideways?

If you want to put the particle animation to go at a slight angle or for example a 90-degree angle (sideways), you need to edit the \`range-z\` configuration to the degree amount. In the mentioned example, you would set \`range-z: 90\`&#x20;

```yaml
ParticleAnimations:
  Rings:
    type: FLAME
    range-x: 1.0
    range-y: -1.0
    range-z: 90.0
    speed: 0.0
    amount: 1
    animation: TILTED_RINGS
    center-x: 0
    center-y: 0
    center-z: 0
```
