> For the complete documentation index, see [llms.txt](https://cosmetics.advancedplugins.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cosmetics.advancedplugins.net/cosmetics-system/particles.md).

# Particles

Simple particle cosmetics create basic particle effects around the player. You can customize the particle type, amount, radius, and activation conditions.

```yaml
enabled: true
name: "&dEnchanted Aurora"
description: "Magical swirls around your feet."

item:
  type: ENCHANTED_BOOK

type: PARTICLE
particle: ENCHANT
amount: 8
radius: 1.0
frequency: 12
location: FEET
activation: MOVING
```

**Configuration Options:**

* enabled: Enables or disables the cosmetic.
* name: The display name of the cosmetic item.
* description: The description of the cosmetic item.
* item: Defines the item used to represent the cosmetic in menus.
  * type: The Material of the item.
* type: Specifies the cosmetic type as PARTICLE.
* particle: The Particle type to use. Refer to the Spigot documentation for available particle types.
* amount: The number of particles to spawn.
* radius: The radius around the player in which the particles are spawned.
* frequency: The interval (in ticks) at which the particle effect is updated.
* location: The location relative to the player where the particles are spawned (e.g., FEET, HEAD).
* activation: When the particle effect should be active (e.g., MOVING, STANDING, ALWAYS).