Particles

Heads can emit particle effects via the PlayerParticles plugin. Particle definitions are stored per-head in heads.yml. Each head can have multiple particle effects active simultaneously.

Requirements: PlayerParticles 8.12+ must be installed. If missing, the particles section is silently ignored and heads spawn without particles.

• Effect list: Javadoc

• Style list: Javadoc

Enabling particles

particles:
  enable: true          # false disables all particles for this head
  list:
    <name>:             # Unique name — can be anything
      effect: <EFFECT>  # ParticleEffect enum name
      style: <STYLE>    # ParticleStyle enum name

Choosing effects and styles

The effect and style fields accept names from the PlayerParticles API. Run /pp help in-game for the full list.

Common effects: FLAME, DUST, NOTE, DUST_COLOR_TRANSITION, ENTITY_EFFECT, PORTAL, ENCHANT, HEART, LAVA.

Common styles: NORMAL, RINGS, SPHERE, SPIRAL, VORTEX, WINGS, BEAM.

Simple effects (no color)

Effects like FLAME, HEART, PORTAL, and ENCHANT need no extra data:

particles:
  enable: true
  list:
    flame_rings:
      effect: FLAME
      style: RINGS

Colored effects

DUST, ENTITY_EFFECT, and similar effects accept an RGB color via color:

particles:
  enable: true
  list:
    red_dust:
      effect: DUST
      style: RINGS
      color: "255,50,50"

Color transition effects

DUST_COLOR_TRANSITION blends between two colors. Supply both color (start) and to_color (end):

particles:
  enable: true
  list:
    rainbow:
      effect: DUST_COLOR_TRANSITION
      style: SPHERE
      color: "255,50,50"
      to_color: "50,50,255"

Note effect

NOTE accepts an integer note value (0–24):

particles:
  enable: true
  list:
    chime:
      effect: NOTE
      style: NORMAL
      note: 12

Multiple particles on one head

Define multiple named entries under list to layer effects:

particles:
  enable: true
  list:
    flame_base:
      effect: FLAME
      style: RINGS
    sparkle:
      effect: ENCHANT
      style: SPIRAL