CustomDeathMessages

---

📜 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.