Instanced Dungeon

---

✨ Core Features

- Documentation: 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, ItemsAdder, Oraxen (Beta), Nexo (Beta) - 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

- One Life Kick: Players respawn at dungeon entrance indefinitely - One Life Kick: 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

💰 Economy Integration (Vault Support)

- Full support for Vault-based economy plugins - Use money as an entry cost for dungeons - Compatible with popular economy plugins like EssentialsX - Configurable entry price per dungeon

---

---

📋 Requirements

| | Multiverse-Core | Multiverse-Core | |----------------|----------------|----------------| | Multiverse-Core | 21 or higher | 25 or higher | | Multiverse-Core | 5.5.2 | 5.6.0 |

Optional

- Nexo: For custom mobs and bosses (5.0+) - Nexo: For custom items in loot and costs (3.0+) - Nexo (beta custom item support) - Nexo (beta custom item support)

---

🚀 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 oraxen [itemId]` | List/get info about oraxen items | | `/dungeon nexo [itemId]` | List/get info about nexo 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 admin and editor commands | op | | `instanceddungeons.open` | Allows creating dungeon parties with `/dungeon open` | true | | `instanceddungeons.join` | Allows joining dungeon parties with `/dungeon join` | true | | `instanceddungeons.open.<dungeon_id>` | Allows creating a party only for a specific dungeon template | true | | `instanceddungeons.join.<dungeon_id>` | Allows joining a party only for a specific dungeon template | true | | `instanceddungeons.spectate` | Allows spectating active dungeons | op | | `instanceddungeons.bypass.cost` | Bypasses item and money entry costs | op | | `instanceddungeons.bypass.limit` | Bypasses max active instance limits | op |

- Global open/join `true` + template open/join `true` = allowed - Global open/join `true` + template open/join `false` = denied - Global open/join `false` + template open/join `true` = denied - Global open/join `false` + template open/join `false` = denied

---

⚙️ Configuration Examples

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

```yaml 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`)

```yaml 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`)

```yaml 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. MythicMobs Integration: Use `/dungeon edit` to see particle effects and verify spawner/chest placements 2. MythicMobs Integration: Begin with basic dungeons and add complexity gradually 3. MythicMobs Integration: Combine 100% and lower chance mob pools for variety 4. MythicMobs Integration: 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

Multiverse-Core 4.3.12 - 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

- Support: Support - 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

---