Operating and Troubleshooting
Day-to-Day Operations
- Use
/ad admin reloadafter config edits. - Re-run
/ad admin dungeon validate <id>before enabling after any setup change. - Use
/ad admin dungeon edit <id>for preview and quick sanity checks. - If you close setup GUI by mistake, use
/ad admin backto restore last closed admin/setup screen once. - Keep
imports/folder organized so stage file names in config still match real files. - If you change
main-config.ymlround structure, revisit all stage spawn expectations.
Common Failures
| Problem | What to check first |
|---|---|
| Missing dependency warning | Confirm FastAsyncWorldEdit, MythicMobs, MMOItems, and MythicLib are all loaded. PlaceholderAPI is optional only. |
| Schematic missing | Check file exists in plugins/AramDungeons/imports/ and stage uses exact filename. |
| Missing stage anchor | Save stage anchor before saving combat/supply/checkpoint/NPC/spawn positions. |
| Missing FAWE selection | Make WorldEdit selection first, then run /ad admin region copy .... |
| Invalid dungeon | Run /ad admin dungeon validate <id> and fix missing field listed in output. |
| Item creation failure | Verify MMOItems type and id in equipment-config.yml exist and can be created on this server. |
| Run fails to paste | Confirm instance-world exists and schematic file format is readable by WorldEdit/FAWE. |
| Preview shows nothing | Check anchors and saved points exist. Preview only marks stored points. |
Validation-Driven Triage
When validation output includes entries like these, use them literally:
stage-1:schematic-file-existsmeans import file missing.stage-1:supply-npc:expmeans EXP NPC not saved.stage-1:spawn-outside-combat:1:groupmeans spawn lies outside combat region.stage-1:supply-npc-outside-region:statsmeans NPC point is outside copied supply bounds.stage-1:mythicmob:SkeletalMinionmeans MythicMobs id was not found.
Safe Testing Habit
- Validate.
- Preview anchors, teleports, and spawns.
- Enable.
- Run
/ad admin test <id>. - Confirm stage paste, combat spawns, supply NPCs, boss spawn, and cleanup all behave as expected.