Editing MinecraftCommands (section)

=== particle ===

{{/infobox
|particle
|op
|1.8|14w04a
}}

Creates particles.

;Syntax

: <code>particle <''name''> <span style="background-color:#FDD"><''x''> <''y''> <''z''></span> <span style="background-color:#DDF"><''xd''> <''yd''> <''zd''></span> <''speed''> [''count''] [''mode''] [''player''] [''params ...'']</code>

: ''Color added to make reading easier.''

;Arguments

: ''name''
:: Specifies the particle to create. Must be a [[Particles#Particles|particle name]] (for example, <code>explode</code>).

: <span style="background-color:#FDD">''x y z''</span>
:: Specifies the position at which to create the particle. All values (including ''y'') must be between [[World boundary|-30,000,000 and 30,000,000]] (inclusive, without the commas). May use [[#Tilde notation|tilde notation]] to specify a position relative to the command's execution.

: <span style="background-color:#DDF">''xd yd zd''</span>
:: Specifies the size of the area to spawn particles in.

:: ''Exception:'' When ''name'' is <code>reddust</code>, <code>mobSpell</code>, or <code>mobSpellAmbient</code> and ''count'' is 0 or not specified, and ''speed'' is not 0, specifies the color of the particle in RGB format offset from the particle's default color (<code>reddust</code>'s default is a near-red (a random red tint between 0.8 and 1.0), while the others default to black). For example, with <code>reddust</code>, <code>0 0 0</code> produces a red particle, <code>-1 1 0</code> produces a green particle (red is reduced to 0 and green increased to 1), <code>0 0 1</code> produces a purple particle (blue is added to the original red), etc. With <code>mobSpell</code> or <code>mobSpellAmbient</code>, <code>0 0 0</code> produces a black particle, <code>0 1 0</code> produces a green particle, <code>0 0 0.5</code> produces a dark blue particle, etc. If ''count'' is greater than 0, colors are randomized.

: ''speed''
:: Specifies the speed of the particle. Must be at least 0.

: ''count'' (optional)
:: Specifies the number of particle effects to create. Must be at least 0 (which produces one particle).

: ''mode'' (optional)
:: Specifies the display mode. May be anything but only <code>force</code> will have an effect: to allow the particle(s) to be seen up to 256 blocks away and by players that use the minimal particles setting.

: ''player'' (optional)
:: Allows control of which player should view this particle instead of everyone in the viewing range of the particle.

: ''params'' (optional)
:: Allows <code>blockdust</code>, <code>iconcrack</code>, <code>blockcrack</code> and <code>fallingdust</code> to be modified to view a specific item or block. Two parameters are accepted for <code>iconcrack</code>.

::: For <code>blockdust</code>, <code>blockcrack</code> and <code>fallingdust</code>, the ''params'' argument specifies a [[Data values/Block IDs|numeric id]] (block only) and a data value, using a single number: id+(data×4096).

::: For <code>iconcrack</code>, two ''params'' arguments specify the numeric id ([[Data values/Block IDs|block id]] or [[Data values/Item IDs|item id]]) and the data value separately.

;Result

: Fails if the arguments are not specified correctly.

: On success, creates the specified particle.

;Examples

: To create a stationary huge explosion particle 10 blocks to the east:
:: <code>particle hugeexplosion ~10 ~ ~ 0 0 0 0</code>


<!-- please retain double newline above for section differentiation -->