Minecraft:Commands/particle

Template:Infobox command Creates Minecraft:particles.

Syntax

• Java Edition

particle <name> [<pos>]

particle <name> <pos> <delta> <speed> <count> [force|normal] [<viewers>]

• Bedrock Edition

particle <effect: string> [position: x y z]

Arguments

Specifies the particle type to create.

Template:Arg desc

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

Template:Arg desc

Template:El: Template:Argument

Specifies the number of particle effects to create. If 0, see below for what it results in.

Template:Arg desc

Template:El: Template:Argument — Template:Arg desc
Template:El: Template:Argument — Template:Arg desc

Template:Cd and Template:Cd parameters determine where the particles are created and the parameters to pass into the particles (see the table Extra parameters of particle types below). Based on whether Template:Cd is 0 or not, the two parameters have different meanings.

• if Template:Cd is 0, creates a single particle at the Template:Cd. Multiplies each of the three values inTemplate:Cd by Template:Cd value, then passes them into the particles as three parameters.
  • This means that for most particles that receive parameters, if Template:Cd is 0, the <delta> acts as motion values for the particle, with <speed> acting as a multiplier, so the particle move in the direction of <delta>.
• If Template:Cd is not 0, the specified count of particles are created at random positions. The positions obey normal distributions in each of the X, Y, and Z directions. Each normal distribution has a mean value of each value in Template:Cd, meaning that particles are more likely to be created closer to the Template:Cd. Each normal distribution has a standard deviation of each value in Template:Cd (e.g. 1 1 1 means that the coordinates on X, Y, and Z axes obey three standard normal distributions, meaning that there is a 99.7% probability that the particle is created in a 6×6×6 cuboid region centered at the Template:Cd; 2 2 2 means that the particle has a 99.7% probability of being created in a 12×12×12 cuboid region centered at the Template:Cd). Negative values are accepted in Template:Cd, but have the same effect as their positive counterparts (e.g. -1 -1 -1 has the same effect as 1 1 1). Each of the extra parameters to be passed into the particles also follows a normal distribution, with a mean of 0 and a standard deviation of each value in Template:Cd.

Template:Cd accepts relative coordinates and local coordinates, which are converted to absolute coordinates, so relative coordinates and local coordinates are generally useless here.

If not specified, Template:Cd defaults to 0 0 0; Template:Cd defaults to 0.

Template:El: Template:Cd

Specifies the display mode: normal or force.

normal: The particle(s) are sent to players within 32.0 blocks (exclusive), may not be shown if the "Particles" option in Video Settings is "Minimal" (depending on the particle type, some particle types still displays when it is "Minimal")

force: Allows the particle(s) to be sent to players within 512.0 blocks (exclusive). Always shown even if the "Particles" option in Video Settings is "Minimal".

Defaults to the normal mode.

Template:El: Template:Argument

Allows control of which player should view this particle instead of everyone in the viewing range of the particle.

Template:Arg desc

Examples

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

• Template:JE: /particle minecraft:explosion_emitter ~10 ~ ~
• Template:BE: /particle minecraft:huge_explosion_emitter ~10 ~ ~

Using the Minecraft:particle format arguments in Template:El to create purple dust with large particles:

• /particle minecraft:dust{color:[1, 0, 1], scale:4} ~ ~ ~ 1 1 1 1 10

Using the <delta> and <speed> arguments to pass parameters to the command and make a single particle move downward (note that count must be zero):

• /particle minecraft:white_smoke ^ ^1 ^2 0 -1 0 0.1 0

The same command with <count> nonzero instead uses <delta> to determine particle distribution, producing a vertical cloud of particles:

• /particle minecraft:white_smoke ^ ^1 ^2 0 -1 0 0.1 10

History

External links

• Template:Cite