From Minecraft Wiki
Jump to: navigation, search


First introduced

Java Edition 1.8 (14w04a)
PE 1.0.5 (PE alpha

Creates particles.


  • Java Edition
particle <name> [<parameters>] [<pos>] [<delta>] <speed> <count> [force|normal] [<viewers>]
  • Bedrock Edition
particle <effect: string> <position: x y z>


<name> (BE: effect: string)

Specifies the particle to create. Must be a particle name (for example, explosion). For Java Edition:
  • dust requires three color channel parameters to be set along with the name, representing red, green, and blue, each being a value in the range 0 to 1; and an additional parameter representing size. For example: /particle dust 1.0 0.5 0.5 1.0 creates a pink particle at regular size. If one or more values are greater than 1, the particles change their colors. The greater the values the greater is the range of different colors.
  • block and falling_dust require a block and an optional state as a parameter. For example: /particle block minecraft:grass_block[snowy=true]
  • item requires an item name as a parameter. For example: /particle item minecraft:apple

<pos> (BE: position: x y z)

Specifies the position at which to create the particle. May use tilde and caret notation to specify a position relative to the command's execution.

<delta>[Java Edition only]

Specifies the size of the 3-dimensional cuboid volume to spawn particles in, centered on position pos, and multiplied by about 8 (using 1 1 1 specifies a cuboid of about 8×8×8 in size). Negative values may be used, but have the same effect as their positive counterparts (using -1 -1 -1 still equates to an 8×8×8 cuboid). Note that the generated particles aren't evenly distributed over the cuboid, instead it uses a Gaussian distribution resulting in a particle-gradient most dense at the center. Tilde and caret notation may be used, the resulting coordinates are then used as delta.
Exception 1: When name is entity_effect or ambient_entity_effect, a count of 0 causes the delta and speed to act like RGBE values instead, ranging from 0.0 to 1.0.
Exception 2: When count is set to 0, the delta instead acts as motion values for the particle, with speed acting as a multiplier. <dx>, <dy> and <dz> instead becomes <motion:x>, <motion:y> and <motion:z> respectively. Particles that don't have any motion to begin with are not affected by this (Example: barrier).
Exception 3: When name is note, a count of 0 causes <dx> to act as a color modifier, with speed acting as a multiplier. Starts at green with the hue moving backward as this increments.

<speed>[Java Edition only]

Specifies the speed of the particle. Must be at least 0. Does not work on all particles (Example: angry_villager).

<count>[Java Edition only]

Specifies the number of particle effects to create. Must be at least 0, which results in a single particle. See the exceptions on delta for why having a count of 0 can be useful.

force|normal[Java Edition only]

Specifies the display mode: normal or force. Setting force allows the particle(s) to be seen up to 256 blocks away and by players that use the minimal particles setting.

<viewers>[Java Edition only]

Allows control of which player should view this particle instead of everyone in the viewing range of the particle.
Must be a player name or a target selector.
Entities other than players are not allowed.


Fails if the arguments are not specified correctly, if nobody can see the particle‌[Java Edition only].

On success, creates the specified particle.


To create a stationary huge explosion particle 10 blocks to the east:


Java Edition
1.814w04aAdded /particle.
14w29aAdded force argument to /particle.
1.915w49aAdded player and params tag to /particle.
1.1317w47aParticle names have been changed for /particle.
18w03aAdded the /particle <name> <pos> shortcut.
Pocket Edition
1.0.5alpha /particle.
alpha /particle.
Bedrock Edition
1.8.0beta /particle.
1.9.0beta several new particles for /particle.
1.12.0beta several new particles for /particle.