ВЕРСИИ (33)

- **Huge v2.0 Update!**: Introduced the **Void Behemoth**! - **New Boss Encounter**: The Void Behemoth (Enderman-type) brings insane new mechanics including *Void Pull*, *Shadow Blindness*, and *Teleport Assault*. - **New Config Integration**: Boss configurations are completely dynamic now and extracted straight to your plugin folder.

- **Big Feature Update**: Actually implemented the missing commands that were previously claimed to exist! Added `/dungeon profile [player]` with full lifetime stat tracking, `/dungeon preview <tier> [hard]`, and `/dungeon queue`. - **Stat Tracking Engine**: Refactored DataStorage to save permanent lifetime statistics for every dungeon participant including Kills, Deaths, Damage Dealt, Damage Taken, and Completions. These stats power the new player profile cards.

- **Critical Fix**: Migrated dungeon token and leaderboard data operations (get/spend) to execute asynchronously off the main thread to prevent significant server lag. - **Bug Fix**: Fixed a critical memory leak where unloading dungeon instance worlds would silently fail if players were inside, permanently stranding the world data in memory until a restart. We now forcefully teleport all remaining players out before unloading.

### 1.4.0 - Added a major player-facing progression update with `/dungeon preview`, `/dungeon queue`, and `/dungeon profile [player]`. - Added persistent per-player dungeon history so clears now track personal bests, weekly activity, combat totals, hard mode clears, and earned token history. - Reworked leaderboard handling with cleaner all-time standings, new `/dungeon leaderboard <tier> weekly`, and duplicate-party spam removed from top times. - Improved `/dungeon quickstart` and `/dungeon help` flow so players can understand previews, ready checks, queueing, recovery tools, and progression loops much faster. - Expanded admin status output to surface instance pressure, queue load, affix/modifier toggles, timeout settings, and unstuck cooldowns. - Fixed SQLite access instability by serializing database work to avoid concurrent access issues under heavier party activity. - Fixed completion tracking so dungeon clear records now snapshot participating players and their combat stats at clear time instead of losing that context later. - Updated Modrinth publishing metadata, removed inline screenshot markdown from the project description, refreshed release copy, and bumped the packaged version to `1.4.0`. ### 1.3.0 - Added in-game Admin Settings GUI: `/dungeon admin settings` (or `/mdadmin settings`) to edit key settings with clicks. - Expanded room template variety across all tiers for more recognizable dungeon themes and stronger replay value. - Added richer dungeon run info with live boss HP, run modifier bonuses, cleared room counts, and remaining timer display. - Added `/dungeon guide <on|off|status|toggle>` for boss compass/actionbar guidance control during a run. - Added `/dungeon quickstart` for faster onboarding and `/dungeon unstuck` cooldown handling improvements. ### 1.2.0 - Added party ready checks before multi-player dungeon launches so leaders can stage a run with `/dungeon create <tier> [hard]` and teammates confirm with `/party ready`. - Added `/party unready`, `/party cancel`, and ready-state visibility in `/party info` for cleaner group coordination. - Improved runtime stability across dungeon generation, chest roll logic, boundary matching, combat downed handling, boss phase updates, and schematic paste fallback behavior. - Fixed build metadata so the packaged plugin version now matches the shipped Gradle release.

### 1.2.0 - Added party ready checks before multi-player dungeon launches so leaders can stage a run with `/dungeon create <tier> [hard]` and teammates confirm with `/party ready`. - Added `/party unready`, `/party cancel`, and ready-state visibility in `/party info` for cleaner group coordination. - Improved runtime stability across dungeon generation, chest roll logic, boundary matching, combat downed handling, boss phase updates, and schematic paste fallback behavior. - Fixed build metadata so the packaged plugin version now matches the shipped Gradle release.

### 1.1.0 - Added: In-game **Admin Settings GUI**: `/dungeon admin settings` (or `/mdadmin settings`) to edit key settings with clicks. - Added: `/dungeon admin status` to quickly view instances/queue/parties/boss counts. - Added: Configurable join message for tokens: `messages.tokensOnJoin.enabled` + `messages.tokensOnJoin.message`. - Improved: Update-checker now fully reloads from config on `/dungeon admin reload` (and via the GUI reload button).

### 1.0.26 - Fixed: `dungeonGeneration.useSchematics` no longer crashes. It now tries to paste schematics via WorldEdit (if installed) and falls back cleanly otherwise. - Added: Configurable update checker via `config.yml` (`updateChecker.enabled`, `projectId`, `projectSlug`, `adminPermission`). - Fixed: Multiple stability fixes in dungeon generation, boss handling, shop editor, and tab-completion.

## MythicDungeons 1.0.25 ### Run Modifiers - Added per-run dungeon modifiers: `Treasure Surge`, `Blood Moon`, `Frostbite`, and `Titanic Boss`. - Modifiers are now rolled automatically by dungeon tier and hard mode pressure. ### Gameplay Impact - Run modifiers now affect token rewards, room chest roll counts, boss health/damage scaling, and live room pressure. - `Blood Moon` empowers nearby room mobs during the run. - `Frostbite` adds constant cold pressure to party movement. ### UX - Added run modifier visibility to `/dungeon info` and `/dungeon list` so party leaders can read the run state instantly.

## MythicDungeons 1.0.24 ### QoL and UX - Added `/dungeon guide <on|off|status|toggle>` to let each player control boss guidance HUD. - Boss actionbar/compass guidance is now opt-out per player, reducing HUD spam in repeat runs. - Added `/dungeon quickstart` with a compact onboarding flow for new players and party leaders. ### Update Reliability - Fixed update-checker slug to the live Modrinth slug (`mythicdungeons`) so update links resolve correctly.

## MythicDungeons 1.0.23 This update is focused on hard stability, boss reliability, and run safety. ### Instance & Runtime Stability - Added an instance watchdog to detect broken runtime states and recover safely. - Added automatic boss runtime recovery attempts before closing a run. - Added safer cleanup flow for unstable runs to prevent stuck/ghost instances. ### Boss Spawn Reliability - Added multi-attempt boss spawn retries when a run starts. - Prevents instant run failure from temporary spawn/chunk initialization issues. - Added direct boss-per-instance tracking for cleaner recovery and management. ### Cleanup & Safety - Improved close/completion cleanup for boss state and recovery caches. - Improved boss guidance behavior when boss is recovering or temporarily missing. - Reduced softlock risk in long sessions. ### Generation Behavior - `dungeonGeneration.useVoidWorld` is now fully respected during instance world creation. ### Chest & Loot Reliability - Added emergency chest refill flow if a chest would open empty. - Added stronger guaranteed fallback rewards for failed insert scenarios. - Improved chest-to-room matching for better room clear/unlock consistency. ### Recommended - Strongly recommended for all servers on older MythicDungeons builds.

### MythicDungeons 1.0.22 - Added 10 brand-new themed room variants for better run variety: - `lantern_tomb`, `roots_sanctuary` - `golem_workshop`, `hanging_gardens` - `void_chapel`, `ember_archive` - `frigid_observatory`, `thunder_foundry` - `astral_crypt`, `harbinger_throne` - Added full fallback decor generation for all new templates, so rooms render properly even when schematics are disabled. - Updated tier room pools in `dungeons.yml` to include the new variants directly. - Fixed high-tier room-count clamping: generation now guarantees at least each tier's configured minimum room count even with a low global hard cap.

### MythicDungeons 1.0.21 - Added `/dungeon info` live run panel with instance ID, tier, hard mode, party size, elapsed/remaining timer, room clear progress, and boss HP status. - Added `/dungeon unstuck` to teleport players to the nearest safe room anchor when trapped in geometry or bad pathing. - Added configurable unstuck anti-spam cooldown in `config.yml` (`commands.unstuckCooldownSeconds`, default `45`). - Added quick aliases `/dinfo` and `/dunstuck` for faster party recovery and run diagnostics. - Improved leave/instance cleanup to clear unstuck runtime cooldown data with other per-player dungeon state.

### MythicDungeons 1.0.20 - Fixed Modrinth update notifier links to use slug/version-number format for reliable direct download pages. - Removed fragile version-ID URL usage and added robust fallback to the versions page. - Maintenance release focused on update-checker stability across server joins.

### MythicDungeons 1.0.19 - Added 10 new themed room variants: mossy_catacomb, ember_sanctuary, thorn_labyrinth, drowned_archive, mirror_gallery, ashen_ossuary, clockwork_vault, abyssal_engine, celestial_maw, bloodforge_cistern. - Added movement boundary containment: players are teleported back to safe dungeon points when leaving playable room/corridor paths. - Added low-Y fail-safe recovery to prevent fall/void escapes and water-push outs from the dungeon route. - Added optional hard perimeter roof generation and improved flooded_crypt water containment. - Added new containment tuning options in config under dungeonGeneration.

### MythicDungeons 1.0.18 - Fixed cases where unlocked room chests could appear empty by using full chest inventory fill flow and adding a guaranteed fallback reward when needed. - Added 10 new themed room variants: crypt_cathedral, flooded_crypt, spider_nest, shattered_forge, bone_pit, spectral_gallery, blood_sanctum, frozen_vault, infernal_foundry, echo_hall. - Added automatic room pool enrichment for existing installs and improved normal-room template selection.

### MythicDungeons 1.0.17 - Reworked room chest rewards to use real chest inventories instead of instant direct-to-inventory grants. - Players now unlock chest loot by clearing room mobs first, then open the chest and take items manually. - Added per-room chest loot preparation flow with tier-aware roll counts (higher tiers can yield more items). - Improved chest open UX message for clearer reward flow.

### MythicDungeons 1.0.16 - Fixed chest clear validation by binding room chests and room mobs with a stable room key metadata (`md_room_key`). - Prevented false 'clear room first' blocks caused by mobs from nearby rooms. - Fixed boss death cleanup edge cases after recover/respawn transitions with safer fallback mapping in BossManager. - Boss HP bar now respects configured `boss.healthBarRange` and only shows in proper range.

### MythicDungeons 1.0.15 - Added per-room random Room Affixes each run: Cursed Fog, Blood Ritual, Frozen Floor. - Added live affix gameplay effects in-room (fog debuffs, ritual drain + monster empower, frozen slow zones). - Added affix visual room markers/decor so players can read mechanics immediately. - Added config controls under roomAffixes for chance, timing, and ritual tuning. - Improved room combat pacing by increasing pressure in affixed rooms.

### MythicDungeons 1.0.14 - Fixed Modrinth update URL generation to use stable version-number links (/version/<version_number>) instead of unstable IDs. - Added URL-safe encoding for version strings in update notifications. - Added safer fallback update link to the project versions page when latest version is unavailable.

### MythicDungeons 1.0.13 - Added Daily/Weekly Dungeon Contracts with configurable tier/deathless/hard-mode requirements and token rewards. - Added SQLite-backed contract progress tracking with automatic daily/weekly period rollover. - Added `/dungeon contracts` command to show live progress and rewards. - Added in-game Admin Shop GUI (`/dungeon admin shopgui`) for fast shop editing without manual YAML edits. - Kept configurable shop backend (`shop.items`) with robust fallback when entries are invalid.

### MythicDungeons 1.0.12 (Reupload Hotfix) - Fixed repeated "Boss spawn failed" runs by hardening boss spawn location checks and chunk preload safety. - Fixed boss health scaling failures on high tiers by adding safe health cap/fallback application logic. - Added emergency boss config fallback when boss sections are missing or invalid. - Kept bossbar and completion handling stability improvements from prior 1.0.12 hotfixes. - Fixed grounded generation behavior and corrected vertical stair orientation in dungeon corridors. - Fixed chest clear-check false positives by validating room-specific dungeon mobs only.

### MythicDungeons 1.0.11 - Added quick party invite via /dungeon invite <player> for easier group flow from the main dungeon command. - Added clickable chat invite actions for invited players with one-click Accept and Decline buttons. - Added /dungeon accept <leader> and /dungeon decline <leader> shortcuts. - Added /party decline <leader> command support and improved invite/accept feedback messages to leader and party members.

### MythicDungeons 1.0.10 - Fixed Dungeon Tokens persistence across server restart/shutdown by making token balance writes immediate and durable in SQLite. - Removed async token write race at shutdown that could drop recent rewards or penalties before process exit. - Hardened token update consistency by synchronizing token mutation operations in storage.

### MythicDungeons 1.0.9 - Maintenance synchronization release for unified plugin versioning across the suite. - Kept OP/admin update notification flow and direct Modrinth link policy aligned for this release line. - No gameplay or balance changes in this release; maintenance update only.

### MythicDungeons 1.0.8 - Compatibility refresh release for broader Modrinth version targeting (1.20 to 1.21.11). - Standardized loader coverage across Bukkit/Folia/Paper/Purpur/Spigot. - No gameplay or balance changes; maintenance release.

### MythicDungeons 1.0.7 - Fixed dungeon runs auto-completing without a boss fight when the boss entity became temporarily invalid (chunk unload/unload-like state). - Added boss recovery logic with safe re-acquire/respawn flow so encounters no longer end instantly without combat. - Added boss-area chunk ticket handling to keep boss encounter chunks loaded during active instances. - Improved loot quality: rarity fallback now degrades intelligently by tier instead of dropping trivial low-value fallback items. - Reworked boss rewards with tier-scaled guaranteed rarity, tier-aware bonus drops, and extra hard-mode token rewards.

### MythicDungeons 1.0.6 - Added underground dungeon generation defaults and configurable generation controls. - Fixed disconnected room layouts by carving real corridors/tunnels between generated rooms. - Added more room gameplay: chest loot across room types and varied non-boss room mob packs. - Added boss leash/combat radius enforcement to prevent cross-map chasing and damage. - Added in-range live boss health bar for party members during boss encounters. - Improved boss variety by reducing immediate same-tier boss repeats and adding spawn fallback logic. - Fixed Party HP bossbar persisting after /dungeon leave, including cleanup on leave/kick/disband. - Fixed lingering downed effects by clearing plugin-managed downed state on dungeon exit/close. - Improved admin update recheck behavior and Modrinth status handling for unlisted/withheld states.

## 1.0.5 - 2026-02-19 - Fixed startup failure on servers without WorldEdit by removing direct hard linkage from dungeon generation and switching schematic paste integration to runtime reflection checks. - Added safe fallback behavior: if WorldEdit is missing or incompatible, dungeon rooms are generated using the built-in fallback room builder instead of plugin disable. - Hardened plugin lifecycle error handling by catching startup/shutdown Throwable to ensure clear logging and graceful disable on unexpected classloading/runtime errors.

## 1.0.4 - 2026-02-19 - Added automatic Modrinth update checks and OP/admin join notifications with direct download links. - Added asynchronous update checker scheduling with cached latest-version state for low-overhead player join behavior. - Added permission-aware update announcements for `mythicdungeons.admin` and server operators.

## 1.0.3 - 2026-02-13 - Fixed async database query execution to run through Bukkit's async scheduler instead of the JVM common pool, improving plugin lifecycle safety and reducing stray async work after reload/disable. - Hardened async database task scheduling with explicit scheduler-failure handling and error propagation for async query futures. - Improved SQLite connection lifecycle cleanup by nulling the shared connection reference after close. - Added null-safe max-health handling in party HP boss-bar aggregation to avoid rare attribute-null runtime errors. - Added null-safe max-health fallback in respawn compensation and Nature Guardian totem healing logic to prevent edge-case boss/player attribute failures.

## Fixes and Improvements (1.0.2) - Fixed admin command input validation for dungeon tier and boss type so invalid values no longer silently fall back to default options. - Fixed boss spawn config parsing to safely handle invalid entityType values and automatically fall back to the default entity for each boss. - Improved shop inventory protection by cancelling all click transfer interactions while the dungeon shop is open, preventing item movement exploits. - Fixed instance close cleanup so player-to-instance mappings are removed even when party data is unavailable. - Improved instance world cleanup safety by skipping world-folder deletion when world unload fails. - Added chest-loot memory cleanup on world unload to prevent long-run stale loot cache growth.

## Fixes and Improvements (1.0.1) - Fixed weekly competition rewards so tokens are now granted to the actual winning party members instead of a random online player. - Added safer weekly reward processing with error handling and online notifications for rewarded members. - Fixed shop click handling so purchases only trigger from the shop inventory itself, preventing accidental or exploitable purchases from player inventory clicks. - Improved token economy consistency by using atomic token updates in storage and adding an atomic spend check for shop purchases. - Fixed dungeon creation queue duplication by preventing the same party from being queued multiple times. - Added queue processing guards to prevent duplicate instance creation when a queued party already has an active dungeon. - Reduced downed-state message spam by throttling revive countdown notifications. - Improved revive safety with max-health fallback handling. - Hardened boss spawning for invalid non-living entity configuration and missing max-health attributes. - Improved dungeon room conversion so forced treasure, trap, and boss assignments also update room templates consistently. - Improved party shutdown cleanup by hiding boss bars and clearing temporary downed-state runtime caches. - Hardened respawn compensation scheduling to safely handle disconnects between respawn event and delayed task.

Initial release with procedural instanced dungeon generation, party and revive systems, 5 custom bosses with phased AI, rarity-based loot economy, scaling, and leaderboard support.