Dungeon Config

dungeons/dungeon-config.yml is current persisted dungeon template file. AramDungeons loads this single template, edits it in place, and validates it before runs.

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.
enabled	Must be true before normal joins succeed.
anchor-location	Absolute template anchor for dungeon-level relative positions.
lobby-location	Relative location where players can be sent for lobby flow.
spectator-location	Relative spectator location used by template setup.
exit-location	Relative exit location after leaving flow.
stages	Per-stage setup entries.
rewards	Final win gold, EXP, and boss drop rolls.

Stage Fields

Each stage stores:

• stage-number
• schematic-file
• anchor-location
• combat-teleport-location
• supply-teleport-location
• checkpoint-location
• combat-region
• supply-region
• mob-round-spawns
• boss-spawns
• supply-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:

1. Stand at source anchor and save it.
2. Move to gameplay point inside source schematic.
3. Save that point.
4. Plugin remembers offset, not only raw world coordinates.

Spawns and NPCs

Combat rounds

mob-round-spawns is keyed by round number. Default combat rounds are 1, 2, 3, 4, and 6. Each spawn entry stores group label, relative location, amount, and MythicMob id. Validation checks each combat spawn stays inside combat region.

Boss round

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.

Supply NPCs

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-gold
• win-exp
• boss-drop-rolls

These values are applied when final boss is cleared.

Do not over-document template count

Current service layer reloads one DungeonConfig object from one file. Admin docs should treat this as single active template editing, not as a persistent multi-template system.