Skip to content

Getting Started

This guide creates a working dungeon from a template world.

Requirements

Target Java Multiverse-Core
Paper 1.21.x 21+ 5.5.2+
Paper 26.1.x 25+ 5.6.0+

Optional integrations:

  • MythicMobs for custom mobs and bosses.
  • MythicMobs items through MYTHIC_ITEM.
  • ItemsAdder, Oraxen, or Nexo for custom item IDs.
  • Vault plus an economy plugin for money costs and payment missions.

Install

  1. Stop the server.
  2. Put the plugin .jar into the plugins folder.
  3. Install Multiverse-Core.
  4. Start the server once.
  5. Configure dungeons in plugins/InstancedDungeons/dungeons/.
  6. Run /dungeon reload after YAML edits.

Config compatibility

Current dungeons use the 2.0 config format. Older 1.0.x dungeons should be recreated or kept with the legacy documentation.

Create a Boss Dungeon

Create or load a template world first. Example:

/mv create dragon_template normal

Then configure the dungeon:

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

Validate before players use it:

/dungeon validate dragon_lair

Create a Trigger Dungeon

Trigger dungeons complete when players activate one configured button or pressure plate.

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

Start as a Player

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

Openable tower stages

/dungeon open only suggests standalone dungeons and tower FIRST stages. Middle and last tower stage IDs are entered through tower progression.