# [3.0.0](https://github.com/lidanthedev/CaveCrawlers/compare/v2.0.2...v3.0.0) (2026-10-29) ### Bug Fixes * close coverage regressions ([6cc8f90](https://github.com/lidanthedev/CaveCrawlers/commit/6cc8f90de9992052a8a2b9213a0dfd2bb0f0112a)) * close follow-up review findings ([c0a2b17](https://github.com/lidanthedev/CaveCrawlers/commit/c0a2b172f229fa204109eb9edcf08d4be07fa335)) * close verified review findings ([5f5be26](https://github.com/lidanthedev/CaveCrawlers/commit/5f5be26d38365284bdb6164cee66e799bea509c3)) * correct economy and reset edge cases ([d889ae8](https://github.com/lidanthedev/CaveCrawlers/commit/d889ae8e01413ee1ed75f5a5b82d1692d340ef64)) * detect absorption metadata across server mappings ([07d181b](https://github.com/lidanthedev/CaveCrawlers/commit/07d181b242cb134139d74c1f9ee415ef821b1b33)) * **events:** close addon action gaps ([f19b001](https://github.com/lidanthedev/CaveCrawlers/commit/f19b0017180703622928986a25599824d3e1050d)) * **events:** close addon event gaps ([d52cfb6](https://github.com/lidanthedev/CaveCrawlers/commit/d52cfb6837f5ac5ec8ae1f6d415f819492af3296)) * guard absorption adapter linkage and player refreshes ([16c79a5](https://github.com/lidanthedev/CaveCrawlers/commit/16c79a5a9b4dd942235b8c1540e5d6c9939853dd)) * isolate absorption scaling across reloads ([192d6b4](https://github.com/lidanthedev/CaveCrawlers/commit/192d6b488b9e84fdc5a6395d136882127dcb70fc)) * normalize sale payouts and preserve projectile ability provenance ([b45a5d3](https://github.com/lidanthedev/CaveCrawlers/commit/b45a5d39701ef271ffc2caad819d05ce4e5b78ff)) * rebuild skills from total xp ([cd23281](https://github.com/lidanthedev/CaveCrawlers/commit/cd2328150aa6d2c3a6be018526b4a7fc8d6129e0)) * **reload:** load addon providers before dependent telemetry consumers ([2e0a83d](https://github.com/lidanthedev/CaveCrawlers/commit/2e0a83d105892e0d25078887269c2ae6a78e292c)) * require canonical custom item identity ([56c37c9](https://github.com/lidanthedev/CaveCrawlers/commit/56c37c9deb20a5b4a97bf43c64eee7072efaf599)) * **SandStorm:** fix damage calculation for falling blocks ([0549bcf](https://github.com/lidanthedev/CaveCrawlers/commit/0549bcf846cb1e19cdd5de30e08821316ac9f0cd)) * **shop:** improve price validation for shop items ([895ec75](https://github.com/lidanthedev/CaveCrawlers/commit/895ec7574dd71d357b240bdd89ce6814b35bdcda)) * **storage:** avoid reload heartbeat delay ([3b24db8](https://github.com/lidanthedev/CaveCrawlers/commit/3b24db8b1db3029a837993016481cea3bf54fa77)) * **storage:** defer reload loads off main thread ([efb3a0c](https://github.com/lidanthedev/CaveCrawlers/commit/efb3a0ce207a689d083e771b99511c365a5c8f20)) * **storage:** defer server ID rotation ([6e24e56](https://github.com/lidanthedev/CaveCrawlers/commit/6e24e5626736c43a8b50df051d165b0ed42213cb)) * **storage:** fence player persistence ([5e3b079](https://github.com/lidanthedev/CaveCrawlers/commit/5e3b07920c03b9daf78d9ffb8c24ff8f2afc04ee)) * **storage:** forbid live lock reclamation ([6b0ae56](https://github.com/lidanthedev/CaveCrawlers/commit/6b0ae56bc89b26a235330966eed2610393708237)) * **storage:** reject unsafe persistence sessions ([1541312](https://github.com/lidanthedev/CaveCrawlers/commit/1541312e1038717b0aed4ae1026ad1ba97f50f59)), closes [#126](https://github.com/lidanthedev/CaveCrawlers/issues/126) * **storage:** require successful load before save ([d297f72](https://github.com/lidanthedev/CaveCrawlers/commit/d297f72c15f6f1da71c4d28f96330d7c3e4ef153)) * **storage:** retry loads and refresh leases ([6080ae0](https://github.com/lidanthedev/CaveCrawlers/commit/6080ae070f7796e22246e2f37c87542f24b17403)) * **storage:** sync player loads on reload ([a387a8d](https://github.com/lidanthedev/CaveCrawlers/commit/a387a8d6cbbd0b4e0e600a99b33cf4b0f9867085)) * **test:** update shop item display logic in tests ([2e4cb5e](https://github.com/lidanthedev/CaveCrawlers/commit/2e4cb5eb11bac53e3ddf7925624ba85e45ce734f)) * validate stat deserialization values ([63205fe](https://github.com/lidanthedev/CaveCrawlers/commit/63205fe49d1b381a39819bc7bbd3724a3f95f274)) ### Features * add cancellable currency requests and reload title ([b724b96](https://github.com/lidanthedev/CaveCrawlers/commit/b724b96e159bf71cf43aceb53d6fc5b7cc415839)) * add sell admin GUI and sync prices functionality ([8349ecf](https://github.com/lidanthedev/CaveCrawlers/commit/8349ecf90427f81481ed6266c0b4795006642861)) * **events:** add addon action hooks ([2478824](https://github.com/lidanthedev/CaveCrawlers/commit/247882401cf23c77710e7fd76f9102fa2b13f59b)) * expose successful economy, item, combat and progression observations ([da69b11](https://github.com/lidanthedev/CaveCrawlers/commit/da69b1113c4653ca03982bca186c372d8cdbc3b8)) * **items:** add item build, update, ability use events ([e4ce902](https://github.com/lidanthedev/CaveCrawlers/commit/e4ce902fb41d28e151b4cd4201eeaf50ceb3532b)) * scale native absorption to one golden-heart row ([6e174d4](https://github.com/lidanthedev/CaveCrawlers/commit/6e174d4d3944ef4cf6aa133f8644bb87705a9ba2)) * show native absorption in the action bar ([b42d6ba](https://github.com/lidanthedev/CaveCrawlers/commit/b42d6ba50b80c0c70290f193ecd3fb8616d676a2)) * update ItemsManager to use LinkedHashMap and enhance ShopEditor item interaction ([2af4e8d](https://github.com/lidanthedev/CaveCrawlers/commit/2af4e8d9254673c0fc8fd2758c4e6c83ec309913)) ### Reverts * **storage:** restore synchronous player loads ([692e0d4](https://github.com/lidanthedev/CaveCrawlers/commit/692e0d45d2cf68bc6f24ebee6b4ae2a16ce8f130)) ### BREAKING CHANGES * **storage:** PlayerDataSqlTable callbacks now receive the active Jdbi Handle.

## [2.0.2](https://github.com/lidanthedev/CaveCrawlers/compare/v2.0.1...v2.0.2) (2026-08-22) ### Bug Fixes * **storage:** guard player load and save races ([29243cc](https://github.com/lidanthedev/CaveCrawlers/commit/29243cc25d86ccb284c35f55b191570ae7ee98d4)) * **storage:** harden async player saves ([ec8e050](https://github.com/lidanthedev/CaveCrawlers/commit/ec8e050b7b8abf45b45bcf77a842251327f231d9)) * **storage:** prevent skill wipe on reconnect ([46f834f](https://github.com/lidanthedev/CaveCrawlers/commit/46f834fb9b763fa34de03c0bb2a5a6de823a381f))

fix negative health stats

# [2.0.0](https://github.com/lidanthedev/CaveCrawlers/compare/v1.4.2...v2.0.0) (2026-08-08) ### Warning MAJOR CHANGES This version changed how drops are detected by checking mythic mob id instead of display name any api checking for display name will not work and `BossAPI` and `DropsAPI` if mob with display name doesn't exist the file will not be migrated and will be skipped ### Bug Fixes * index with mob id changes ([0ac4e99](https://github.com/lidanthedev/CaveCrawlers/commit/0ac4e99f87ff8350d4297b148d9f84d11e4403d1)) * removed unsed default value when creating BasicDefaultVersioning ([301a55a](https://github.com/lidanthedev/CaveCrawlers/commit/301a55ac196b4e505ebd24a0e13917b1d0220453)) * require plugman to be enabled ([3d0f636](https://github.com/lidanthedev/CaveCrawlers/commit/3d0f636908e890715ef5c7b2bf694bbe3ab9e2cc)) * unstable dragon throws errors ([14ee8b8](https://github.com/lidanthedev/CaveCrawlers/commit/14ee8b8e490d903c7eb417b0defaefd8301e6e73)) * update boss_name placeholder to use mob name from MythicMobsHook ([1d78e9c](https://github.com/lidanthedev/CaveCrawlers/commit/1d78e9cef7113b9196cc470dbf0180aff16d9a13)) ### Features * add caching for MiniMessage deserialization to improve performance ([0feefd8](https://github.com/lidanthedev/CaveCrawlers/commit/0feefd86758926bc0dcfa9ac9f8024721ea1e9e6)) * add command completion provider for online players ([0dc39d1](https://github.com/lidanthedev/CaveCrawlers/commit/0dc39d16d75cc428efcdbd6ec7e6507d58eb01f1)) * add overloaded constructor for BasicDefaultVersioning to support default lastVersion ([55afa94](https://github.com/lidanthedev/CaveCrawlers/commit/55afa94de33e558d14cdc499ec95d7917af7c469)) * clear item cache in reload commands to ensure fresh data loading ([7f5e1ff](https://github.com/lidanthedev/CaveCrawlers/commit/7f5e1ff5b6c75420b5f0d20e16c56d28cc1bb6bb)) * enhance MiniMessage caching with LRU eviction and improve error logging in Stats deserialization ([21a3194](https://github.com/lidanthedev/CaveCrawlers/commit/21a3194dc6249129533c33e4e7ae2af2ef81c4c4)) * implement BoostedUpdaterSettings for enhanced version management and refactor BasicDefaultVersioning ([6ac1fde](https://github.com/lidanthedev/CaveCrawlers/commit/6ac1fde764327a192ee24cd03d1589dfa8633709)) * implement item caching in category menus to enhance performance ([56615df](https://github.com/lidanthedev/CaveCrawlers/commit/56615df946f38414791d7515985ddb108ef50e6a)) * implement mob ID caching and update error item creation ([13554a0](https://github.com/lidanthedev/CaveCrawlers/commit/13554a012df74ded019598c21f0a59b71dee4b8c)) * implemented lite reload and fix some commands ([7226010](https://github.com/lidanthedev/CaveCrawlers/commit/722601035b44d68c4ad79f6cef94af7c913a2885)) * integrate MythicMobs for entity drop management using mob IDs ([72b7c49](https://github.com/lidanthedev/CaveCrawlers/commit/72b7c4969a6974131ef9e9dfc22042a68ca1a6e6)) * migrate from entity name to mob ID in BossDrops and related classes ([05eff85](https://github.com/lidanthedev/CaveCrawlers/commit/05eff85187f1f4b58cc941e0a22343cc5f9e8965)) * synchronize MiniMessage cache to ensure thread safety ([0eb16ad](https://github.com/lidanthedev/CaveCrawlers/commit/0eb16ad84c45a49727a270e3b2c5da7d6e5b3de0)) * update API methods to use MythicMobs internal mob ID for registration and retrieval ([1886ab8](https://github.com/lidanthedev/CaveCrawlers/commit/1886ab8bbe89eef42a20e09b57d6c50026a8ac7a)) * update BossAPI and related classes to use mob IDs instead of entity names ([46cc3a0](https://github.com/lidanthedev/CaveCrawlers/commit/46cc3a099f5fa91c5a09bdaa3a07ef30be5e4925)) * feat(drops)!: mark MythicMobs ID migration as breaking ([f5727ec](https://github.com/lidanthedev/CaveCrawlers/commit/f5727ec6f49dd4e5c12ce9e2c29839ed07532387)) ### BREAKING CHANGES * the prior MythicMobs migration replaced entityName configuration and name-based APIs with mobId-based IDs.

## [1.4.2](https://github.com/lidanthedev/CaveCrawlers/compare/v1.4.1...v1.4.2) (2026-08-07) Fixes for Gui in mc 26 ### Bug Fixes * **sell:** allow held item pricing ([a5f8307](https://github.com/lidanthedev/CaveCrawlers/commit/a5f8307a198cff2b56992e012a3d9756fac6baa9)) * update triumph-gui dependency to use forked version until official update ([967ea05](https://github.com/lidanthedev/CaveCrawlers/commit/967ea05700b8c5c023986da77d9c201bdc2e88eb))

## [1.4.1](https://github.com/lidanthedev/CaveCrawlers/compare/v1.4.0...v1.4.1) (2026-08-01) ### Minecraft 26.2 Support * Added support for Minecraft 26.2 ### Bug Fixes * update sound command completions to filter null values ([1aa57a7](https://github.com/lidanthedev/CaveCrawlers/commit/1aa57a7825b6225d3f4ff53614d5140a6962458c)) ### Technical * Upgrade lamp to v4

* **New Features** * Added startup and shutdown cleanup for tracked entities. * Restored broken mining blocks more reliably during chunk unloads and app startup. * Improved loading protection so incoming actions can be blocked until player data is ready. * **Bug Fixes** * Made login access more flexible during database startup/recovery. * Fixed projectile damage handling for entities with missing attack attributes. * Improved skill XP handling so rewards are only applied when data is available. * **Permissions** * Updated command access to use new admin and stats permissions * **Config** * Enabled new mining persistence restore and updated experimental defaults.

# 26.1 Support Added Support to Minecraft 26.1 # Yaml To Database Player data migarted to a Database instead of file per player Using H2 by default and allowing you to use MySQL instead Please Note that MySQL support has some problems with syncing between servers if the database server is slow # Better MythicMobs Support integrate MythicMobs health data for sorting in category menus # Expiermental Features Added MythicMobs item supplier feature that allows you to use cavecrawlers items in mythicmobs (requires restart)

* **New Features** * Introduced SandStorm ability with configurable effects and damage scaling * **Improvements** * Stat commands now default to the invoking player and support explicit targetting with clearer confirmations * **Documentation** * Added comprehensive Drops guide covering entity/block/boss/altar drops with examples * **Refactor** * Converted several fixed enums into dynamic registries to improve extensibility This version is not new its from 2026-03-29

# 📦 Version 1.1.0 — The Index This release introduces a comprehensive in-game Index system, upgrades the underlying engine to **Paper 1.21.11**, and brings significant quality-of-life improvements to shop automation and player data management. > ### ⚠️ Breaking Changes > > > * **Minecraft Version:** **Minecraft 1.19 is no longer supported.** This version is built specifically for modern environments. > * **Java Version:** This update requires **Java 21** or higher. Please ensure your server startup script or hosting panel is updated. > > --- ### 🧪 Experimental Features The following features are disabled by default and can be enabled in the `config.yml`. **Use with caution** as they may impact performance or stability: * **Cooldown Animations:** Visual cooldown animations for abilities. (`enable-cooldown-animation`) * **Advanced Hammer Sorting:** Sort blocks by **distance** or **block face** (useful for specific mining behaviors, but may increase CPU load). (`hammer-sort-by-distance`,`hammer-sort-by-face`) ### 🚀 New Features * **In-Game Index System:** A searchable GUI for Mobs, Blocks, Bosses, and Altars. Includes controls for hidden entries and sorted listings. use with `/index` in the future will also allow admins to edit drops * **Targeted Data Commands:** Admins can now target specific players for `load`, `save`, and `reset` operations. * **MythicMobs Support:** Native name lookup support for MythicMobs. * **Face-Aware Mining:** Improved hammer mechanics that intelligently account for the block face being hit. * **Enhanced Profile Viewer:** Off-hand items now render correctly in the Player Viewer GUI. * **Advanced Rewards:** Added support for command-based drops and range-based drop logic. ### 🛠️ Improvements * **Platform Update:** Fully updated to **Paper 1.21.11**. * **Config Engine:** Migrated to **BoostedYAML** for more robust and flexible configuration management. * **CI/CD:** Updated build pipeline to use JDK 21 and publish build artifacts automatically. ### 🐛 Bug Fixes * **Data Stability:** Improved player data caching and resolved inconsistent save behaviors. * **Null Safety:** Extensive "null check" pass across shop and skill modules to prevent random crashes. * **Shop Logic:** * Resolved issues with shop syncing. * **Entity Tracking:** Fixed damage credit tracking for spawned living entities. * **Validation:** Skill configurations now skip invalid entries instead of failing entirely. * Prevented duplicate portable-shop assignments to a single item. * Fixed errors caused by missing stat entries via safe-retrieval logic.