Instanced Dungeon

<div align="center"> # ⚔️ InstancedDungeons ⚔️ **Instanced dungeons for Paper servers, built around reusable world templates** (https://img.shields.io/badge/Paper-1.21.x-blue.svg)](https://papermc.io/) (https://img.shields.io/badge/Paper-26.1%20%2F%2026.2-blue.svg)](https://papermc.io/) (https://img.shields.io/badge/Java-21%20%2F%2025-orange.svg)](https://adoptium.net/) Build a dungeon once, then let multiple parties run through separate copies without interfering with each other. InstancedDungeons handles parties, objectives, stages, gates, mobs, loot, rewards, lives, timers, validation, and cleanup. <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/Z_ljq6SQbes" title="InstancedDungeons video" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> </div> --- ## 📚 Documentation and Support - **Documentation:** (https://wertpl.github.io/InstancedDungeons-Docs/) - **Discord:** (https://discord.com/invite/sD4HvQh8P4) Please check validation output and the documentation before reporting a setup problem. If something is genuinely broken, include the plugin version, Paper version, Java version, and the relevant console error. --- ## ✨ Main Features ### 🏰 Isolated World Instances - Use an existing world as a reusable dungeon template. - Give every party its own temporary copy. - Run multiple groups through the same dungeon at the same time. - Clean up completed, failed, abandoned, and orphaned instances. - Remove matching temporary WorldGuard world data during cleanup. - Keep players who are not part of the run out of active instances. ### 👥 Parties and Spectators - Party creation with short join codes. - Configurable minimum and maximum party sizes. - Party-leader controls for starting a run. - Support for leaving, reconnecting, tower transitions, and cleanup. - External spectators can follow an active party and leave safely. - Eliminated players can spectate the rest of the run or return to the exit. ### 🎯 Boss and Trigger Dungeons Choose how each dungeon is completed: - `BOSS` — defeat the configured boss. - `TRIGGER` — activate one configured button or pressure plate. Boss and trigger rewards support independent drop chances, amount ranges, vanilla items, ItemsAdder, Oraxen, Nexo, and MythicMobs items. Reward delivery is configurable per objective: - send rewards directly to inventories or drop them at the objective; - reward the leader, killer, trigger activator, every alive player, or create one shared party drop; - safely drop inventory overflow at the recipient's location; - reject invalid delivery and recipient combinations before the dungeon starts. ### 🚪 Stages, Gates, and Missions - Add progression stages inside a dungeon. - Select existing gate blocks without breaking or replacing them. - Use sneak-click to edit connected blocks of the same material. - Import the current WorldEdit selection with `//set` while editing a gate. - Give stages explicit IDs and order numbers. - Run multiple stages in parallel by assigning the same order. - Add multiple holograms with live mission progress. Supported stage missions: - mob kills; - levers; - synchronized buttons and pressure plates; - required keys; - timers; - sacrifice decisions; - Vault payments; - item payments. The Free edition supports up to two stages per dungeon and two missions per stage. ### ⚔️ Mob Spawners - Vanilla mobs and MythicMobs. - Mixed vanilla/MythicMobs pools. - Weighted entries and individual spawn chances. - Boss spawners for boss-objective dungeons. - Start, proximity, delay, and proximity-with-delay trigger modes. ### 📦 Loot Chests - Place configured loot chests in the template world. - Random chances and min/max amounts per entry. - Vanilla and supported custom items. - Potion, tipped-arrow, and enchanted-book IDs. - Add the item in your hand with `/dungeon lootchest loot <id> add`. - Guaranteed mission-key supply for required-key stages. - Editor particles make configured locations easy to find. ### 🗼 Tower Dungeons Chain dungeon templates together into a longer run. The Free edition supports: ```text FIRST -> LAST ``` The party, lives, spectators, and progression are carried across the transition. Entry costs belong to the first dungeon, while the last dungeon completes the tower. ### 💰 Costs, Lives, and Timers - Money and item entry costs. - Vault economy support. - Leader-only or whole-party payment. - Player-scoped or shared team lives. - Unlimited lives with `0`. - Configurable elimination behavior. - Per-dungeon countdown and bossbar. - Configurable timer alerts and automatic failure at zero. ### 🛡️ Dungeon Rules and Item Restrictions - Control block breaking, block placement, fluids, interactions, and TNT. - Keep mission blocks, gates, objectives, and