Wand Configuration

circle-info

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:


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.

Last updated