particle_animation

Plays a particle animation at the trigger location over time using a named animation pattern.

Categories: visual

Required arguments

Key(s)DescriptionType
particleThe particle type to spawn during the animation.STRING
animationThe animation pattern to use (e.g. circle, helix).
Choices: circle, double_helix, ground_spiral, helix, trace, twirl, wing_tips, projectile_trail		STRING

Inherited argument blocks

  • subsection particle_args

Optional arguments

Key(s)DescriptionTypeDefault
particle-amountThe number of particles to spawn per animation point per tick. Supports expressions.EXPRESSION1
entityThe entity to anchor the animation to.
Choices: player, victim, projectile		STRINGplayer
use-eye-locationWhether to use the entity's eye location instead of their feet.BOOLEANfalse

Trigger parameters required

  • PLAYER

  • LOCATION

Example

effects:
  - id: particle_animation
    args:
      particle: flame
      animation: circle|double_helix|ground_spiral|helix|trace|twirl|wing_tips|projectile_trail
      particle-amount: <expression> # ← Optional
      entity: player|victim|projectile # ← Optional
      use-eye-location: true # ← Optional

Behaviour

SettingValue
Run orderNORMAL
Supports delaytrue
Reloads on plugin reloadtrue