Custom Particle Configuration

This guide explains how to use the YAML configuration files to create custom effects for Items, Mobs, and Blocks.

Structure of a Config File

Each config file consists of a settings section and a target section (e.g., items, mobs, or blocks).

1. The `settings` Section

This defines how the particles look and behave.

settings:
  delay: 0.1           # How often particles spawn (in seconds). 0.1 = very fast.
  count: 5             # How many particles spawn each time.
  radius: 0.5          # How much the particles spread out from the center.
  permission: "my.perm" # (Optional) Required permission to see/use.
  allowed_dimensions:  # (Optional) List of worlds where this is active.
    - world
    - world_nether

2. Particle Types

You can mix standard particles and custom RGB colors.

particles:
  - FLAME
  - SOUL_FIRE_FLAME
 
rgb_particles:
  - r: 255
    g: 0
    b: 0
    size: 1.5   # Size of the particle (mostly for REDSTONE/DUST)

3. Glow Settings (Advanced)

If PacketEvents is installed, you can make the entity glow with cycling colors.

glow:
  speed: 10     # Color cycle speed. Higher = faster.
  colors:
    - RED
    - GOLD
    - DARK_PURPLE

Target Specific Examples

Item Particles

Use these in items/ folder. You can filter by name, CustomModelData, or NBT tags.

items:
  - material: DIAMOND_SWORD
    item_name: "&cFirebrand"     # Only works on items with this name
    custom_model_data: 1001      # Only works on this specific model
    nbt: "legendary_item"        # Only works if item has this NBT tag

Mob Particles

Use these in mobs/ folder.

mobs:
  - type: ZOMBIE
    name: "&4Boss Mob"           # Only works on zombies with this name
    nbt: "is_boss"               # Only works on entities with this Scoreboard Tag

Block Particles

Use these in blocks/ folder.

settings:
  check:
    size: 15                     # How far (blocks) the plugin looks for these blocks
 
blocks:
  - DIAMOND_BLOCK
  - GOLD_BLOCK

Absolute Bounds (New!)

You can force particles to spawn within a specific 3D box instead of around the entity.

bounds:
  min:
    x: 100
    y: 64
    z: 100
  max:
    x: 110
    y: 70
    z: 110

Online config generator

You can use our online config file generator for faster generating.

https://particleplus.dominikhun250.dev/ (opens in a new tab)

API Usage