ArcadiaDungeon

[1.0.0] — 2026-04-29 — Server-side release

Initial public release of Arcadia Dungeon for NeoForge 1.21.1.

Added

Core dungeon system

• Full JSON-driven dungeon configuration with schema validation
• Hot-reload support via /arcadiadungeon admin config reload
• Multi-dimension spawn point support
• Configurable global announcements on start, completion and failure (%player%, %dungeon% placeholders)
• Per-player, per-dungeon cooldowns
• Auto-teleport back to origin on completion
• Dungeon recruitment phase with configurable duration

Boss system

• Multi-phase bosses with HP-threshold-based phase transitions
• Automatic player-count scaling for boss health and damage
• Per-phase invulnerability windows between transitions
• Post-spawn invulnerability (configurable, default 5 s)
• Per-phase minion summoning with custom broadcast messages
• Independent damage and speed multipliers per phase
• Configurable damage type immunity
• Server boss bar with configurable color
• Three spawn modes: spawnAtStart, requiredKill, spawnchance
• Optional bosses: boss bar hidden until first player hit
• Boss bar only shown for bosses that actually spawn
• Configurable boss spawn and skip messages via commands

Wave system

• Sequential enemy waves with configurable entity types, counts and delays
• Configurable required actions per wave (kill all, wait timer, etc.)
• Wave count scaling support
• Fixed: optional bosses no longer block wave progression

Weekly leaderboard

• Best-time ranking per dungeon, updated in real time
• Automatic weekly reset (configurable day, default Monday)
• Scheduled broadcast announcement with configurable hour
• Full archive of past weeks stored in JSON
• Separate reward lists for top 1, top 2 and top 3
• Duplicate reward protection via rewarded flag

Player progression

• Arcadia XP awarded on dungeon completion (configurable per dungeon)
• Minimum Arcadia level requirement per dungeon
• Speedrun mode: time threshold with configurable bonus XP
• Per-UUID player data persisted in dedicated JSON files
• Arcadia progression profile with XP tuning support

Admin GUI

• Central AdminGuiRouter panel accessible in-game
• Dungeon management: enable/disable, config editing, forced reload
• Active boss and entity management
• Player progression tracking: XP levels, cooldowns, history
• Real-time support and diagnostic tools
• Stabilised admin GUI and progression flows

Commands

• Player commands: list, info, join, leave, reload
• Full admin command tree under /arcadiadungeon : boss, wave, config, support
• 20+ admin commands added following full audit
• Admin commands for per-phase combat tuning (damage/speed multipliers)
• Clickable [QUITTER] button injected into join and start messages

Security & compatibility

• Anti-parasite system preventing free-riding on active runs
• Anti-fly enforcement during dungeon runs
• LuckPerms permission nodes: arcadia_dungeon.bypass.antiparasite, arcadia_dungeon.bypass.antifly
• Fixed: players who /back into an active dungeon area after leaving are now kicked
• Fixed: availability announcement spam — added delays and recipient filter
• Fixed: PermissionGatherEvent registered on NeoForge bus (not mod bus) to prevent crash
• Fixed: LuckPerms permission crash on PermissionGatherEvent using @SubscribeEvent
• Apotheosis charm suppression (Curios / Accessories compatibility)
• Completion celebration delay added for better UX flow
• Shared utilities migrated to Arcadia Core

Technical

• Package renamed and command architecture reorganised
• Event handlers refactored and hardened
• Dungeon runtime and combat flow stabilised
• Memory leak fixes identified and resolved in full audit
• Performance optimisations applied across the dungeon runtime
• All code review blockers corrected (epics 1–7 finalised)