---

✨ Core Features

• Documentation: Full Documentation

🏰 Template-Based Instances

• Use any existing world as a dungeon template
• Create unlimited isolated instances from a single template
• Each instance is completely independent - no interference between groups
• Automatic world cleanup when instances end

👥 Advanced Party System

• Create parties with unique join codes
• Configurable party size limits
• Automatic party expiration with countdown
• Party leader controls for starting dungeons
• Seamless party management across server restarts

⚔️ Flexible Mob Spawning

• Support for both vanilla and MythicMobs
• Multiple spawners per dungeon with unique configurations
• Trigger modes: ON_START, ON_PLAYER_NEAR, ON_DELAY
• Lifetime behaviors: PERSIST or DESPAWN_AFTER_TIME
• Weighted mob pools with spawn chances
• Boss spawners with special triggers

📦 Smart Loot System

• Place custom loot chests anywhere in your dungeon
• Randomized loot with configurable chances
• Support for vanilla items and ItemsAdder
• Min/max amount ranges per item
• Items per drop control
• Visual particle effects in editor mode

💰 Entry Cost System

• Require items for dungeon entry
• Support for vanilla items and ItemsAdder
• Configurable per-dungeon costs
• Option to require all players or just party leader to pay
• Bypass permissions for VIP players

💀 Advanced Death Mechanics

• Infinite Respawn: Players respawn at dungeon entrance indefinitely
• One Life Spectator: Players become spectators after death, can watch their team
• One Life Kick: Players are kicked to exit after death
• Configurable "fail if all dead" option

⏱️ Time Management

• Boss bar countdown timer for each instance
• Configurable time limits per dungeon
• Automatic cleanup when time expires
• Visual progress indication for players

🛡️ Protection System

• Configurable block break/place permissions per dungeon
• Fluid placement control (water/lava buckets)
• Fluid collection control (taking water/lava with buckets)
• Interaction control (buttons, levers, doors, etc.)
• Chest protection remains functional for loot

🔔 Exit Reminder System

• Configurable reminder intervals per dungeon
• Automatic notifications about /dungeon exit command
• Disable per-dungeon by setting interval to 0
• Helps prevent players getting stuck

📢 Global Announcements

• Optional server-wide notifications
• Announce dungeon start (solo or party)
• Announce dungeon completion
• Announce dungeon failure
• Fully customizable messages

🎨 Visual Editor Mode

• Particle effects for spawners (flame + smoke)
• Particle effects for loot chests (enchant + glow)
• Particle effects for boss spawners (dragon breath + soul fire)
• Real-time visual feedback while editing
• Particles only visible to admins in editor mode

---

---

📋 Requirements

Required

• Server: Paper 1.21 or compatible fork (Purpur, Pufferfish, etc.)
• Java: 21 or higher
• Plugin: Multiverse-Core 4.3.12 (for world management)

Optional

• MythicMobs: For custom mobs and bosses (5.0+)
• ItemsAdder: For custom items in loot and costs (3.0+)

---

🚀 Quick Start Guide

1. Installation

1. Download InstancedDungeons.jar
2. Place in your server's plugins/ folder
3. Ensure Multiverse-Core is installed
4. Start your server

2. Create Your First Dungeon

/mv create my_dungeon_template normal -g Flat
(Build your dungeon in the template world)
/dungeon create dragon_lair my_dungeon_template
/dungeon edit dragon_lair
(Stand at spawn point)
/dungeon setspawn
(Stand at exit point in your main world)
/dungeon setexit
/dungeon save
/dungeon reload

3. Add Mobs

/dungeon edit dragon_lair
(Stand at spawner location)
/dungeon addspawner entrance_mobs
(Edit the generated YAML file)
/dungeon save
/dungeon reload

4. Add Loot

/dungeon edit dragon_lair
/dungeon addlootchest treasure_1
(Edit the generated YAML file)
/dungeon lootchest give treasure_1
(Place the chest item in your template world)
/dungeon save
/dungeon reload

5. Set Entry Cost (Optional)

/dungeon edit dragon_lair
/dungeon addcost
(Use the GUI to set required items)

6. Players Start Dungeons

/dungeon open dragon_lair
(Share the party code with friends)
/dungeon join <code>
(Party leader starts when ready)
/dungeon start

---

🎮 Commands

Player Commands

Command	Description
/dungeon help	Show help menu
/dungeon list	List all available dungeons
/dungeon open <id>	Create a party for a dungeon
/dungeon join <code>	Join a party with code
/dungeon leave	Leave your current party
/dungeon start	Start the dungeon (party leader only)
/dungeon exit	Exit the current dungeon
/dungeon spectate <code>	Spectate an active dungeon

Admin Commands

Command	Description
/dungeon create <id> <world>	Create new dungeon from template world
/dungeon edit <id>	Enter editor mode (teleports to template)
/dungeon setspawn	Set spawn location (requires editor mode)
/dungeon setexit	Set exit location (requires editor mode)
/dungeon addspawner <id>	Create mob spawner at location
/dungeon addlootchest <id>	Create loot chest configuration
/dungeon lootchest give <id>	Get loot chest item to place
/dungeon setboss	Create boss spawner at location
/dungeon addcost	Configure entry costs via GUI
/dungeon mythic [mobId]	List/get info about MythicMobs
/dungeon itemsadder [itemId]	List/get info about ItemsAdder items
/dungeon instances	View all active parties and instances
/dungeon save	Exit editor mode and save
/dungeon reload	Reload all configurations

---

🔑 Permissions

Permission	Description	Default
instanceddungeons.admin	Access to all admin commands	op
instanceddungeons.use	Use player commands	true
instanceddungeons.spectate	Spectate dungeons	op
instanceddungeons.bypass.cost	Skip entry costs	op
instanceddungeons.bypass.limit	Bypass max instances	op

---

⚙️ Configuration Examples

Dungeon Config (dungeons/<id>/config.yml)

display-name: "Dragon's Lair"
template-world: "dungeon_dragon_template"
max-players: 5
min-players: 1
time-limit: 1800
max-instances: 3                    # For this dungeon at one time
death-behavior: INFINITE_RESPAWN    # After death, players will respawn at the start of the dungeon

# Protection
allow-block-break: false
allow-block-place: false
allow-fluid-place: false            # Allow players to place water/lava
allow-fluid-take: false             # Allow players to take water/lava from dungeon
allow-interactions: true            # Allow players to use buttons, doors etc. in dungeon

# Boss Configuration
boss:
  must-die-to-complete: true
  countdown-after-death: 30         # Time after which players will be teleported to the exit after killing the boss

# Exit Reminders (seconds, 0 to disable)
exit-reminder-interval: 300         # A message to dungeon participants that they can type a command to leave early

# Global Announcements
announce-start: false               # Global message that <Player's name> group started dungeon
announce-complete: true
announce-fail: false

Mob Spawner (dungeons/<id>/spawners/<spawner_id>.yml)

location:
  world: dungeon_dragon_template
  x: 100.5
  y: 64.0
  z: 200.5

trigger: ON_START
lifetime-behavior: PERSIST

mob-pools:
- type: VANILLA
  mob-id: ZOMBIE
  count: 5
  chance: 100.0
- type: MYTHIC
  mob-id: SkeletonKing
  count: 1
  chance: 50.0

Loot Chest (dungeons/<id>/loot-chests/<chest_id>.yml)

min-items-per-drop: 3
max-items-per-drop: 5

loot-table:
- type: VANILLA
  item: DIAMOND
  min-amount: 1
  max-amount: 5
  chance: 75.0
- type: VANILLA
  item: EMERALD
  min-amount: 3
  max-amount: 10
  chance: 100.0
- type: ITEMSADDER
  item: coins:bronze_coin
  min-amount: 1
  max-amount: 3
  chance: 25.0

---

💡 Pro Tips

1. Test in Editor Mode: Use /dungeon edit to see particle effects and verify spawner/chest placements
2. Start Small: Begin with basic dungeons and add complexity gradually
3. Use Chances Wisely: Combine 100% and lower chance mob pools for variety
4. Balance Time Limits: Consider mob difficulty and dungeon size when setting time limits
5. MythicMobs Integration: Leverage MythicMobs for complex boss mechanics

---

🐛 Troubleshooting

Mobs not spawning?

• Check YAML syntax in spawner config
• Verify mob-id is correct for mythic mobs (use /dungeon mythic to list)
• Ensure location is valid in template world
• Check server logs for errors

Loot chests empty?

• Verify chance values (too low = no items)
• Check YAML syntax in loot chest config
• Ensure item IDs are correct
• Review server logs for generation errors

Can't create instances?

• Verify Multiverse-Core is installed with correct version Multiverse-Core 4.3.12
• Check max-instances limit in config
• Ensure template world exists
• Review console for error messages

Particles not showing?

• Must be in editor mode (/dungeon edit)
• Stay within 50 blocks of spawner/chest
• Requires admin permission
• Check client settings (particles enabled)

---

🔗 Links

• Documentation: Full Documentation
• Support: we_rt on discord, only if you are 100% something is broken

---

📜 License

• The source code is not publicly available, contact me on discord nickname: we_rt if you want something

---