---
### 📜 CHANGELOG - CustomDeathMessages v0.0.5
Prepare for the ultimate death experience! Version 0.0.5 is a massive overhaul that transforms the plugin with epic new mechanics, economic integration, and a complete help system.
#### ✨ New Features
* **Added: Epic Death System**
There's now a small, configurable chance (`epic-death-chance` in `config.yml`) for a death to be **EPIC**! When triggered, it displays a special message, plays a powerful sound, spawns spectacular particles, shows a full-screen title, and... strikes a lightning bolt at the death location!
* **Added: In-Game Help Command (`/cdmhelp`)**
Need a quick reference? Use `/cdmhelp [page]` to access a comprehensive, multi-page guide directly in-game, covering commands, permissions (including `cdm.admin`), placeholders, configuration options, and support.
* **Added: Vault Economy Integration**
Servers can now charge players a configurable fee (`cost-per-death-message` in `config.yml`) to display death messages. Specific permission groups (like "admin") can be exempted from this cost via the `exempt-groups-from-cost` list.
* **Added: Legacy Color Support**
For servers running older versions of Minecraft (pre-1.16), the new `legacy-color-support` option in `config.yml` will automatically strip modern hex color codes (`<#rrggbb>`) from messages, preventing them from appearing as plain text.
* **Added: Conditional Death Messages**
You can now configure messages that only display if a specific condition is met. For example, you can have a unique message if the victim was holding a diamond weapon or was under the effect of poison. Defined in `messages.yml` using the `condition` and `message` syntax.
* **Added: New Configuration Options**
The `config.yml` file has been significantly expanded with new, powerful settings:
* `epic-death-chance`: Probability (0.0 to 1.0) of an epic death occurring.
* `cost-per-death-message`: The amount to charge players (requires Vault).
* `exempt-groups-from-cost`: A list of permission groups (e.g., `- "admin"`) that do not pay the death message cost.
* `legacy-color-support`: Enables compatibility mode for older Minecraft versions.
#### 🐛 Bug Fixes
* **Fixed: Inaccurate or "Unknown" Killer Names**
Implemented a brand new, robust damage-tracking system. The plugin now **100% accurately** identifies the killer's name (`{killer}`), even in complex scenarios like falling to your death after being pushed by a mob.
* **Fixed: Modern Sound Name Support**
The plugin now fully supports the new, lowercase sound names used in modern Minecraft (e.g., `entity.player.death` instead of `ENTITY_PLAYER_DEATH`), ensuring perfect compatibility.
* **Fixed: Update Checker Targeting Wrong Plugin**
The automatic update checker has been refined to ensure it **only checks for updates for CustomDeathMessages**. It will no longer incorrectly notify you about updates for other plugins. It correctly notifies server administrators (players with the `cdm.admin` permission or OP) when a new version is available, providing a direct download link.
#### 🛠️ Improvements & Optimizations
* **Improved: Overall Performance**
Implemented an advanced caching system for messages and configurations, drastically reducing file reads and boosting plugin speed.
* **Improved: Asynchronous Message Sending**
Sending messages to other players (especially in a radius) is now done in the background, preventing the game from lagging during mass-death events.
* **Updated: Configuration Files**
Both `config.yml` and `messages.yml` have been completely overhauled with new parameters, examples, and a clearer structure to support all the exciting new features.
Developer information
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle.
maven { name = "Modrinth"; url = "https://api.modrinth.com/maven" }
