Stages and Gates¶

Stages are optional progression gates inside a dungeon.

Stage files live in:

dungeons/<id>/stages/<stage_id>.yml
dungeons/<id>/stages/<stage_id>-hologram.yml

Create a Stage¶

/dungeon edit dragon_lair
/dungeon stage create entrance
/dungeon stage entrance gate create
# select gate blocks in the template world
/dungeon gate save

Stage Order¶

Every stage has an order:

stage-id: entrance
stage-order: 1

Order 1 unlocks first. Higher orders unlock only after every lower-order stage opens.

Multiple stages can share the same order. Shared-order stages run in parallel.

/dungeon stage list
/dungeon stage entrance order 2

Gate Editing¶

Use gate mode to select existing blocks from the template world.

/dungeon stage entrance gate create
/dungeon stage entrance gate stick
/dungeon gate save

Gate stick controls:

Action	Result
Left-click	Adds one existing block.
Right-click	Removes one selected block.
Sneak-left-click	Adds connected same-material blocks.
Sneak-right-click	Removes connected same-material blocks.

Holograms¶

/dungeon stage entrance gate hologram create
/dungeon stage entrance gate hologram delete

You can create multiple holograms for the same stage. Delete removes the nearest hologram for that stage within 3 blocks.

Runtime holograms show live mission progress. Locked higher-order holograms show which earlier stages still need to open.

Mission Types¶

Mission	Description
`KILL_MOBS`	Party must kill a configured number of mobs.
`LEVER`	Party must pull all mission levers.
`BUTTON`	Party must press all mission buttons at the same time.
`PRESSURE_PLATE`	Party must activate all mission plates at the same time.
`REQUIRED_KEY`	Players submit mission keys by right-clicking the gate.
`TIME`	Waits a configured number of seconds.
`SACRIFICE`	Selects players to eliminate through the mission GUI.
`MONEY_PAYMENT`	Requires a Vault money payment.
`ITEM_PAYMENT`	Requires configured items through a GUI editor.

Mission Commands¶

/dungeon stage <stage_id> mission kill_mobs <amount>
/dungeon stage <stage_id> mission lever
/dungeon stage <stage_id> mission button <button_material>
/dungeon stage <stage_id> mission pressure_plate <plate_material>
/dungeon stage <stage_id> mission required_key <amount>
/dungeon stage <stage_id> mission time <seconds>
/dungeon stage <stage_id> mission sacrifice [mode] [drop_items]
/dungeon stage <stage_id> mission money_payment <amount> [ANY_PLAYER|LEADER_ONLY]
/dungeon stage <stage_id> mission item_payment
/dungeon stage <stage_id> mission <type> delete

Clickable missions

SACRIFICE, MONEY_PAYMENT, and ITEM_PAYMENT are opened during a run by right-clicking a gate block.