> For the complete documentation index, see [llms.txt](https://m3ii0.gitbook.io/magicalwands/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://m3ii0.gitbook.io/magicalwands/custom-charm-creation/particle-effects.md).

# Particle effects

## Static particle effect

```yaml
# Spawn static colored particle
Static:

  # Define where should particle spawn
  # Values:
  #   > DEALER - Entity who used charm
  #   > DAMAGED - Primary damaged entity
  Target: DEALER
  
  # Define color for particle
  # NOTE: This animation is not supporting Gradient or Multiple effect color!
  Color: "#ffffff"
  
  # Define size of particle
  # NOTE: Default = 1.0
  Size: 10.0
  
  # Amount of particles
  # NOTE: Default = 1
  Amount: 10
  
  # Offset for Y
  # NOTE: Starting on target's location
  Y_Offset: 0.8
```

## Circle particle effect

```yaml
# Spawn static circle around target
Circle:

  # Define where should particle spawn
  # Values:
  #   > DEALER - Entity who used charm
  #   > DAMAGED - Primary damaged entity
  #   > ALL - Every entity (Can be used only if effect contains Radius parameter)
  Target: DEALER
  
  # Define color for particle
  # NOTE: This animation supports Gradient and Multiple color particles
  # Examples:
  #
  #  > Multiple colors -> #ffffff,#000000,...
  #    - Insert how many colors do you like to have
  #
  #  > Gradient effect -> Gradient(#ffffff,#000000,10)
  #    - Insert first color, second color and number of colors in transition
  Color: "#ffffff"
  
  # Difference between particles
  # NOTE: Don't set this value too low, can affect server performance
  Density: 0.5
  
  # Define size of circle around the targer
  # NOTE: Don't set this value too high, can affect server performance
  Radius: 5
  
  # Define size of particle
  # NOTE: Default = 1.0
  Size: 10.0
  
  # Amount of particles
  # NOTE: Default = 1
  Amount: 10
  
  # Offset for Y
  # NOTE: Starting on target's location
  Y_Offset: 0.8
```

## Pointing line particle effect

```yaml
# Create straight line in front of player
PointingLine:

  # Define where should particle spawn
  # Values:
  #   > DEALER - Entity who used charm
  Target: DEALER
  
  # Define color for particle
  # NOTE: This animation supports Gradient and Multiple color particles
  # Examples:
  #
  #  > Multiple colors -> #ffffff,#000000,...
  #    - Insert how many colors do you like to have
  #
  #  > Gradient effect -> Gradient(#ffffff,#000000,10)
  #    - Insert first color, second color and number of colors in transition
  Color: "#ffffff"
  
  # Number of blocks (Length of the line)
  # NOTE: Don't set this value too high, can affect server performance
  Length: 10
  
  # Define size of particle
  # NOTE: Default = 1.0
  Size: 10.0
  
  # Amount of particles
  # NOTE: Default = 1
  Amount: 10
  
  # Offset for Y
  # NOTE: Starting on target's location
  Y_Offset: 0.8
```

## Ripple pointing line particle effect

```yaml
# Create random curved line in front of player
RipplePointingLine:

  # Define where should particle spawn
  # Values:
  #   > DEALER - Entity who used charm
  Target: DEALER
  
  # Define color for particle
  # NOTE: This animation supports Gradient and Multiple color particles
  # Examples:
  #
  #  > Multiple colors -> #ffffff,#000000,...
  #    - Insert how many colors do you like to have
  #
  #  > Gradient effect -> Gradient(#ffffff,#000000,10)
  #    - Insert first color, second color and number of colors in transition
  Color: "#ffffff"
  
  # Number of blocks (Length of the line)
  # NOTE: Don't set this value too high, can affect server performance
  Length: 10
  
  # Define size of particle
  # NOTE: Default = 1.0
  Size: 10.0
  
  # Amount of particles
  # NOTE: Default = 1
  Amount: 10
  
  # Offset for Y
  # NOTE: Starting on target's location
  Y_Offset: 0.8
```

## Rotated sprial particle effect

```yaml
# Create spiral incoming into the target
RotatedSpiral:

  # Define where should particle spawn
  # Values:
  #   > DEALER - Entity who used charm
  #   > DAMAGED - Primary damaged entity
  #   > ALL - Every entity (Can be used only if effect contains Radius parameter)
  Target: DEALER
  
  # Define color for particle
  # NOTE: This animation supports Gradient and Multiple color particles
  # Examples:
  #
  #  > Multiple colors -> #ffffff,#000000,...
  #    - Insert how many colors do you like to have
  #
  #  > Gradient effect -> Gradient(#ffffff,#000000,10)
  #    - Insert first color, second color and number of colors in transition
  Color: "#ffffff"
  
  # Define size of circle around the target
  # NOTE: Don't set this value too high, can affect server performance
  Radius: 5
  
  # Define size of particle
  # NOTE: Default = 1.0
  Size: 10.0
  
  # Amount of particles
  # NOTE: Default = 1
  Amount: 10
  
  # Offset for Y
  # NOTE: Starting on target's location
  Y_Offset: 0.8
```

## Wave Effect

```yaml
# Create spiral incoming into the target
Wave:

  # Define where should particle spawn
  # Values:
  #   > DEALER - Entity who used charm
  Target: DEALER
  
  # Define color for particle
  # NOTE: This animation supports Gradient and Multiple color particles
  # Examples:
  #
  #  > Multiple colors -> #ffffff,#000000,...
  #    - Insert how many colors do you like to have
  #
  #  > Gradient effect -> Gradient(#ffffff,#000000,10)
  #    - Insert first color, second color and number of colors in transition
  Color: "#ffffff"
  
  # Define size of circle around the target
  # NOTE: Don't set this value too high, can affect server performance
  Radius: 5
  
  # Difference between particles
  # NOTE: Don't set this value too low, can affect server performance
  Density: 0.05
  
  # Define size of particle
  # NOTE: Default = 1.0
  Size: 10.0
  
  # Amount of particles
  # NOTE: Default = 1
  Amount: 10
  
  # Offset for Y
  # NOTE: Starting on target's location
  Y_Offset: 0.3
```

## Lightning effect

```yaml
Lightning:

  # Define where should particle spawn
  # Values:
  #   > DEALER - Entity who used charm
  #   > DAMAGED - Primary damaged entity
  #   > ALL - Every entity (Can be used only if effect contains Radius parameter)
  Target: DEALER
  
  # This value is optional (Use it when you're using ALL Target value)
  Radius: 5
```

## Explosion effects

```yaml
Explosion:

  # Define where should particle spawn
  # Values:
  #   > DEALER - Entity who used charm
  #   > DAMAGED - Primary damaged entity
  #   > ALL - Every entity (Can be used only if effect contains Radius parameter)
  Target: DAMAGED
  
  # This value is optional (Use it when you're using ALL Target value)
  Radius: 5
  
  # Offset for Y
  # NOTE: Starting on target's location
  Y_Offset: 0.8
```

## Vertical line particle effect

<pre class="language-yaml"><code class="lang-yaml"># Creates line above entity
<strong>VerticalLine:
</strong>
  # Define where should particle spawn
  # Values:
  #   > DEALER - Entity who used charm
  #   > DAMAGED - Primary damaged entity
  #   > ALL - Every entity (Can be used only if effect contains Radius parameter)
  Target: DEALER
  
  # Height of line in blocks (Y)
  Height: 8
  
  # Define size of particle
  # NOTE: Default = 1.0
  Size: 10.0
  
  # Amount of particles
  # NOTE: Default = 1
  Amount: 10
  
  # This value is optional (Use it when you're using ALL Target value)
  Radius: 5
</code></pre>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://m3ii0.gitbook.io/magicalwands/custom-charm-creation/particle-effects.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.