Effects

This file is where you define all the cosmetic particle effects that players can purchase and equip from the Effect Shop GUI.

Effect Structure

effect requires a unique ID, which is used internally by the plugin. This ID should be simple and descriptive (e.g., flame_trail, rainbow_dust).

unique_effect_id:
  name: "&#FF8800&lFlame Trail"
  material: BLAZE_POWDER
  description:
    - "&7Soar through the sky"
    - "&7  with a fiery trail."
  price: 25000
  particle: FLAME
  # (Optional) A section for advanced particle customization.
  particle-options: { ... }

Main Keys

Key	Description
name	The display name of the effect in the GUI. Supports & and &#RRGGBB color codes.
material	The icon that represents this effect in the GUI.
description	The lore text that describes the effect in the GUI.
price	The in-game money cost for a player to unlock this effect.
particle	The name of the particle to be used. A full list of valid particle names can be found on the Spigot Javadocs.

Particle Options

The particle-options section allows for fine-tuning the behavior of the selected particle.

Option	Description	Applicable Particles
count	The number of particles to spawn in each interval.	Most particles
speed	The velocity or spread of the particle. A value of 0 often makes particles stationary.	Most particles
size	The size of the particle. Can be a single value (size: 1.0) or a random range (size: "0.8-1.5").	DUST_COLOR_TRANSITION, REDSTONE
color	A specific color for the particle, written in HEX format (color: "#00FF00").	REDSTONE, SPELL_MOB, SPELL_MOB_AMBIENT
random-color	If true, the particle will spawn with a random color each time.	REDSTONE, NOTE
from-color	The starting color for a transitioning particle, in HEX format.	DUST_COLOR_TRANSITION only
to-color	The ending color for a transitioning particle, in HEX format.	DUST_COLOR_TRANSITION only

---

Particle Option Examples

Complex Example (Rainbow Dust)

This example uses the DUST_COLOR_TRANSITION particle. It defines a particle that transitions from red (#FF0000) to blue (#0000FF), spawns 3 particles at a time, and has a size that varies randomly between 0.8 and 1.5.

rainbow_dust:
  name: "&#FF5555&lʀ&#FF8855&lᴀ&#FFBB55&lɪ&#DDFF55&lɴ&#AAFF55&lʙ&#55FF55&lᴏ&#55FF88&lw &#55FFBB&lᴅᴜsᴛ"
  material: SUGAR
  price: 50000
  particle: DUST_COLOR_TRANSITION
  particle-options: { count: 3, from-color: "#FF0000", to-color: "#0000FF", size: "0.8-1.5" }

Random Color Example (Musical Notes)

This example uses the NOTE particle. By setting random-color: true, each note particle will appear with a different, random color, creating a vibrant musical trail.

musical_notes:
  name: "&#DDDD33&lᴍᴜsɪᴄᴀʟ ɴᴏᴛᴇs"
  material: NOTE_BLOCK
  price: 26000
  particle: NOTE
  particle-options:
    random-color: true
    speed: 0