Wand Configuration

Wand System

Wands are consumable-use combat items that let players right-click toward a mob to deal damage from range. Each wand can have its own damage formula, attack speed, range, cooldown, uses, visuals, sounds, and merge behaviour.

---

Overview

The wand system is split into global settings, messages, commands, and individual wand files:

/plugins/PhantomDungeons/wands/
  ├─ items/
  │  ├─ basic-wand.yml
  │  ├─ advanced-wand.yml
  │  └─ (your custom wands)
  ├─ commands.yml
  ├─ messages.yml
  └─ settings.yml

---

Quick Start

1

Create a Wand File

Create a new .yml file inside wands/items/. You can copy basic-wand.yml as a starting point.

2

Configure Core Stats

Set your wand's damage, attack-speed, min-range, max-range, cooldown-ms, and max-uses.

3

Customize Presentation

Set the display-name, lore, material, particle trail, hit effects, and sounds.

4

Reload the Module

Use your reload flow so the wand files are loaded, then give the wand with the wand admin command.

---

Global Settings (settings.yml)

The settings.yml file controls how the wand module behaves globally.

Common options include:

• enabled - enables or disables wand usage

• merge-enabled - enables wand merging

• cooldown-multiplier - scales all wand cooldowns globally

• particles-enabled - enables wand particle effects

• sounds-enabled - enables wand sound effects

• holograms.* - default style and spawn offsets for wand damage indicators

---

What a Wand File Controls

A wand file mainly has these sections:

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%'

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

---

Notes

• Wand stats such as damage, attack-speed, and max-uses support expressions.

• Lore supports built-in wand placeholders like %damage% and %remaining_uses%.

• Wands are used by right-clicking with the wand in the main hand.

• If a wand runs out of uses, it breaks automatically.

• Wand merging is configured per wand file and also controlled by the global merge setting.