Default Animations

Animations (or Transformers) manipulate the coordinates generated by a shape over time. Below are the built-in animations accessible via the Animations and Billboarding utility classes.

Spin

Methods: Animations.spinX(), Animations.spinY(), Animations.spinZ()

Rotates the entire particle shape around a specific axis over a set duration.

Parameter	Information
`totalDegrees`	The total amount of rotation to perform (e.g., `360` for a full spin).
`duration`	The lifespan of the animation sequence in server ticks.
`easing`	The `Easing` mathematical function dictating the rotation curve.

Scale

Method: Animations.scale()

Grows or shrinks the particle shape from a starting size to an ending size.

Parameter	Information
`startScale`	The initial scale multiplier applied at tick 0.
`endScale`	The final scale multiplier applied at the end of the duration.
`duration`	The total time in ticks for the scaling process to complete.
`easing`	The `Easing` mathematical function dictating the growth curve.

Translate

Method: Animations.translate()

Moves the particle shape towards a target directional offset.

Parameter	Information
`totalOffset`	The final `Vector` directional offset applied by the end of the duration.
`duration`	The total time in ticks for the translation to complete.
`easing`	The `Easing` mathematical function dictating the movement speed.

Breathe

Method: Animations.breathe()

Creates a cyclical "breathing" animation that repeatedly pulses the shape's scale using a sine wave.

Parameter	Information
`minScale`	The minimum scale factor at the bottom of the pulse (exhale).
`maxScale`	The maximum scale factor at the peak of the pulse (inhale).
`duration`	The number of ticks required to complete one full oscillation loop.

Billboard Face (Static)

Method: Billboarding.face()

Calculates a static rotation to make the particle shape face a specific target coordinate once upon initialization.

Parameter	Information
`origin`	The starting `Location` of the particle effect.
`target`	The `Location` the shape should be oriented towards.

Billboard Face (Dynamic)

Method: Billboarding.faceDynamic()

Continuously recalculates rotation every tick to ensure the shape is always facing a moving target (e.g., a player's camera).

Parameter	Information
`originSupplier`	A `Supplier<Location>` providing the effect's current origin location.
`targetSupplier`	A `Supplier<Location>` providing the current target location.

05 June 2026