# \ud83d\udcda Custom Death Messages – Official Documentation (v1.1)<\/p>\n
> **Turn every death into a cinematic moment\u2026 or an EPIC apocalypse. Now with a unified command system, simplified permissions, and **fine-grained broadcast control** for every effect.**<\/p>\n
`CustomDeathMessages` is a Spigot\/Paper plugin for Minecraft servers that **replaces boring, default death messages** with **custom, dynamic, colorful messages**, complete with optional **sound effects, particle explosions, screen titles, action bars, economic costs, and even a “darken screen” effect**. Version **1.1** is a **major feature release** that builds on the stable foundation of v1.0 by introducing a **powerful new broadcast system**, **dedicated testing commands**, **full support for Minecraft 1.21.11**, and the **complete removal of the in-game editor** to prioritize core stability and performance. This release focuses on **precision, control, and reliability**, giving server administrators unprecedented control over who experiences each death effect.<\/p>\n
> **\u26a0\ufe0f UPGRADE INSTRUCTIONS**
\n> Your existing configuration files are fully compatible. However, please note these important changes:
\n> 1. **Editor Removal:** The in-game configuration editor (`\/cdm editor`) has been **completely removed** from the plugin. All configuration must now be done manually by editing the `config.yml` and `messages.yml` files.
\n> 2. **New Broadcast System:** The plugin now offers four modes for controlling who sees death effects. Your old `message-to-*` settings are respected, but you can now use the new, more powerful `effects-broadcast` section in `config.yml`.
\n> 3. **New Commands:** A powerful new `\/cdm broadcast` command suite has been added for testing and triggering effects.
\n> 4. **Minecraft 1.21.11 Support:** The plugin has been updated and tested for the latest Minecraft version.
\n> 5. **Internal Architecture:** The plugin’s core has been completely refactored for better reliability and future development. You, as a user, won’t see any difference in basic functionality, but it’s more stable and maintainable.<\/p>\n
—<\/p>\n
## \ud83e\udde9 Features<\/p>\n
* **Death Cause Messages:** Unique messages for `FALL`, `FIRE`, `ENTITY_ATTACK`, `DROWNING`, `VOID`, and more. —<\/p>\n ## \u2699\ufe0f Configuration<\/p>\n *(Configuration details for `config.yml` and `messages.yml` remain as previously described in your last documentation, with the `messages.yml` file now on **version 1.1** and containing the new `broadcast-system` section.)*<\/p>\n —<\/p>\n ## \ud83c\udfae Commands<\/p>\n | Command | Description | Permission | > **All commands now use the unified `\/cdm` prefix** – This provides a consistent, streamlined interface that’s easier to remember and use.<\/p>\n —<\/p>\n ## \ud83d\udd10 Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ## \ud83e\uddea Placeholders<\/p>\n *The placeholder list remains the same as v1.0, offering deep contextual information for your messages.*<\/p>\n —<\/p>\n ## \u2753 FAQ<\/p>\n **Q: How do I control who sees my death effects now?** **Q: What’s the difference between the old `message-to-*` and the new broadcast system?** **Q: How can I test the new broadcast modes?** **Q: Is this plugin compatible with Minecraft 1.21.11?** **Q: Do I need to reconfigure everything for v1.1?** **Q: What happened to the in-game editor?** *The rest of the FAQ from v1.0 remains valid and unchanged.*<\/p>\n —<\/p>\n ## \ud83d\udee0\ufe0f Dependencies<\/p>\n * **Required:** Spigot or Paper **1.17+**. ## \ud83d\udca1 Pro Tips<\/p>\n * **The #1 Pro Tip for v1.1:** Use `\/cdm broadcast test` to perfectly calibrate your `RADIUS` settings before going live. Die with style, not silence! Replace boring death notices with hilarious, colorful, and personalized messages. Add sounds, particles, and titles to turn every demise into a memorable event.<\/p>\n","protected":false},"featured_media":53052,"template":"","meta":{"_minecraft_slug":"customdeathmessages","_minecraft_project_id":"LrqgmmvZ","_minecraft_author":"SicklySurgeon","_minecraft_license":"MIT","_minecraft_downloads":1542,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"customdeathmessages.zip","_minecraft_size_bytes":768235,"_minecraft_version_count":11,"_minecraft_updated_at":"2026-05-16T07:09:42.430644Z","_minecraft_date_created":"2025-09-11T21:13:38.812308Z","_minecraft_date_modified":"2026-04-03T05:33:57.880031Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/customdeathmessages","_minecraft_icon_attachment_id":53052,"_minecraft_imported_at":"2026-06-02T22:41:23+00:00","_minecraft_import_hash":"edc59a9c73e3a687d4e9aa9d14d4b910","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,127,128,867,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,860,861,862,863,864,83,167],"class_list":["post-53051","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-26-1","minecraft_version-26-1-1"],"yoast_head":"\n
\n* **Permission-Based Groups:** VIPs, Admins, or default players get tailored messages and sounds.
\n* **Per-World Overrides:** Define special messages for `world_nether`, `world_the_end`, or any custom world.
\n* **Visual Effects:**
\n * Particle explosions (`EXPLOSION`, `FLAME`, etc.)
\n * Screen Titles & Subtitles (`&cYOU DIED`)
\n * Action Bar messages (`&c{victim} died!`)
\n * “Darken Screen” effect using ambient particles (e.g., `CLOUD`, `SMOKE`)
\n* **Custom Sounds:** Global or per-group death sounds with adjustable volume and pitch.
\n* **Advanced Placeholders:**
\n * `{victim}` \u2014 Player who died.
\n * `{killer_name}` \u2014 The **entity RESPONSIBLE** for the kill (e.g., the Skeleton who shot the arrow).
\n * `{killer_source}` \u2014 The **DIRECT source** of the damage (e.g., “Arrow”, “Lava”, “Fireball”).
\n * `{killer_displayname}` \u2014 Killer’s display name (supports colors\/nicks from plugins like EssentialsX or LuckPerms).
\n * `{cause}` \u2014 Technical death cause (e.g., `FALL`, `ENTITY_ATTACK`).
\n * `{world}` \u2014 World name.
\n * `{biome}` \u2014 Biome name (e.g., “Plains”, “Nether Wastes”, “Deep Dark”).
\n * `{x}`, `{y}`, `{z}` \u2014 Death coordinates.
\n * `{time}` \u2014 Server time (format from `config.yml`).
\n * `{distance}` \u2014 Distance (blocks) between victim and killer, with one decimal (e.g., “5.2”).
\n * `{victim_weapon}` \u2014 Name of the weapon in the victim’s main hand.
\n * `{victim_effects}` \u2014 List of active potion effects on the victim.
\n* **PlaceholderAPI Support:** Expand functionality with external placeholders.
\n* **Respawn Message:** Welcome players back with a custom message on respawn.
\n* **Live Reload:** Use `\/cdm reload` to apply config changes without restarting. **Features atomic reload: if the new config fails, it reverts to the old one.**
\n* **Test Command:** Use `\/cdm test
\n* **Bypass Permission:** Players with `cdm.bypass` won’t trigger death messages (ideal for staff).
\n* **Message Cooldown System:** Prevents the same random message from being shown to a player consecutively.
\n* **Epic Death System:** A configurable chance for a death to be **EPIC**, featuring unique messages, sounds, particles, titles, and a **lightning strike**.
\n* **Vault Economy Integration:** Charge players for displaying death messages. Exempt groups (like admins) from paying.
\n* **In-Game Help (`\/cdm help`):** A multi-page, fully configurable help system accessible directly in-game. Dynamically generated and permission-controlled.
\n* **Conditional Messages:** Show different messages based on complex conditions using `AND`, `OR`, `equals`, `startsWith`, `endsWith`, `>`, `<`, `>=`, `<=`.\n* **Legacy Color Support:** Automatically strips modern hex color codes for compatibility with servers running Minecraft versions older than 1.16.\n* **Atomic Configuration Reload:** The `\/cdm reload` command now validates the entire new configuration before applying it. If any part fails, the plugin safely reverts to the previous state, preventing server crashes.\n* **Automatic Update Notifications** \u2014 The plugin checks for new versions on startup and notifies admins when they join the server with a direct link to download the update.\n* **Minecraft 1.21.11 Support** \u2014 **NEW in v1.1!** Fully compatible and tested with the latest Minecraft version, including all new sounds, particles, and biome names.\n* **Advanced Broadcast System** \u2014 **NEW in v1.1!** Take total control over who experiences each death effect with four broadcast modes:\n * `GLOBAL`: All online players on the server.\n * `WORLD`: All players in the same world as the victim.\n * `RADIUS`: Only players within a configurable distance.\n * `VICTIM_ONLY`: Only the dying player sees\/hears the effect.\n* **Powerful `\/cdm broadcast` Command Suite** \u2014 **NEW in v1.1!** Test and trigger any broadcast effect manually:\n * `\/cdm broadcast sound
\n * `\/cdm broadcast particle
\n * `\/cdm broadcast message
\n * `\/cdm broadcast test` \u2013 Simulates all broadcast modes.
\n * `\/cdm broadcast global
\n|———|————-|————|
\n| `\/cdm` | Shows the main menu of available commands | `cdm.use` |
\n| `\/cdm test
\n| `\/cdm broadcast …` | **NEW!** Test and trigger broadcast effects manually | `cdm.broadcast` |
\n| `\/cdm help [command]` | Shows comprehensive help documentation in-game | `cdm.use` |
\n| `\/cdm config validate` | Validates configuration files for errors | `cdm.reload` |
\n| `\/cdm reload` | Reloads configuration with atomic reload | `cdm.reload` |<\/p>\n
\n|————|————-|———|
\n| `cdm.use` | Base permission for accessing the main `\/cdm` command | `true` |
\n| `cdm.reload` | Allows reloading config and using `\/cdm config validate` | `op` |
\n| `cdm.test` | Allows testing messages | `op` |
\n| **`cdm.broadcast`** | **NEW!** Allows access to the broadcast testing suite | `op` |
\n| `cdm.bypass` | Player won’t receive death messages | `false` |
\n| `cdm.message.vip` | Assigns player to “vip” group | `false` |
\n| `cdm.message.admin` | Assigns player to “admin” group | `false` |
\n| `cdm.admin` | Grants access to update checker notifications | `op` |<\/p>\n
\n> A: Use the new `effects-broadcast` section in `config.yml`. You can set a `default-mode` for all effects or override it for specific ones like `sound-mode` or `title-mode`.<\/p>\n
\n> A: The old system only controlled the death *message*. The new broadcast system gives you fine-grained control over **every** effect: messages, sounds, particles, titles, and the darken screen.<\/p>\n
\n> A: Use the new `\/cdm broadcast test` command to see how many players each mode would reach, or use `\/cdm broadcast sound WORLD` to play a sound to your entire world.<\/p>\n
\n> A: **Yes!** Version 1.1 has been fully built, tested, and verified to work with Minecraft 1.21.11.<\/p>\n
\n> A: **No!** Your existing `config.yml` and `messages.yml` files will work perfectly. The new broadcast settings have sensible defaults that mimic the old behavior, so your server will function exactly as before. You can then choose to adopt the new features at your own pace.<\/p>\n
\n> A: The in-game configuration editor (`\/cdm editor`) has been **completely removed** in v1.1. All configuration must now be done by manually editing the `config.yml` and `messages.yml` files in your server’s `plugins\/CustomDeathMessages\/` folder.<\/p>\n
\n* **Built Against:** **Spigot API 1.21.11**.
\n* **Optional (Soft-depend):**
\n * PlaceholderAPI for extended placeholder support.
\n * Vault for economy integration.<\/p>\n
\n* Set your `title-mode` and `actionbar-mode` to `VICTIM_ONLY` for a personal, immersive experience.
\n* Use `GLOBAL` mode for sounds and particles on epic deaths to make them a true server-wide event.
\n* Combine the new broadcast system with the existing conditional messages to create deeply immersive, context-aware death events that feel alive.
\n* Remember: **There is no longer an in-game editor.** Embrace the power and precision of direct file editing!<\/p>\n","protected":false},"excerpt":{"rendered":"