Particle format

This feature is exclusive to Java Edition.

When particles are spawned using the /particle command, by biomes or enchantments, they can be configured using NBT or JSON data.

Usage

When referenced from a biome or enchantment definition, a particle is defined using:

[NBT Compound / JSON Object]: The particle object
- [String] type: The id of the particle type, see Particles (Java Edition) for valid options
- Additional fields based on the type, see below

Some particle types have configurations that need to be specified. These types and the configuration fields are:

block, block_crumble, block_marker, dust_pillar, and falling_dust
- [NBT Compound / JSON Object] block_state: Contains the block state used for the particle.
  - Block state see Template:Nbt inherit/block state/template
- Alternative syntax:
- [String] block_state: The resource location of the block to use.

dust
- [NBT List / JSON Array] color: Three floats representing the red, green, and blue components of the dust color. Each should be from 0 to 1. If any color value is less than 0 or higher than 1, the particle color is undefined behavior.
- [Float] scale: Controls the size scale multiplier and lifetime multiplier of the particle. The particle's lifetime is a random integer from 8 to 40 game ticks, then multiplied by this scale value, with a minimum of 1 and a maximum of 4 .

dust_color_transition
- [NBT List / JSON Array] from_color: Three floats representing the red, green, and blue components of the start color. Each should be from 0 to 1. If any color value is less than 0 or higher than 1, the particle color is undefined behavior.
- [NBT List / JSON Array] to_color: Three floats representing the red, green, and blue components of the end color. Each should be from 0 to 1. If any color value is less than 0 or higher than 1, the particle color is undefined behavior.
- [Float] scale: Controls the size scale multiplier and lifetime multiplier of the particle. The particle's lifetime is a random integer from 8 to 40 game ticks, then multiplied by this scale value, with a minimum of 1 and a maximum of 4 .

entity_effect
- [NBT List / JSON Array] color: Four floats representing the red, green, blue, and alpha components of the color. Each should be from 0 to 1. If any color value is less than 0 or higher than 1, the particle color is undefined behavior.
- Alternative syntax:
- [Int] color: Decimal number representing the ARGB color, calculated using this formula:
  Alpha<<24 + Red<<16 + Green<<8 + Blue

item
- [NBT Compound / JSON Object] item: Contains the item data used for the particle.
  - A single item stack see Template:Nbt inherit/itemnocount/template
- Alternative syntax:
- [String] item: The resource location of the item to use.

trail
- [NBT List / JSON Array] target: The coordinates the trail particles will go to.
- [Int] color: The particle color, as an RGB integer.
- [Int] duration: The number of ticks the particle will take to travel to the target.

vibration
- [NBT Compound / JSON Object] destination: The destination.
  - [String] type: Must be block.
  - [NBT List / JSON Array] pos: The block position.
    - [Int]: X
    - [Int]: Y
    - [Int]: Z
- [Int] arrival_in_ticks: The duration of the move.

All other types don't have any configuration.

Java Edition
1.20.5	24w14a	Added particle types `dust_pillar`, `infested`, `item_cobweb`, `ominous_spawning`, `raid_omen`, `small_gust`, `trial_omen`, and `trial_spawner_detection_ominous`.
	1.20.5-pre1	Particle options in SNBT format are now used in the `/particle` command.
		Changes to `item` particle: renamed `value` field to `item`, now also allows a string item ID as shorthand.
		Changes to `block` particle: renamed `value` field to `block_state`, now also allows a string block ID as shorthand.
		Changes to `entity_effect` particle: renamed `value` field to `color`, now also allows a list of 4 floats.
		Changes to `dust_color_transition` particle: renamed `fromColor` to `from_color` and `toColor` to `to_color`.
1.21.4		Added particle types `block_crumble` and `trail`.
1.21.5	25w04a	The particle type `tinted_leaves` now has a parameter: `color`