Commands/particle

From Minecraft Wiki
Jump to: navigation, search
particle
Restrictions

Operator

First introduced

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

Creates particles.

Syntax

Java Edition

particle <name> [<pos>] [<delta>] <speed> <count> [<mode>] [<viewers>]

Bedrock Edition

particle <effect: string> <position: x y z>
Color added to make reading easier.
Arguments
effect (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.
  • 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) (optional‌[JE only])
Specifies the position at which to create the particle. All values (including y) must be between -30,000,000 and 30,000,000 (inclusive, without the commas). May use tilde notation to specify a position relative to the command's execution.
delta (optional) ‌[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)
Exception 1: When name is entity_effect or ambient_entity_effect, a count of 0 will cause 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 will instead act as motion values for the particle, with speed acting as a multiplier. <dx>, <dy> and <dz> will instead become <motion:x>, <motion:y> and <motion:z> respectively.
Exception 3: When name is note, a count of 0 will cause <dx> to act as a color modifier, with speed acting as a multiplier. Starts at green with the hue moving backwards as this increments.
speed[Java Edition only]
Specifies the speed of the particle. Must be at least 0.
count[Java Edition only]
Specifies the number of particle effects to create. Must be at least 0 (which produces one particle).
mode (optional) ‌[Java Edition only]
Specifies the display mode: normal or force. Setting force will allow the particle(s) to be seen up to 256 blocks away and by players that use the minimal particles setting.
viewers (optional) ‌[Java Edition only]
Allows control of which player should view this particle instead of everyone in the viewing range of the particle.
Result
Fails if the arguments are not specified correctly.
On success, creates the specified particle.
Examples
Java Edition: To create a stationary huge explosion particle 10 blocks to the east:
/particle explosion_emitter ~10 ~ ~
Bedrock Edition: To create a stationary huge explosion particle 10 blocks to the east:
/particle minecraft:huge_explosion_emitter ~10 ~ ~

History[edit]


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 1.0.5.0Added /particle.
alpha 1.0.5.3Removed /particle.
Bedrock Edition
1.8.0beta 1.8.0.8Re-added /particle.
1.9.0beta 1.9.0.0Added several new particles for /particle.
1.12.0beta 1.12.0.2Added several new particles for /particle.