Introduction

AramDungeons is round-based PvE content for Paper and Folia servers. Server staff prepare three-stage dungeon files, then players enter through /ad join <dungeon> or party flow and progress through an augment draft, staged combat, supply breaks, and bosses.

Core Loop

1. Players join solo or with a party.
2. Plugin durably snapshots player state before clearing gear and pastes stage 1 into instance world.
3. Players resolve a 20-second Basic augment draft, then clear combat rounds.
4. Round 5 becomes supply round by default, opening augment, stat, potion, EXP, and crafting access.
5. Round 7 becomes boss round by default.
6. On boss clear, plugin rewards players and either pastes next stage or ends run.
7. On finish or quit, plugin restores player inventory and clears spawned instance content.

High-Level Systems

Augments

All 40 runtime augments are enabled. Default picks are Basic at opening, Intermediate at level 5, and Advanced at level 8.

Stats

Gold upgrades permanent run stats like HP, defense, damage, critical damage, and speed.

Potions

Runs start with limited potion charges. Players can spend gold to refill during supply flow.

Crafting

MMOItems-based virtual drops can be upgraded through configured recipes once minimum phase gates are met.

Party Play

Party leaders can invite members and start shared runs. Rewards and enemy counts scale with party size.

Validation

Dungeon setup is validated against missing anchors, missing files, missing NPCs, missing spawns, out-of-bounds points, and missing MythicMob ids.

Crash recovery

Disk snapshots and active instance bounds survive restarts. Interrupted runs are abandoned safely: players restore on join and stale pasted bounds are cleaned instead of attempting a mid-round resume.