---

✨ Core Features

🏰 Template-Based Instances

• Use existing worlds as reusable dungeon templates.
• Create isolated temporary instance worlds for each party.
• Run multiple groups through the same dungeon without interference.
• Automatically clean up instance worlds after completion, failure, or abandonment.
• Clean up matching WorldGuard per-world data folders for temporary instance worlds.

👥 Party System

• Create parties with unique join codes.
• Configurable min/max player limits per dungeon.
• Party leader controls for starting runs.
• Party state tracking during active dungeons, tower transitions, completion, and cleanup.
• External-entry protection keeps non-party players out of active instance worlds.

🎯 Boss and Trigger Objectives

• Create boss dungeons with /dungeon create <id> <world> boss.
• Create trigger dungeons with /dungeon create <id> <world> trigger.
• Boss dungeons complete through boss defeat.
• Trigger dungeons complete through one configured button or pressure plate.
• Objective-specific validation helps admins find missing boss/trigger setup quickly.

🗼 Tower Dungeons

• Chain multiple dungeon templates into tower progression.
• FIRST tower stages can be opened by command and may have entry costs.
• LAST tower stages complete the tower and send players to exit.
• Free version supports two-step towers: FIRST -> LAST.
• Middle stages are reserved for the Pro version.

🚪 Stages, Gates, and Missions

• Add progression gates inside dungeons.
• Create and edit gate blocks in editor mode.
• Use a gate edit stick to add/remove existing blocks from a gate selection without placing or breaking them, with sneak-click support for connected same-material gate pieces.
• WorldEdit //set can sync the current WorldEdit selection into the active gate selection during gate edit mode.
• List stages and reorder them without editing YAML by using /dungeon stage list and /dungeon stage <stage_id> order <number>.
• Stage commands use explicit stage IDs so parallel order groups stay unambiguous.
• Multiple stages can share the same order and progress in parallel; higher orders unlock after every lower order is completed.
• Live stage holograms show mission progress, each stage can have multiple holograms, and editor-mode previews use the same renderer as runtime instances. Clickable runtime stage missions are opened from gate blocks.
• Supported missions include mob kills, levers, buttons, pressure plates, keys, timers, sacrifice, money payments, and item payments.
• Gate opening includes sounds and configurable disappearing blocks.
• Stage mission config files save only the fields used by each mission type.

⚔️ Flexible Mob Spawning

• Supports vanilla mobs and MythicMobs.
• Mix vanilla and MythicMobs pools in the same spawner.
• Trigger modes:
  • ON_START
  • ON_PLAYER_NEAR
  • ON_DELAY
  • ON_PLAYER_NEAR_ON_DELAY
• Weighted mob pools with per-entry spawn chances.
• Boss spawner support for boss objective dungeons.

📦 Smart Loot System

• Place custom loot chests anywhere in the template world.
• Randomized loot with per-item chances.
• Min/max amount ranges per item.
• Support for vanilla items, ItemsAdder, Oraxen, Nexo, and MythicMobs items.
• Special vanilla IDs for potions, tipped arrows, and enchanted books.
• Add held items to a loot chest with /dungeon lootchest loot <id> add.
• Mission key loot entries for stage gates. Mission keys use guaranteed quantity supply per loot chest definition instead of random drop chance.
• Visual editor particles for loot chest placement.

🎁 Boss and Trigger Rewards

• Configure rewards given after boss defeat or trigger completion flow.
• Add reward items through an in-game GUI.
• Separate GUI slots become separate reward entries.
• Supports custom items from supported providers.
• Per-reward drop chance configuration.

💰 Entry Costs and Economy

• Require money and/or items to start a dungeon.
• Supports Vault economy.
• Supports vanilla items and custom item providers.
• Configure whether only the leader pays or every party member pays.
• Permission bypass for trusted players.

💀 Lives and Death Mechanics

• Unlimited lives with respawn at dungeon start.
• Player-scoped lives, where each player has their own death count.
• Team-scoped lives, where deaths are shared by the whole party.
• Eliminated players can become spectators or be kicked to exit depending on dungeon config. Former dungeon players who are spectating after death or sacrifice are sent to the dungeon exit when they leave the run or when the run ends.
• Death messages show the remaining player lives or shared team lives based on the configured lives scope.

⏱️ Timer and Bossbar

• Per-dungeon countdown timer.
• Per-dungeon bossbar color, style, and time display settings.
• Chat and sound alerts at 10 minutes, 5 minutes, and 1 minute remaining.
• Automatic failure when time expires.

🛡️ Protection System

• Block breaking and placing controls.
• Fluid placing and taking controls.
• Interaction controls for doors, buttons, levers, and more.
• TNT behavior modes: vanilla, damage-only, or disabled.
• Mission blocks and trigger objectives can still work when normal interactions are blocked.

🔧 Validation Tools

• /dungeon validate <id> for one dungeon.
• /dungeon validate all for every dungeon.
• Reload-time validation for configs, objectives, towers, spawners, loot, costs, and stages.
• Admin-only chat warnings with console logging.
• Legacy config protection for pre-2.0 dungeons.

⚙️ Event Commands

• Per-dungeon automation hooks for players and parties.
• Run commands as console or player.
• Hook into party creation, joins, starts, completion, failure, death, mob kills, boss kills, stage completion, gates, tower transitions, and more.
• Placeholder support for player, party, dungeon, stage, tower, mob, boss, world, and coordinates.

🎨 Visual Editor Mode

• Action bar indicator for the edited dungeon.
• Gate edit mode has a separate purple action bar.
• Subtle particles for selected gate blocks.
• Particles for spawners, loot chests, bosses, triggers, and mission blocks.
• Editor-mode template teleport is configurable in config.yml.

---

📋 Compatibility

Plugin version	Server target	Java	Multiverse-Core	Notes
2.0	Paper 26.1.x / 26.2.x	25+	5.6.0+	Beta support for Paper 26.1/26.2.
2.0	Paper 1.21.x	21+	5.5.2+	Supported compatibility line.
1.0.8 and older	Paper 1.21.x	21+	5.5.2+	Legacy config format, not compatible with 2.0 dungeons.

Optional Integrations

• MythicMobs 5.0+ for custom mobs and bosses.
• MythicItems item support through MYTHIC_ITEM.
• ItemsAdder 3.0+ for custom items.
• Oraxen custom item support.
• Nexo custom item support.
• Vault plus an economy plugin for money costs and money missions.

---

Free vs Pro Comparison

Area	Free Version	Pro Version
Global active instances	Up to 16 active instances globally	Configurable without the Free cap
Tower dungeons	Two-step towers: FIRST -> LAST	Multi-step towers: FIRST -> MIDDLE -> ... -> LAST
Stages per dungeon	Up to 2 stages	Expanded stage count for larger dungeon designs
Missions per stage	Up to 2 missions	Expanded mission count for complex gates
Mission blocks	Up to 3 levers, 3 buttons, and 2 pressure plates per stage	No Limits
Required keys	Up to 1 required key mission	No Limits
Sacrifice, money, and item payment missions	Up to 1 of each per dungeon	No Limits
Item payment complexity	Up to 3 item types per item payment mission	Expanded item payment setups
Tower middle stages	Not available	Available
Admin GUI	No admin GUI	Full in-game admin GUI

and more

Pro links:

BuiltByBit - click here

SpigotMC - Soon

---

🚀 Quick Start

1. Install

1. Download InstancedDungeons.jar.
2. Place it in your server's plugins/ folder.
3. Install Multiverse-Core.
4. Start the server.

2. Create a Boss Dungeon

/mv create dragon_template normal
/dungeon create dragon_lair dragon_template boss
/dungeon edit dragon_lair
/dungeon setspawn
/dungeon setexit
/dungeon setboss
/dungeon save
/dungeon reload

3. Create a Trigger Dungeon

/dungeon create puzzle_room puzzle_template trigger
/dungeon edit puzzle_room
/dungeon setspawn
/dungeon setexit
/dungeon settrigger STONE_BUTTON
/dungeon save
/dungeon reload

4. Add Loot

/dungeon edit dragon_lair
/dungeon addlootchest treasure_1
/dungeon lootchest give treasure_1

5. Add a Stage Gate

/dungeon edit dragon_lair
/dungeon stage create entrance
/dungeon stage entrance gate create
(place gate blocks)
/dungeon gate save
/dungeon stage entrance gate hologram create

6. Players Start a Dungeon

/dungeon open dragon_lair
/dungeon join <code>
/dungeon start

---

🎮 Commands

Player Commands

Command	Description
/dungeon help	Show help menu
/dungeon list	List available dungeons; tower middle/last stages are hidden
/dungeon open <id>	Create a party; tower middle/last stages are entered by progression
/dungeon join <code>	Join a party
/dungeon leave	Leave an open party
/dungeon start	Start as party leader
/dungeon exit	Leave the active dungeon
/dungeon spectate <leader>	Spectate an active dungeon by party leader name
/dungeon spectator exit	Leave spectator mode

Admin Commands

Command	Description
`/dungeon create <boss	trigger>`
/dungeon edit <id>	Enter editor mode
`/dungeon validate <id	all>`
/dungeon setspawn	Set spawn
/dungeon setexit	Set exit
/dungeon setboss	Set boss spawn
/dungeon boss reward edit	Edit boss rewards
/dungeon settrigger <material>	Set trigger objective
/dungeon trigger reward edit	Edit trigger rewards
/dungeon addspawner <id>	Add spawner
/dungeon addlootchest <id>	Add loot chest config
/dungeon lootchest give <id>	Get loot chest item
/dungeon lootchest loot <id> add	Add held item to a loot chest config
/dungeon addcost	Edit entry costs
/dungeon stage create <stage_id>	Create a stage
/dungeon stage list	List stages and their order
/dungeon stage <stage_id> order <number>	Change stage order; equal orders run in parallel
/dungeon stage <stage_id> delete	Delete a stage after confirmation
`/dungeon stage <stage_id> gate create	edit
/dungeon stage <stage_id> gate stick	Get a stick for editing existing gate blocks
`/dungeon stage <stage_id> gate hologram create	delete`
/dungeon stage <stage_id> mission lever	Give mission lever
/dungeon stage <stage_id> mission button <material>	Give mission button
/dungeon stage <stage_id> mission pressure_plate <material>	Give mission pressure plate
/dungeon gate save	Save active gate edit session
/dungeon mythicmob [mobId]	MythicMobs mob lookup
/dungeon mythicitem [itemId]	MythicMobs item lookup
/dungeon itemsadder [itemId]	ItemsAdder lookup
/dungeon oraxen [itemId]	Oraxen lookup
/dungeon nexo [itemId]	Nexo lookup
/dungeon instances	View active parties and instances
/dungeon gui	Pro feature notice in free version
/dungeon reload	Reload configs
/dungeon delete <id>	Delete a dungeon

---

🔑 Permissions

Permission	Default	Description
instanceddungeons.admin	op	Admin/editor commands and admin-only warnings
instanceddungeons.open	true	Allows /dungeon open
instanceddungeons.join	true	Allows /dungeon join
instanceddungeons.open.<dungeon_id>	true	Allows opening a specific dungeon
instanceddungeons.join.<dungeon_id>	true	Allows joining a specific dungeon
instanceddungeons.spectate	true	Allows spectating
instanceddungeons.bypass.cost	op	Bypass dungeon costs
instanceddungeons.bypass.limit	op	Bypass normal instance start limits

---

⚠️ Important 2.0 Notes

• Version 2.0 uses a new dungeon config format.
• Dungeons created before 2.0 should be recreated with the new format.
• Dungeons without v: 2.0 cannot be opened.
• Tower complete/fail announcements use the entry dungeon's announce-* settings. announce-complete broadcasts only after the final tower stage completes, using the final stage dungeon name.
• The source code is not publicly available. Contact we_rt on Discord if needed.

---