> For the complete documentation index, see [llms.txt](https://zypec.gitbook.io/particles/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zypec.gitbook.io/particles/effects/creating-effect/script-types/particle/single-particle.md).

# Single Particle

This page was last updated for version v1.4.1

## Format

`particle [args]` or `single [args]`

## Arguments

<table data-card-size="large" data-view="cards"><thead><tr><th>Arg</th><th>Description</th><th>Format</th><th>Example(s)</th><th>Default Value</th><th>Exclusive</th><th data-type="checkbox">Required</th><th>Aliases</th></tr></thead><tbody><tr><td>effect</td><td><a href="/particles/effects/creating-effect/script-types/particle/particles.md">particle</a> name</td><td><code>effect=&#x3C;PARTICLE></code></td><td><code>effect=minecraft:dust</code></td><td>*</td><td>*</td><td>true</td><td>particle</td></tr><tr><td>origin</td><td>where the particle spawns from<br><em>(you can multiply the origin by adding <code>*</code>)</em></td><td><code>origin=&#x3C;HEAD/FEET/WORLD></code></td><td><code>origin=feet</code>, <code>origin=head*-1.25</code></td><td>*</td><td>*</td><td>true</td><td>*</td></tr><tr><td>position</td><td>particle location</td><td><code>pos={x=...;y=...;z=...}</code></td><td><code>pos={x={x};y=2;z={z}}</code></td><td>*</td><td>*</td><td>false</td><td>pos</td></tr><tr><td>offset</td><td>particle offset</td><td><code>offset={x=...;y=...;z=...}</code></td><td><code>offset={x={x};z={z}}</code></td><td>*</td><td>*</td><td>false</td><td>*</td></tr><tr><td>directional</td><td>rotates the effect to the player's direction</td><td><code>directional=&#x3C;BOOLEAN></code></td><td><code>directional=true</code></td><td>false</td><td>*</td><td>false</td><td>direction</td></tr><tr><td>billboard</td><td>rotates the effect in given orientation by player's direction</td><td><code>billboard=&#x3C;HORIZONTAL/VERTICAL/BOTH></code></td><td><code>billboard=vertical</code>, <code>billboard=both</code></td><td>*</td><td>*</td><td>false</td><td>*</td></tr><tr><td>color-scheme</td><td>color scheme name or hex color code</td><td><em>see</em> <a href="/particles/effects/creating-effect/script-types/particle/color-format.md"><em>Color Format</em></a></td><td><em>see</em> <a href="/particles/effects/creating-effect/script-types/particle/color-format.md"><em>Color Format</em></a></td><td>*</td><td>*</td><td>false</td><td>color</td></tr><tr><td>speed</td><td>particle speed</td><td><code>speed=&#x3C;RANGE></code></td><td><code>speed=2.5</code>, <code>speed={var}</code></td><td>1</td><td>*</td><td>false</td><td>*</td></tr><tr><td>size</td><td>particle size</td><td><code>size=&#x3C;RANGE></code></td><td><code>size=1.5</code>, <code>size={val={var};min=0;max=2}</code></td><td>1</td><td><code>dust_color_transition</code><em>,</em> <code>redstone</code></td><td>false</td><td>*</td></tr><tr><td>amount</td><td>particle amount</td><td><code>amount=&#x3C;INTEGER></code></td><td><code>amount=10</code>, <code>amount={var}</code></td><td>1</td><td>*</td><td>false</td><td>*</td></tr><tr><td>block</td><td>block data<br><em>- material:</em> <a href="https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html"><em>Material</em></a></td><td><code>block={material=&#x3C;MATERIAL>}</code></td><td><code>block={material=red_wool}</code></td><td>Optional</td><td><code>block_crack</code>, <code>block_dust</code>, <code>block_marker</code>, <code>falling_dust</code></td><td>false</td><td>*</td></tr><tr><td>item</td><td>item data<br>- <em>material:</em> <a href="https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html"><em>Material</em></a><br><em>- data: Custom Model Data</em></td><td><code>item={material=&#x3C;MATERIAL>;data=&#x3C;INTEGER>}</code></td><td><code>block={material=paper;data=1}</code></td><td>*</td><td><code>item_crack</code></td><td>false</td><td>*</td></tr><tr><td>roll</td><td>roll data</td><td><code>roll=&#x3C;FLOAT></code></td><td><code>roll=0.1</code></td><td>*</td><td><code>sculk_charge</code></td><td>false</td><td>*</td></tr><tr><td>delay</td><td>delay data</td><td><code>delay=&#x3C;INTEGER></code></td><td><code>delay=10</code></td><td>*</td><td><code>shriek</code></td><td>false</td><td>*</td></tr><tr><td>long-distance</td><td>particle render radius<br>• 512 blocks when true<br>• 32 blocks when false</td><td><code>long-radius=&#x3C;BOOLEAN></code></td><td><code>long-radius=true</code></td><td>false</td><td>*</td><td>false</td><td>long</td></tr><tr><td>spawn-effect-on-player</td><td>spawns the particles on player if true, otherwise particles will be spawned on target entity<br><br><em>for example, if you set this option to true and use it with<code>mob_damage</code> event, particles will be spawned on attacker player instead of damaged entity</em></td><td><code>spawn-effect-on-player=&#x3C;BOOLEAN></code></td><td><code>on-player=false</code></td><td>true</td><td>*</td><td>false</td><td>on-player</td></tr><tr><td>entity-type-filter</td><td>spawns the particles only if target entity matches with entity type filter<br><em>- entity:</em> <a href="https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html"><em>Entity Type</em></a><br><br><em>for example, if you set the filter to trident and use it with <code>projectile</code> event, particles will only be spawned when player throws a trident</em></td><td><code>entity-type-filter=&#x3C;ENTITY></code></td><td><code>entity-type-filter=TRIDENT</code></td><td>*</td><td>*</td><td>false</td><td>*</td></tr></tbody></table>