Wand Examples

Examples

Use these examples as templates when creating your own wand files. You can start simple with fixed values, then move into expressions and merge chains.

---

Basic Wand Example

basic-wand.yml

display-name: '&6[&e!&6] &eBasic Wizard Wand &7(Right-Click)'

lore:
  - ''
  - '&eInformation'
  - ' &6 → &eDamage: &f%damage%'
  - ' &6 → &eAttack Speed: &f%attack_speed%'
  - ' &6 → &eRange: &f%range% block(s)'
  - ' &6 → &eCooldown: &f%cooldown%s'
  - ' &6 → &eUses: &7%remaining_uses%&8/&7%max_uses%'
  - ''
  - '&6Description'
  - '&7Right click this wand towards a mob'
  - '&7for it to deal &f&odamage&7.'
  - ''
  - '&7&o(( Right-Click this &f&owand&7&o to use it! ))'

material: BLAZE_ROD
custom-model-data: 0

damage: "5.0"
attack-speed: "1.0"
min-range: 1.0
max-range: 15.0
cooldown-ms: 1000
max-uses: "10"

hologram:
  enabled: true
  format: "&c&l-%damage%"
  style: modern
  offset:
    x: 0.0
    y: 1.0
    z: 0.0
  random-offset:
    x: 0.2
    y: 0.0
    z: 0.2

visuals:
  trail:
    enabled: true
    particle-type: CRIT
    particle-count: 3
    particle-speed: 0.1

  hit:
    enabled: true
    particle-type: CRIT
    particle-count: 15
    particle-speed: 0.5

sounds:
  activation:
    enabled: true
    sound: ENTITY_BLAZE_SHOOT
    volume: 0.5
    pitch: 1.2

  hit:
    enabled: true
    sound: ENTITY_EXPERIENCE_ORB_PICKUP
    volume: 0.7
    pitch: 1.0

merge:
  enabled: true
  required-type: basic-wand
  result-type: advanced-wand
  requirement: ""

---

Advanced Wand Example

This example uses expressions so the wand scales with player placeholders.

advanced-wand.yml

display-name: '&3[&b!&3] &bAdvanced Wizard Wand &7(Right-Click)'

lore:
  - ''
  - '&bInformation'
  - ' &3 → &bDamage: &f%damage%'
  - ' &3 → &bAttack Speed: &f%attack_speed%'
  - ' &3 → &bRange: &f%range% block(s)'
  - ' &3 → &bCooldown: &f%cooldown%s'
  - ' &3 → &bUses: &7%remaining_uses%&8/&7%max_uses%'
  - ''
  - '&3Description'
  - '&7Right click this wand towards a mob'
  - '&7for it to deal &f&odamage&7.'
  - ''
  - '&7&o(( Right-Click this &f&owand&7&o to use it! ))'

material: BLAZE_ROD
custom-model-data: 0

damage: "12.0 + %player_level% * 0.3"
attack-speed: "1.2"
min-range: 1.0
max-range: 20.0
cooldown-ms: 800
max-uses: "200 + %player_level% * 5"

hologram:
  enabled: true
  format: "&d&l✦ %damage% ✦"
  style: phantom
  offset:
    x: 0.0
    y: 1.2
    z: 0.0
  random-offset:
    x: 0.25
    y: 0.05
    z: 0.25

visuals:
  trail:
    enabled: true
    particle-type: SPELL_WITCH
    particle-count: 5
    particle-speed: 0.2

  hit:
    enabled: true
    particle-type: SPELL_WITCH
    particle-count: 20
    particle-speed: 0.7

sounds:
  activation:
    enabled: true
    sound: ENTITY_ENDER_DRAGON_FLAP
    volume: 0.6
    pitch: 1.4

  hit:
    enabled: true
    sound: ENTITY_PLAYER_LEVELUP
    volume: 0.8
    pitch: 1.2

merge:
  enabled: false
  required-type: ""
  result-type: ""
  requirement: ""

---

Expression Support

The following fields support expressions:

• damage

• attack-speed

• max-uses

That means you can use:

• fixed values like "5.0"

• math expressions like "10 + 2 * 3"

• PlaceholderAPI-based expressions like "12.0 + %player_level% * 0.3"

Example Expression Snippets

damage: "8.0"
attack-speed: "1.5"
max-uses: "25"

damage: "5 + %player_level% * 0.25"
max-uses: "100 + %player_level% * 10"

---

Lore Placeholders

These placeholders are intended for wand item lore:

Placeholder	Description
%damage%	Evaluated damage value
%attack_speed%	Evaluated attack speed value
%range%	Wand max range
%cooldown%	Cooldown in seconds
%max_uses%	Maximum uses
%remaining_uses%	Remaining uses on that item

---

Merge Example

To create a simple upgrade chain from one wand into another:

merge:
  enabled: true
  required-type: basic-wand
  result-type: advanced-wand
  requirement: ""

This means:

• the wand is mergeable

• it expects the specified wand type

• a successful merge creates the result wand

If you want a wand to never merge, set:

merge:
  enabled: false