The effects.yml file defines custom particle shapes and patterns that can be used in skills. These shapes are generated using math formulas and are most useful for creating dynamic visuals like spirals, rings, explosions, and more.

File location:

/plugins/Fabled/effects.yml

⚠️ Important: effects.yml is only used by the Particle Projectile mechanic.

To use a custom effect shape from this file:

1. Create the shape in effects.yml
2. In the skill editor, go to:

   Mechanic → Particle Projectile → Effects
   

3. In the effects: field, enter the name of the effect (e.g. spiral-up, circle-flat)

effects: spiral-up
effect-time: 20
effect-interval: 1
effect-delay: 0
effect-speed: 1
effect-forward: 0
effect-upward: 0.2

🧪 Test effects by using visible projectiles and debug messages in your skills.

Each effect shape uses this structure:

<effect-name>:
  steps: <number>
  copies: <number>
  domain: <range>
  x: "<math expression>"
  y: "<math expression>"
  z: "<math expression>"

• steps: Number of points to plot in the shape
• copies: Rotated or repeated versions (for symmetry)
• domain: How wide the range of angles/inputs is (usually 360)
• x/y/z: Math formulas that define the shape's 3D coordinates

Click a category to browse full examples:

• 🔵 Circular & Radial Effects
• 🔺 Geometric Shapes
• 🧊 3D Effects & Structures
• 🌊 Animated Waves & Pulses
• 🔥 Combat Trails & Bursts
• 🌀 Magic, Auras & Energy Fields
• 💫 Symbols & Decorative Patterns

You can define unlimited shapes, and reuse them across multiple skills.

• Creating Skills
• Conditions & Mechanics
• Formulas & Scaling