Sound Animation

Sound Animation

A sound animation allows you to play a sequence of sounds with optional delays between them. You can define one or multiple sound entries, each with its own timing and audio parameters.

Example

"sound_animation": {
  "sounds": [
    {
      "sound_name": "ENTITY_FISHING_BOBBER_RETRIEVE",
      "pitch": 1,
      "volume": 1
    },
    {
      "delay": 20,
      "sound_name": "ITEM_SHIELD_BREAK",
      "pitch": 1.5,
      "volume": 1
    }
  ]
}

Fields

• sound_name — The name of the Minecraft sound to play.

• pitch — Adjusts the sound’s pitch.

• volume — Adjusts the sound’s volume.

• delay (optional) — Delay in ticks before this sound plays. If not specified, the sound plays immediately after the previous one.

Sound Animation with Actions

Some plugins allow linking sound animations to specific actions. Instead of a simple list of sounds, you can define sounds for different outcomes, such as SUCCESS or FAIL.

Example

"sound_animation": {
  "actions": {
    "SUCCESS": [
      {
        "sound_name": "ENTITY_FISHING_BOBBER_RETRIEVE",
        "pitch": 1,
        "volume": 1
      }
    ],
    "FAIL": [
      {
        "sound_name": "ITEM_SHIELD_BREAK",
        "pitch": 1.5,
        "volume": 1
      }
    ]
  }
}

Fields

• actions — A map of action names to lists of sounds.

• sound_name — Minecraft sound to play.

• pitch — Sound pitch.

• volume — Sound volume.

• delay (optional) — Delay in ticks before the sound plays.

This allows different sounds to trigger automatically depending on the result of the event (e.g., a successful or failed fishing attempt).