Dungeon Config
Each dungeons/<id>.yml is an independent dungeon template. IDs must match [a-z0-9][a-z0-9_-]{0,31} and the filename must match the id field.
Top-Level Fields
| Field | Meaning |
|---|---|
id | Dungeon id used by /ad join <id> and admin commands. |
display-name | Human-facing name shown in menus. |
icon-material | Menu icon material for admin/player interfaces. |
description | Menu lore text. |
permission | Optional permission required for this dungeon to appear in the public menu. |
enabled | Must be true before normal joins succeed. |
anchor-location | Absolute template anchor for dungeon-level relative positions. |
lobby-location | Optional legacy relative lobby location. |
spectator-location | Optional legacy relative spectator location. |
exit-location | Optional legacy relative exit location. |
stages | Per-stage setup entries. |
rewards | Final win gold, EXP, and boss drop rolls. |
Stage Fields
Each stage stores:
stage-numberschematic-fileanchor-locationcombat-teleport-locationsupply-teleport-locationcheckpoint-locationcombat-regionsupply-regionmob-round-spawnsboss-spawnssupply-npc-locations
What Each Saved Point Means
| Setting | Operator meaning |
|---|---|
anchor-location | Exact source/build anchor for stage schematic. Save this before any relative stage point. |
combat-teleport-location | Where players land for combat rounds in this stage. |
supply-teleport-location | Where players land during supply round. Must stay inside supply region. |
checkpoint-location | Where dead players respawn during this stage. |
combat-region | FAWE-copied bounds used to validate regular/boss spawns. |
supply-region | FAWE-copied bounds used to validate supply teleports and supply NPC positions. |
Relative Location Idea
Dungeon-level and stage-level anchors are absolute positions in source world. Most other positions are saved as offsets from those anchors. When plugin pastes schematic into instance world, those offsets are applied to pasted copy so teleports, NPCs, and spawns line up with pasted build.
In practice:
- Stand at source anchor and save it.
- Move to gameplay point inside source schematic.
- Save that point.
- Plugin remembers offset, not only raw world coordinates.
Spawns and NPCs
mob-round-spawns is keyed by round number. Default combat rounds are 1, 2, 3, 4, and 6. Each spawn stores group, relative location, amount, MythicMob id, and optional elite. Elite entries drop large blood orbs.
boss-spawns is used for boss round only. Boss spawns are validated against combat region too. Final stage boss clear ends run instead of loading another stage.
Required roles are augment, stats, potion, exp, and craft. Every role needs its own saved position. Validation checks each NPC point stays inside supply region.
Reward Rules
rewards controls end-of-run win payout:
win-goldwin-expboss-drop-rollscompletion-commandsvictory-sounddefeat-sound
Completion commands run only after the outside inventory is restored and are suppressed in admin test runs. Supported command placeholders are {player}, {uuid}, {dungeon}, {party-size}, {kills}, {deaths}, {clear-seconds}, {gold}, and {exp}.