For the complete documentation index, see llms.txt. This page is also available as Markdown.

First Dungeon

The safest setup path is the in-game visual editor. Run all location-based commands while standing in the world that will contain the dungeon.

1

Enter setup mode

/dga setup

Setup mode backs up the administrator's inventory and game mode, then provides a dedicated hotbar. Run the command again to leave setup mode and restore the previous state.

2

Create a zone

You can use the setup menu or a direct command:

/dga setup createzone mines "Mines"

The zone is created at your position with:

  • a stable ID (mines in the example);

  • a player-facing display name;

  • a starter area and mob point;

  • a starter mob and first stage;

  • scaling copied from settings/setup.yml.

The first created zone also becomes progression.starting-zone.

Treat IDs as permanent storage keys. Change display-name when you want different text; avoid renaming IDs after players have progress.

3

Select the arena

With FastAsyncWorldEdit installed:

  1. Select the two opposite corners with //wand, //pos1, and //pos2.

  2. Stand inside the selected cuboid.

  3. Open /dga setup, select the zone, and use the FAWE Arena tool.

Standing inside the selection ensures the entry and initial spawn remain inside the arena. Bounds are also required before packet-block themes can be configured.

4

Set the player entry

Stand where players should arrive and use the setup tool, or run:

/dga setup mines entry

Player yaw and pitch are stored with the position.

5

Add and face mob points

Stand at each desired point and run:

/dga setup mines addspawn

Look in the direction the mobs should face, then apply that direction to all shared points:

/dga setup mines facingall

At least one mob point must remain in every active area.

6

Add stages

The visual stage editor can add and tune stages. Direct commands are also available:

/dga setup mines createstage stage_2 "Stage 2"
/dga setup mines stagemob 2 ZOMBIE
/dga setup mines stagescale 2 health 2.0
/dga setup mines stagescale 2 money 2.0

New stages inherit automatic costs, completion targets, rewards, and scaling from settings/setup.yml. Fine-tune the resulting zones/mines.yml afterward.

7

Add optional systems

  • Place a Companion Block with the setup hotbar or /dga setup mines companionblock.

  • Place an AFK mob point with the setup hotbar or /dga setup mines afkmob.

  • Configure safe client-only block replacements with the Packet Blocks setup tool.

  • Create additional areas and attach them to selected stages when a zone has multiple arenas.

8

Validate and test

/dga validate
/dga reload
/dungeons join mines 1

Test the entry, arena boundary, every mob point, stage completion, rewards, reconnect behavior, and leaving the area. Run /dga setup again when finished to restore the admin inventory.

Last updated