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[edit]

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

Arguments[edit]

JE<name>: particle
BE: effect: string: basic_string

Specifies the particle to create.
In Bedrock Edition, it must be either a single word (no spaces) or a quoted string.
In Java Edition, it must be a namespaced ID of a particle followed by particle parameters that are particle-specific.
  • 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 has a parameter in namespaced_ID[block_state=foo] format to specify a block, in which block states can be omitted when unneeded. For example: /particle block minecraft:grass_block[snowy=true]
  • item requires a namespaced ID of an item as a parameter. For example: /particle item minecraft:apple

JE<pos>: vec3
BE: position: x y z: CommandPositionFloat

Specifies the position at which to create the particle. If not specified, defaults to the position of the executor.

JE: <delta>: vec3

Must be a three-dimensional coordinates with floating-point number elements. Accepts tilde and caret notations.
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.

JE: <speed>: float

Must be a Single-precision floating-point format number. And it must be greater than or equal to 0.0.
Specifies the speed of the particle. Does not work on all particles (Example: angry_villager).

JE: <count>: integer

Must be a 32-bit integer number. And it must be between 0 and 2147483647 (inclusive).
Specifies the number of particle effects to create. If 0, it results in a single particle. See the exceptions on <delta> for why having a <count> of 0 can be useful.

JE: force|normal

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.

JE: <viewers>: entity

Must be a player name, a target selector or a UUID. And the target selector must be of player type.
Allows control of which player should view this particle instead of everyone in the viewing range of the particle.

Result[edit]

CommandTriggerJava EditionBedrock Edition
anythe arguments are not specified correctly Unparseable Failed
if <targets> fails to resolve to one or more online players Failed N/A
if nobody can see the particle‌(s)
On successCreates the specified particle

Output[edit]

CommandEditionSituationSuccess Count/execute store succeess .../execute store result ...
anyJava EditionOn fail000
On success11the number of players who can see the particle(s)
Bedrock EditionOn fail0N/AN/A
On success0N/AN/A

Examples[edit]

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

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.