Add helpful NPCs to your dungeons! Villager NPCs provide services like healing, shops, and buff stations that players can use during their run.
💰 Dungeon Coins
NPCs can use Dungeon Coins - a currency earned during the run from killing mobs and looting chests. Coins reset when the dungeon ends, creating a roguelike economy!
NPC Service Types
❤️ Healer NPC
▼Restores player health for a cost.
How Players Use It:
- Right-click the villager NPC
- Health is restored (up to configured amount)
- Cost is deducted from their currency
- Cooldown prevents spam healing
Configuration Options:
| Option | Default | Description |
|---|---|---|
| Service Type | HEALER | Set to Healer |
| Heal Amount | 10.0 | Hearts to restore (20 = full health) |
| Cost | 50 | Price in selected currency |
| Currency Type | DUNGEON_COINS | FREE, SERVER_ECONOMY, or DUNGEON_COINS |
| Cooldown | 30 | Seconds between uses |
🛒 Shop NPC
▼Opens a shop GUI where players can buy items mid-run.
How Players Use It:
- Right-click the villager NPC
- Shop GUI opens with available items
- Click items to purchase
- Items are added to inventory
Configuration Options:
| Option | Default | Description |
|---|---|---|
| Service Type | SHOP | Set to Shop |
| Currency Type | DUNGEON_COINS | Payment method |
| Shop Items | (configure in GUI) | Items available for purchase |
🎯 Shop Ideas
Sell potions, food, arrows, or temporary gear. Price items based on dungeon difficulty!
✨ Buff Station NPC
▼Applies temporary potion effects to players.
How Players Use It:
- Right-click the villager NPC
- Buff is applied (Speed, Strength, etc.)
- Cost is deducted
- Effect lasts for configured duration
Configuration Options:
| Option | Default | Description |
|---|---|---|
| Service Type | BUFF_STATION | Set to Buff Station |
| Buff Type | SPEED | Potion effect type |
| Buff Amplifier | 1 | Effect level (0=I, 1=II, etc.) |
| Buff Duration | 120 | Duration in seconds |
| Cost | 25 | Price in selected currency |
| Currency Type | DUNGEON_COINS | Payment method |
| Cooldown | 60 | Seconds between uses |
Available Buff Types:
- SPEED - Move faster
- STRENGTH - Deal more damage
- RESISTANCE - Take less damage
- REGENERATION - Heal over time
- FIRE_RESISTANCE - Immune to fire
- NIGHT_VISION - See in the dark
- JUMP_BOOST - Jump higher
- HASTE - Mine/attack faster
Currency Types
| Currency | Description |
|---|---|
| FREE | No cost - service is free to use |
| SERVER_ECONOMY | Uses Vault economy (requires Vault plugin) |
| DUNGEON_COINS | Temporary currency earned during the run |
Earning Dungeon Coins
Players earn Dungeon Coins from various activities during their run:
| Activity | Default Coins | Config Key |
|---|---|---|
| Killing a mob | 5 |
dungeon-coins.mob-kill
|
| Killing a boss | 50 |
dungeon-coins.boss-kill
|
| Looting a chest | 10 |
dungeon-coins.chest-loot
|
Coins are displayed in the action bar and reset when the dungeon run ends.
Setting Up an NPC (Step-by-Step)
- Enter edit mode:
/df edit <dungeon> - Get your wand and switch to MARKER mode
- Place a VILLAGER_NPC marker where you want the NPC
- Switch to INFO mode and right-click to configure:
- Select the Service Type (Healer, Shop, or Buff Station)
- Configure service-specific options
- Set the Currency Type and cost
- Optionally set a cooldown
- Save and test your dungeon!