CustomDeathMessages

📜 CHANGELOG - CustomDeathMessages v1.1

⚠️ A Sincere Apology
We sincerely apologize for any instability or missing features in v1.0. This major update introduces a complete architectural redesign to enhance reliability, maintainability, and future extensibility. Thank you for your patience and invaluable feedback.

🗑️ Removed Features

• ❌ Removed: In-Game Configuration Editor (/cdm editor)
  The in-game editor has been completely removed from the plugin. This decision was made to streamline development, improve stability, and focus resources on core features like the new broadcast system. All configuration must now be managed by directly editing the config.yml and messages.yml files.

🌟 Major New Features

• ✅ Added: Advanced Broadcast System
  Introduce fine-grained control over who sees death effects (messages, sounds, particles, titles, action bars) with four new broadcast modes:

  • GLOBAL: All online players on the server
  • WORLD: All players in the same world
  • RADIUS: Players within a configurable distance
  • VICTIM_ONLY: Only the dying player
    Configurable globally and per-effect type directly in config.yml.

• ✅ Added: Powerful /cdm broadcast Command Suite
  A new admin command to test and trigger broadcast effects manually:

  • /cdm broadcast sound <mode> [radius] [sound]
  • /cdm broadcast particle <mode> [radius] [particle]
  • /cdm broadcast message <mode> <message>
  • /cdm broadcast test – Simulates all broadcast modes
  • /cdm broadcast global <type> – Send an effect to all players instantly.

• ✅ Added: Full Support for Minecraft 1.21.11
  The plugin has been updated and thoroughly tested to be fully compatible with Minecraft 1.21.11, including all new sounds, particles, biome names, and API changes introduced in this version. Configuration defaults and validation now reflect 1.21.11 standards.

🐛 Critical Bug Fixes

• ✅ Fixed: Inaccurate Killer & Source Identification
  The system for determining {killer_name} (the responsible entity) and {killer_source} (the direct damage source, like an arrow or TNT) has been completely rewritten. It now correctly handles:

  • Projectiles (arrows, fireballs) from players, mobs, and dispensers.
  • Direct entity attacks (players, zombies, creepers).
  • Edge cases where the default game API returns incomplete data.

• ✅ Fixed: Server Startup Crash on Invalid Configuration
  In v1.0, certain misconfigurations could cause the plugin to crash during server startup. This has been resolved with a safer, staged initialization process that guarantees all internal systems load in the correct order.

• ✅ Fixed: Incorrect Placeholder Values
  Placeholders like {distance}, {biome}, and {victim_effects} now display accurate, properly formatted values (e.g., "nether_wastes" is now shown as "Nether Wastes").

🛠️ Significant Refinements & Improvements

• ✅ Refined: Configuration & Messages Structure

  • config.yml now includes new, intuitive settings for the broadcast system (sound-broadcast-mode, particle-broadcast-mode, and a unified effects-broadcast section).
  • messages.yml is now on version 1.1 and includes a new broadcast-system section with fully configurable messages for all new /cdm broadcast commands.

• ✅ Enhanced: Configuration Validation
  The /cdm config validate command now checks the new broadcast settings for validity, preventing misconfiguration and providing clearer, more actionable feedback.

• ✅ Plugin Version Bump
  The plugin’s version has been officially updated to 1.1 to reflect this major feature release.

📜 CHANGELOG - CustomDeathMessages v1.0.0

⚠️ A Sincere Apology
I deeply apologize for the extended 4-week gap without updates and for not addressing these critical issues sooner. Thank you for your patience and continued support.

🐛 Critical Bug Fixes

• ✅ Fixed: Broken Killer Tracking & Generic Messages
  The plugin consistently failed to identify the correct killer ({killer_name}) and damage source ({killer_source}), resulting in generic "Unknown" messages. The DamageTracker and message formatter have been overhauled to accurately track and display killer information in all scenarios.

• ✅ Fixed: In-Game Editor Inventory (80% Non-Functional)
  The /cdm editor inventory was largely unresponsive, with most slots failing to register clicks or open sub-menus. This has been resolved; the editor is now stable and functional for basic navigation and message editing.

ℹ️ Important Notes

• 🛠️ Editor Status: Early Access (≈30% Complete)
  While the core functionality of the in-game editor now works, it is not fully implemented. Features like editing global config, world-specific messages, and epic message lists are either limited or not yet functional. The editor is provided as an early-access tool for basic message customization, with full completion planned for a future release.

📜 CHANGELOG - CustomDeathMessages v0.0.9

The plugin continues to evolve! Version 0.0.9 introduces a comprehensive command restructuring that unifies all functionality under a single command interface while simplifying permissions and improving the overall user experience. This release focuses on consistency, usability, and maintainability, making the plugin more intuitive for administrators and reducing complexity for end-users.

⚠️ UPDATE INSTRUCTIONS
No special migration steps are required for this update. However, please note:

1. The previous separate commands (/cdmreload, /cdmconfig, etc.) will no longer function as standalone commands
2. All functionality is now accessed through the unified /cdm command
3. Your existing configuration files will work without modification
4. Permissions have been simplified - if you were using the old permission system, no changes are needed
5. The messages.yml file has been reorganized and translated from Spanish to English - If you want to use the updated structure, you should delete your existing messages.yml file and let the plugin regenerate it with the new format. If you prefer to keep your current configuration, no action is needed as the plugin will maintain compatibility with your existing file.

✨ New Features

• Added: Unified Command System
  All commands have been consolidated under a single /cdm command structure:

  • /cdm test - Test death messages (replaces /cdm test)
  • /cdm editor - Open configuration editor (replaces /cdm editor)
  • /cdm help - Access help system (replaces /cdmhelp)
  • /cdm config validate - Validate configuration (replaces /cdmconfig)
  • /cdm reload - Reload configuration (replaces /cdmreload)
  • This simplifies command management and provides a consistent interface

• Added: Base Permission System
  A new base permission cdm.use has been introduced:

  • Grants access to the main /cdm command and its subcommands
  • Default: true (all players can use the command)
  • Other permissions (cdm.reload, cdm.editor, etc.) now function as sub-permissions within the unified system

• Added: Enhanced Command Tab Completion
  A new unified tab completer provides context-aware suggestions:

  • Shows only relevant subcommands based on user permissions
  • Provides contextual suggestions as you type
  • Improves discoverability of available commands and parameters

• Added: Streamlined Help System
  The help system has been updated to reflect the new command structure:

  • Now provides clear guidance on the unified command interface
  • Includes examples of the new command syntax
  • Maintains all the interactive features from previous versions

• Added: Reorganized & Translated Messages Configuration
  The messages.yml file has been completely restructured and translated to English:

  • All sections previously in Spanish are now in English
  • More consistent structure for easier navigation
  • No functional changes - only language and organization
  • Note: If you want to use the new structure, delete your existing messages.yml and let the plugin generate a new one

🐛 Bug Fixes

• Fixed: Command Permission Conflicts
  Resolved issues where permission checks failed due to the previous fragmented command system, ensuring consistent permission handling.

• Fixed: Tab Completion Conflicts
  Fixed tab completion issues that occurred when multiple commands with the same name but different permissions were registered.

• Fixed: Command Execution Flow
  Corrected edge cases where command execution would fail when using certain parameter combinations with the previous command structure.

🛠️ Improvements & Optimizations

• Improved: Code Architecture
  Restructured command handling to use a single executor pattern, reducing code duplication and improving maintainability.

• Improved: Resource Management
  Optimized the reinitialization process when reloading configuration, ensuring all dependent components are properly reset.

• Improved: Error Handling
  Enhanced error messages when using invalid subcommands or parameters, providing clearer guidance to users.

• Optimized: Permission System
  Simplified the permission structure with a logical hierarchy that's easier to understand and manage:

  • cdm.use (base access)
  • cdm.reload (advanced permissions)
  • cdm.editor (specialized access)
  • cdm.test (testing access)

With version 0.0.9, CustomDeathMessages delivers a more cohesive, professional, and user-friendly interface while maintaining all the powerful features from previous versions. The unified command system provides a consistent experience across all plugin functionality, and the improved permission structure makes administration simpler. The reorganization of messages.yml and translation to English ensures better compatibility with international server environments while maintaining full backward compatibility. These changes lay the foundation for future enhancements while delivering immediate improvements to the day-to-day experience of using the plugin.

📜 CHANGELOG - CustomDeathMessages v0.0.8

The evolution continues! Version 0.0.8 builds upon the solid foundation of v0.0.7 with two essential new tools: a built-in in-game configuration editor and automatic update notifications. This release focuses on improved administrator experience, transparency, and accessibility, ensuring your custom death message configuration is more manageable than ever.

⚠️ UPDATE INSTRUCTIONS
To fully leverage the new features:

1. Back up your current messages.yml file
2. Delete the messages.yml file from your server's plugins/CustomDeathMessages/ folder
3. Restart or reload the server. The plugin will generate new configuration files with all new options
4. Manually transfer your custom messages from your backup to the new messages.yml

✨ New Features

• Added: In-Game Configuration Editor (/cdm editor)
  The flagship feature of this version! This interactive system allows administrators to edit configuration directly from the game without needing to access server files:

  • Intuitive menu navigation with categories for groups, causes, and settings
  • Real-time message preview with placeholder substitution
  • Validation of placeholders during editing
  • Confirmation before saving changes
  • Supports editing conditional messages and group-specific messages (default, vip, admin)
  • New permission node cdm.editor for access control

• Added: Update Notification System
  The plugin now automatically checks for new versions on startup and notifies administrators when they join the server:

  • Checks Modrinth for updates on server startup
  • Notifies players with cdm.admin permission or OP when they join
  • Configurable notification messages in messages.yml
  • Direct link to the plugin page for easy updating

• Added: New /cdm editor Command
  A dedicated entry point to access the in-game configuration editor. Requires the cdm.editor permission.

• Added: Support for Minecraft 1.21.9 and 1.21.10
  The plugin has been verified to work with the latest Minecraft versions, ensuring compatibility with the newest server features and mechanics.

🐛 Bug Fixes

• Fixed: Improved Validation System
  The configuration validator now provides more detailed error descriptions, especially for conditional messages, making it easier to identify and fix configuration issues.

• Fixed: Editor Compatibility
  Fixed issues that could occur when editing messages while the plugin was reloading, ensuring a more stable editing experience.

🛠️ Improvements & Optimizations

• Improved: Administrator Experience
  The in-game editor eliminates the need for manual file editing, significantly reducing the risk of syntax errors and making configuration changes faster and safer.

• Improved: Help System
  The help system has been optimized to integrate with the new editor, providing contextual information about how to use the new features.

• Improved: Update Transparency
  The update notification system keeps administrators informed about new versions without disrupting regular players.

• Optimized: Configuration Structure
  The new messages.yml has been reorganized with the editor in mind, making it easier to understand and maintain.

With v0.0.8, CustomDeathMessages is not only more powerful but also more accessible and transparent. The in-game editor represents a major leap forward in administrator experience, while the update notifications keep you informed about future improvements to the plugin. The addition of Minecraft 1.21.9 and 1.21.10 support ensures you can use the latest Minecraft features while enjoying customized death messages.

---

📜 CHANGELOG - CustomDeathMessages v0.0.7

The evolution never stops! Version 0.0.7 takes the solid foundation of v0.0.6 and elevates it with an essential tool for administrators: a built-in configuration validator. This release focuses on error prevention, ease of use, and stability, ensuring your experience with custom death messages is flawless.

⚠️ IMPORTANT UPGRADE NOTE
To fully leverage the new features and ensure compatibility:

1. Make a backup of your current config.yml and messages.yml files.
2. Delete the config.yml and messages.yml files from your server's plugins/CustomDeathMessages/ folder.
3. Restart or reload the server. The plugin will automatically generate new, up-to-date configuration files with all new options, examples, and system messages.
4. You can then manually re-add your custom settings and messages from your backup into the new files.

✨ New Features

• Added: Integrated Configuration Validator (/cdm config validate)
  The flagship feature of this version! This new command allows administrators to validate the correctness of their config.yml and messages.yml files before reloading. It scans for:

  • Invalid sounds and particles (global, per-group, and epic).
  • Syntax errors in conditions (unknown operators, malformed placeholders).
  • Generates a detailed report in the chat with success (✅), error (❌), and warning (⚠️) messages, along with a summary of the current configuration.

• Added: New System Messages for the Validator
  A complete section has been added to messages.yml under system-messages with translatable messages for the validator, such as config-validator-sound-not-found, config-validator-condition-syntax-warning, and config-validator-success-all, enabling a fully localizable user experience.

• Added: New /cdmconfig Command
  A new entry point for the validator. Administrators can run /cdm config validate to start the validation process. Uses the cdm.reload permission.

🐛 Bug Fixes

• Fixed: Enhanced Atomic Reload
  The /cdmreload command has been improved to be even more robust. It now explicitly validates messages.yml before attempting to load config.yml. If messages.yml has a critical syntax error (e.g., malformed YAML), the reload process stops immediately, notifies the user, and prints the full stack trace to the console, preventing any unstable intermediate state.

• Fixed: Error Handling in Reload
  Improved error handling in /cdmreload to capture and report unexpected failures more clearly, ensuring the administrator always receives feedback, even in edge cases.

🛠️ Improvements & Optimizations

• Improved: Administrator Experience
  The validator provides a proactive way to debug configurations, drastically reducing the risk of runtime errors and saving hours of frustration from misplaced brackets or commas.

• Improved: Documentation
  The config.yml and messages.yml files have been updated with comments referencing the new validation functionality, guiding users on how to keep their configurations error-free.

• Optimized: Development Workflow
  The introduction of ConfigValidator sets a pattern for future diagnostic and maintenance tools within the plugin, improving the codebase's long-term structure.

With v0.0.7, CustomDeathMessages is not only more powerful but also safer and easier to manage. The integrated validator is a giant leap towards a perfect user experience for both players and administrators.