📷Animations

Animation Files

Animation files are stored in the plugin folder:

plugin\core\animations

Animations let you play drop item sequences, sounds, and particle effects as part of the item drop workflow.

File structure

Each animation file follows this root structure:

{
  "drop_animation": {},
  "sound_animation": {},
  "particle_animation": {}
}

• drop_animation — describes the visual and timing behavior for dropped items (movement, spawn positions, delays, etc.).

• sound_animation — defines one or more sounds to play during the animation sequence, with timing and volume/pitch controls.

• particle_animation — configures particle effects (types, positions, velocities, counts and timing).

You can combine any of these sections in a single file to produce complex, synchronized effects.

Reference to an existing animation

Instead of defining everything again, you can reference an animation file stored in:

plugin/core/animations

Use:

{
  animation: {
    "id": "id_animation"
  }
}

id_animation must match the name of an animation file (without extension) inside the animations folder.

This allows you to reuse the same animation across multiple categories, drops, or events—keeping your configs cleaner and easier to maintain.