Particle Effects

Particles Effects are predefined particle shapes that can be used within Particle Animations to create visual effects when a crate is opened. There are various settings that apply to all effects, as well as specific settings for each effect type.

{
  "type": "",
  "particle": {
    "type": "minecraft:happy_villager"
  },
  "speed": 1,
  "start_delay": 0,
  "end_delay": 0,
  "offset": {
    "x": 0.0,
    "y": 1.0,
    "z": 0.0
  }
}

Particle Effect Options

Type

The type of particle effect to display. A list of available types can be found in Particle Effect Types.

"type": "SPIRAL"

Particle

The particle to use for this effect. This is in Minecraft’s Particle Option formatting, which allows for various options depending on the particle type. All particles have a "type" option that defines the particle ID. Find additional options on the Minecraft Wiki’s Particle format page.

"particle": {
  "type": "minecraft:happy_villager"
}

Speed

The speed of this particle effects animation. A particle effect is made up of frames, one particle packet per frame. This speed setting controls how many ticks a single frame lasts. 1 means each frame lasts 1 tick (20 frames per second) where 2 means each frame lasts 2 ticks (10 frames per second). Defaults to 1 if not provided.

"speed": 1

Start Delay

The delay in ticks before this particle effect starts playing. Useful for sequencing multiple effects. Defaults to 0 if not provided.

"start_delay": 0

End Delay

The delay in ticks after this particle effect finishes playing before the next effect starts. Useful for sequencing multiple effects. Defaults to 0 if not provided.

"end_delay": 0

Offset

The offset position to apply to the particle effect. This is relative to the crate’s bottom center position.

"offset": {
  "x": 0.0,
  "y": 1.0,
  "z": 0.0
}

Additional Options

Additional options are available depending on the type of animation used. See Animation Types for each type’s additional options.

---

Effect Types

These are the available Effect Types along with a short description.

Identifier	Description
CIRCLE	2D circle
SPIRAL	Spiral progressing around and down a cylinder
PULSE	Growing 2D circles extending from a center point to an outer width
BEAM	2D circle progressing up/down a cylinder

Circle Effect

2D circular effect, starting at one position and progressing around the circle.

{
  "type": "CIRCLE",
  "particle": {
    "type": "minecraft:happy_villager"
  },
  "speed": 1,
  "start_delay": 0,
  "end_delay": 0,
  "offset": {
    "x": 0.0,
    "y": 1.0,
    "z": 0.0
  },
  "radius": 1.0,
  "points": 20,
  "phase": 0.0,
  "clockwise": true,
  "strands": 1,
  "rotation": {
    "x": 0.0,
    "y": 0.0,
    "z": 0.0
  }
}

Circle Effect Configuration options for the CIRCLE particle effect

Spiral Effect

Spiraling effect, progressing around and down a cylinder.

{
  "type": "SPIRAL",
  "particle": {
    "type": "minecraft:happy_villager"
  },
  "speed": 1,
  "start_delay": 0,
  "end_delay": 0,
  "offset": {
    "x": 0.0,
    "y": 1.0,
    "z": 0.0
  },
  "radius": 1.0,
  "points": 20,
  "turns": 1,
  "height": 2.0,
  "phase": 0.0,
  "clockwise": true,
  "reverse": true,
  "strands": 1,
  "rotation": {
    "x": 0.0,
    "y": 0.0,
    "z": 0.0
  }
}

Spiral Effect Configuration options for the SPIRAL particle effect

Pulse Effect

2D circular pulse effect, expanding from a center point to an outer width.

{
  "type": "PULSE",
  "particle": {
    "type": "minecraft:happy_villager"
  },
  "speed": 1,
  "start_delay": 0,
  "end_delay": 0,
  "offset": {
    "x": 0.0,
    "y": 1.0,
    "z": 0.0
  },
  "start_radius": 0.5,
  "end_radius": 3.0,
  "start_points": 20,
  "end_points": 50,
  "rings": 10,
  "outwards": true,
  "rotation": {
    "x": 0.0,
    "y": 0.0,
    "z": 0.0
  }
}

Pulse Effect Configuration options for the PULSE particle effect

Beam Effect

2D circular beam effect, progressing up or down a cylinder.

{
  "type": "PULSE",
  "particle": {
    "type": "minecraft:happy_villager"
  },
  "speed": 1,
  "start_delay": 0,
  "end_delay": 0,
  "offset": {
    "x": 0.0,
    "y": 1.0,
    "z": 0.0
  },
  "radius": 1.0,
  "points": 40,
  "height": 10,
  "spacing": 1.0,
  "upwards": true,
  "rotation": {
    "x": 0.0,
    "y": 0.0,
    "z": 0.0
  }
}

Beam Effect Configuration options for the BEAM particle effect