Skip to content

particles · Changes

Page history
Update particles authored by Lxlp's avatar Lxlp
Hide whitespace changes
Inline Side-by-side
skills/effects/particles.md
View page @ ba81acf2
Effect: Particles ## Description
----
Creates a particle effect at the targeted entity or location. Creates a particle effect at the targeted entity or location.
A list of particle types can be found [here](/skills/effects/particles/types). A list of particle types can be found **[here](/skills/effects/particles/types)**.
[All of the spigot particle effects listed in the javadocs should be acceptable as well.](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html) [All of the spigot particle effects listed in the javadocs should be acceptable as well.](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html)
Added in 4.11:
* Added dir=x,y,z option to particle effects to specify directional vector
* Added audience=\[world/target/caster\] options to all particle effects
Added in 4.12 (Premium Only!): Added in 4.12 (Premium Only!):
* Added special type particle=mob on all particle effects * Added special type particle=mob on all particle effects
* You can then specify a MythicMob using mob=\[type\] * You can then specify a MythicMob using mob=\[type\]
* This is a hacky way for you to use mobs as "particles" in effects using no-tick ArmorStands wearing models or using font characters. You can use things other than ArmorStands if you want, but we don't recommend it for performance. * This is a hacky way for you to use mobs as "particles" in effects using no-tick ArmorStands wearing models or using font characters. You can use things other than ArmorStands if you want, but we don't recommend it for performance.
### Attributes ## Attributes
----
### General Attributes
#### General Attributes
| Attribute | Aliases | Description | Default |
| Attribute | Aliases | Description | Default Value | |-----------|-----------|----------------------------------------------------------------------|---------|
| ------ | ------ | ------ | ------ | | particle | p | The particle type to use. See list here. | reddust |
| particle | p | The particle type to use. See list here. | reddust | | material | m | Block or Item to use with block_crack or item_crack respectively |
| material | m | Block or Item to use with block_crack or item_crack respectively | | mob | m, t | The entity to spawn as the particle. Cannot be the original entity. **Premium Only**. | |
| mob | | The entity to spawn as the particle. Cannot be the original entity | | amount | count, a | The number of particles to create | 10 |
| amount | a | The number of particles to create | 10 | | spread | offset | The vertical spread of the particles | 0 |
| hSpread | hs | The horizontal spread of the particles | 0 | | hSpread | hs | The horizontal spread of the particles | 0 |
| vSpread | vs | The vertical spread of the particles | 0 | | vSpread | vs, yspread, ys| The spread of the particles on the y axis. Overwrites `spread` | spread |
| speed | s | The “speed” of the particles | 0 | | xSpread | xs | The spread of the particles on the x axis. Overwrites `hSpread` on that axis | hSpread |
| yOffset | y | The Y offset of the particles from the target | 0 | | zSpread | zs | The spread of the particles on the z axis. Overwrites `hSpread` on that axis | hSpread |
| viewDistance | vd | The distance the particles are rendered | 128 | | speed | s | The “speed” of the particles | 0 |
| Size | | The size of the particles displayed | 1 | | yOffset | y | The Y offset of the particles from the target | 0 |
| color | c | [(1)](/wikis/skills/effects/particles "only works on colorable particle types like “reddust”")[(2)](/wikis/skills/effects/particles "color must be provided in hex-code") The color of the particle | | | viewDistance | vd | The distance the particles are rendered | 128 |
| fromorigin | fo | | false | | size | | The size of the particles displayed | 1 |
| directional | d | Does the particle use directional travel | false | | color | c | [(1)](/wikis/skills/effects/particles "only works on colorable particle types like “reddust”")[(2)](/wikis/skills/effects/particles "color must be provided in hex-code") The color of the particle | |
| directionReversed | | Reverses the direction of the particles. | false | | fromorigin| fo | Should the particles be generated from the origin of the mechanic | false |
| direction | dir | Specifies a vector for the particles to move towards. | 0,0,0 (x,y,z) | | directional| d | Does the particle use directional travel | false |
| directionReversed| dr | Reverses the direction of the particles. | false |
#### Entity-Only Attributes | direction | dir | Specifies a vector for the particles to move towards. | 0,0,0 (x,y,z) |
| Attribute | Aliases | Description | Default Value |
|-----------------|----------|-------------|---------------|
| useEyeLocation | uel | (true/false) Whether to base the particles on the entity's eyes | false |
| forwardOffset | | The forward-offset from the targeted entity,doesn'n work when set directional to true | 0 |
| sideOffset | so | The side-offset from the targeted entity,doesn'n work when set directional to true | 0 |
#### Dust_color_transition-Specific Attributes
| Attribute | Aliases | Description |
|-----------|---------|----------------------------------------|
| color1 | | The color the particles starts as |
| color2 | | The color the particles transitions to |
#### Particle Colors #### Particle Colors
As of MythicMobs version 2.3, some particles effects (mobSpell, mobSpellAmbient, and reddust) can be colored by using an additional “color=hexcode” argument. Hexcodes for coloring particles can be found here: [Hex Colors](http://www.color-hex.com/) From MM Version 2.5.0+ and Minecraft version 1.10 onwards, fallingdust also may use the color option. As of MythicMobs version 2.3, some particles effects (mobSpell, mobSpellAmbient, and reddust) can be colored by using an additional “color=hexcode” argument. Hexcodes for coloring particles can be found here: [Hex Colors](http://www.color-hex.com/) From MM Version 2.5.0+ and Minecraft version 1.10 onwards, fallingdust also may use the color option.
```yaml
- effect:particles{p=reddust;color=#FF00FF} - effect:particles{p=reddust;color=#FF00FF}
```
### Mob-Type Particles #### Mob-Type Particles \[**Premium Only**\]
This particle type will replace the spawned particle with the selected entity. The entity will act as a normal one, being able to attack, be hit, activate skills and so on. The entity will have no parent/owner relationship with the caster. This particle type will replace the spawned particle with the selected entity. The entity will act as a normal one, being able to attack, be hit, activate skills and so on. The entity will have no parent/owner relationship with the caster.
### Examples ### Entity-Only Attributes
----
Skills: | Attribute | Aliases | Description | Default |
- effect:particles{particle=flame;amount=200;hS=1;vS=1;speed=5} @self |-----------|-----------|----------------------------------------------------------------------|---------|
- ... | useEyeLocation | uel | (true/false) Whether to base the particles on the entity's eyes | false |
| forwardOffset | startfoffset, sfo | The forward-offset from the targeted entity,doesn'n work when set directional to true | 0 |
Skills: | sideOffset| so | The side-offset from the targeted entity,doesn'n work when set directional to true | 0|
- effect:particles{particle=block;m=dirt;amount=100;hS=1;vS=1} @self
- ... ### Dust_color_transition-Specific Attributes
Skills: | Attribute | Aliases | Description | Default |
- particles{particle=flame;a=10;hs=0.3;vs=0.3;y=0.3;s=0.1125} @self |-----------|-----------|----------------------------------------------------------------------|---------|
- ... | color1 | | The color the particles starts as | |
\ No newline at end of file | color2 | | The color the particles transitions to | |
## Examples
```yaml
Skills:
- effect:particles{particle=flame;amount=200;hS=1;vS=1;speed=5} @self
- ...
```
```yaml
Skills:
- effect:particles{particle=block;m=dirt;amount=100;hS=1;vS=1} @self
- ...
```
```yaml
Skills:
- particles{particle=flame;a=10;hs=0.3;vs=0.3;y=0.3;s=0.1125} @self
- ...
```
## Aliases
- [x]
- [x]
\ No newline at end of file