AdvanceMMO Wiki

Ultimate RPG Documentation

Dungeon System

The Dungeon System is a comprehensive procedural dungeon generation system that creates unique, instanced dungeon worlds for each player. Each dungeon is procedurally generated with rooms, corridors, bosses, loot, puzzles, and traps.

Overview

Dungeons are instanced worlds created using Multiverse-Core. Each player gets their own dungeon instance, ensuring a unique experience every time. Dungeons are procedurally generated with:

  • Rooms: Various room types (Start, Normal, Boss, Mini-Boss, Treasure, Puzzle, Trap)
  • Corridors: Connecting paths between rooms
  • Boss Rooms: Large rooms with powerful boss enemies
  • Treasure Chambers: Rare rooms with high-value loot on pedestals
  • Mini-Boss Rooms: Challenging encounters before the final boss
  • Loot Chests: Randomly placed chests with scaling items based on level
  • Mob Spawners: Enemy spawners throughout the dungeon
  • Puzzles: Redstone-based puzzle rooms
  • Traps: Dangerous trap rooms with TNT, lava, and arrow dispensers

Getting Started

To enter a dungeon, you need to:

  1. Meet the level requirement for the dungeon
  2. Use /dungeon enter <name> or step into a portal
  3. Your own dungeon instance will be created automatically

Dungeon Types

There are three default dungeon types available:

Beginner Dungeon

  • Required Level: 5
  • Reward XP: 500
  • Reward Gold: 200 ₲
  • Max Players: 1
  • Time Limit: 30 minutes

Perfect for new players to learn dungeon mechanics.

Intermediate Dungeon

  • Required Level: 15
  • Reward XP: 1,500
  • Reward Gold: 500 ₲
  • Max Players: 3
  • Time Limit: 60 minutes

A moderate challenge for experienced players.

Advanced Dungeon

  • Required Level: 30
  • Reward XP: 3,000
  • Reward Gold: 1,000 ₲
  • Max Players: 5
  • Time Limit: 90 minutes

The ultimate challenge for veteran players.

Dungeon Generation

Dungeons are procedurally generated using a grid-based system:

  • Grid Size: 20x20 (configurable)
  • Room Placement: Random selection of grid positions
  • Room Sizes: 5-15 blocks (configurable)
  • Corridor Width: 3 blocks (configurable)
  • Room Types: Start, Normal, Boss, Puzzle, Trap

Room Types

Start Room

The entrance room where you spawn. Contains the exit portal.

  • Size: 7x7 blocks
  • Height: 4 blocks
  • Always at position (0, 0)

Normal Room

Standard rooms with mob spawners and occasional loot chests.

  • Size: 5-15 blocks (random)
  • Height: 4 blocks
  • Contains: Mob spawners, loot chests (50% chance)

Boss Room

Large rooms at the end of the dungeon containing powerful bosses.

  • Size: 15-20 blocks (random)
  • Height: 6 blocks
  • Contains: Boss spawner, 2 loot chests
  • Location: Farthest from start room

Treasure Chamber (New!)

Rare rooms containing a central pedestal with high-value loot.

  • Size: 5x5 blocks
  • Height: 4 blocks
  • Contains: Gold/Diamond blocks, Treasure chest with rare items

Mini-Boss Room (New!)

Challenging rooms with a mini-boss encounter.

  • Size: 10-15 blocks
  • Height: 5 blocks
  • Contains: Stronger spawners, higher loot quality

Puzzle Room

Rooms with Redstone-based puzzles to solve.

  • Size: 8-12 blocks (random)
  • Height: 4 blocks
  • Contains: Pressure plates, Redstone lamps, 1 loot chest

Trap Room

Dangerous rooms filled with traps to catch players off-guard.

  • Size: 8-12 blocks (random)
  • Height: 4 blocks
  • Contains: 2-5 traps (TNT pressure plates, Lava pits, or Arrow dispensers)

Portal System

Dungeons use a block-based portal system for entry and exit:

  • Portal Block: End Portal Frame (configurable)
  • Activation: Stand within 2 blocks of the portal
  • Cooldown: 5 seconds between teleportations
  • Visual Effects: Portal particles and teleportation sound

Entering a Dungeon

You can enter a dungeon in two ways:

  1. Command: Use /dungeon enter <name>
  2. Portal: Step into a portal created by an admin

When you enter, a new dungeon instance world is created for you. The dungeon is generated automatically.

Exiting a Dungeon

To exit a dungeon:

  1. Find the exit portal in the start room
  2. Step into the portal
  3. You'll be teleported back to your original location

Alternatively, use /dungeon exit to leave immediately.

Commands

Command Description Permission
/dungeon list List all available dungeons advancemmo.dungeon
/dungeon enter <name> Enter a dungeon (creates instance) advancemmo.dungeon
/dungeon exit Exit current dungeon advancemmo.dungeon
/dungeon info <name> Show dungeon information advancemmo.dungeon
/dungeon createportal <name> Create a portal at your location (Admin) advancemmo.dungeon.admin
/dungeon admin Open admin GUI for testing advancemmo.dungeon.admin

Dungeon Features

Boss Rooms

Boss rooms are large chambers containing powerful boss enemies. They are always placed at the farthest point from the start room. Boss rooms contain:

  • Boss spawner (Wither Skeleton by default)
  • 2 guaranteed loot chests
  • Larger room size (15-20 blocks)
  • Higher ceiling (6 blocks)

Loot Chests

Loot chests are randomly placed throughout dungeons. They contain:

  • Iron and Gold Ingots
  • Diamonds
  • Enchanted Books
  • Experience Bottles
  • Arrows
  • Food items

The number of items varies (3-7 items per chest).

Mob Spawners

Normal rooms contain 1-3 mob spawners with various enemy types:

  • Zombies
  • Skeletons
  • Spiders

Mob types are randomly selected for each spawner.

Puzzles

Puzzle rooms contain Redstone-based challenges:

  • Pressure plates arranged in patterns
  • Redstone lamps as targets
  • Reward chest for solving the puzzle

Traps

Trap rooms are dangerous areas with 2-5 traps:

  • TNT Traps: Explosive blocks that activate when stepped on
  • Lava Traps: Lava pools hidden in the floor

Be careful when exploring trap rooms!

Dungeon Instances

Each player gets their own dungeon instance world. This means:

  • You won't encounter other players in your dungeon
  • Each dungeon is unique and procedurally generated
  • Instances are automatically cleaned up after timeout or completion
  • Your progress is saved until you complete or leave the dungeon

Instance Management

Dungeon instances are managed automatically:

  • Creation: Instance is created when you enter a dungeon
  • Timeout: Instances expire after the configured time limit (default: 1 hour)
  • Cleanup: Expired instances are automatically deleted
  • Return Location: Your original location is saved for teleportation back

Strategy Tips

Preparation

  • Bring plenty of food and healing items
  • Ensure you have good armor and weapons
  • Check the dungeon's level requirement before entering
  • Know the time limit - plan your exploration accordingly

Exploration

  • Start rooms always contain the exit portal - remember its location
  • Boss rooms are at the farthest point - explore systematically
  • Check every room for loot chests
  • Be cautious in trap rooms - look before you step

Combat

  • Mob spawners can be destroyed to stop enemy spawning
  • Boss rooms require full preparation - don't rush in
  • Use your class abilities and skills effectively
  • Manage your mana for active skills

Troubleshooting

Common Issues

  • Can't enter dungeon: Check if you meet the level requirement
  • Portal not working: Wait for the cooldown period (5 seconds)
  • World creation failed: Ensure Multiverse-Core is installed and enabled
  • Dungeon not generating: Check server logs for errors

Admin Features

Admins have access to additional features through the Admin GUI (/dungeon admin):

  • Dungeon List: View all available dungeons with details
  • Instance Management: Create, join, leave, or delete instances
  • Generator Settings: Test dungeon generation with custom parameters
  • Portal Management: Create and manage portals
  • World Management: View and manage dungeon worlds

For more information, see the Admin Configuration page.