# CustomDeaths<\/p>\n
<\/p>\n
Rule-based, funny death messages for Minecraft. Designed for **PaperMC 1.21.x** and **Java 21**. Shows the **original vanilla death message on hover** while broadcasting your customized one.<\/p>\n
—<\/p>\n
\u26a0\ufe0f **Irreversible (Messaging Only):** This plugin *replaces broadcast death messages*. It does not change drops, XP, or inventories, but your chat history cannot be \u201cun-broadcast.\u201d Use with care.<\/p>\n
—<\/p>\n
## \u2705 Supported Platforms & Requirements<\/p>\n
– **Minecraft server:** PaperMC 1.21.x (API 1.21).
\n– Works on Paper-compatible forks that maintain API parity (e.g., Purpur).
\n– **Java runtime:** Java 21 (server + build).<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
– **Custom Death Rules:** Define messages by conditions:
\n – Damage cause, world, biome
\n – Y height (above\/below)
\n – Killer type, name, or whether killer is a player
\n – Victim permissions or held item
\n– **Original on Hover:** Vanilla death message remains available as a hover tooltip.
\n– **Enable\/Disable Quickly:** Toggle via `\/customdeaths toggle` or set `enabled: true|false`.
\n– **Per-Cause & Global Messages:** Simple config lists.
\n– **Presets Included:** Ship with defaults; disable via `use-presets: false`.
\n– **Hot Reload:** `\/customdeaths reload` applies changes without restart.<\/p>\n
—<\/p>\n
## \ud83d\udce6 Commands<\/p>\n
– `\/customdeaths reload` \u2014 Reload `config.yml`.
\n– `\/customdeaths toggle` \u2014 Flip the master `enabled` flag on\/off. <\/p>\n
### Permissions
\n– `customdeaths.admin` \u2014 default: **op**<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration (`plugins\/CustomDeaths\/config.yml`)<\/p>\n
“`yaml
\nenabled: true
\nhover-original: true
\noverride-broadcast: true
\nuse-presets: true<\/p>\n
messages:
\n – “{player} took a permanent nap without setting an alarm.”<\/p>\n
per-cause:
\n VOID:
\n – “{player} fell off the edge of the internet.”<\/p>\n
# Custom rules (first match wins)
\ncustom-deaths:
\n – name: “archer_headshot”
\n when:
\n killer-type: “SKELETON”
\n y-above: 100
\n messages:
\n – “{player} got a high-altitude headshot from {killer}.”<\/p>\n
presets:
\n messages:
\n – “{player} opened the hardcore tutorial.”
\n per-cause:
\n FALL:
\n – “{player} mistook the ground for a trampoline.”
\n“`<\/p>\n
**Supported `when` keys**
\n– `cause` (DamageCause), `world`, `biome`
\n– `y-above`, `y-below`
\n– `killer-type` (EntityType), `killer-name`, `killer-is-player`
\n– `victim-has-permission`, `victim-holding` <\/p>\n
**Placeholders:** `{player}`, `{killer}`, `{cause}`<\/p>\n
—<\/p>\n
## \ud83e\udded How it Works<\/p>\n
1. On `PlayerDeathEvent`, the plugin checks **custom-deaths** rules in order.
\n2. First match wins; if none, it falls back to **per-cause**, then **messages**, then **presets**.
\n3. The chosen line is broadcast, with the vanilla message shown on hover (if enabled). <\/p>\n
—<\/p>\n
## \ud83d\udce5 Installation<\/p>\n
1. Drop the plugin JAR into `plugins\/` on a Paper 1.21.x server.
\n2. Start the server to generate `config.yml`.
\n3. Edit `plugins\/CustomDeaths\/config.yml`.
\n4. Apply changes with `\/customdeaths reload` (or restart). <\/p>\n
—<\/p>\n
## \ud83d\udd12 Safety Notes<\/p>\n
– Only the broadcasted death message is replaced; no inventories, XP, or drops are touched.
\n– Ensure admins understand that **first match wins** in `custom-deaths`. <\/p>\n
—<\/p>\n
## \ud83d\udcc4 License<\/p>\n
MIT \u2014 free to use and contribute. <\/p>\n","protected":false},"excerpt":{"rendered":"
A Plugin thats lets you configure custom death messages random or with a specific death corse<\/p>\n","protected":false},"featured_media":52717,"template":"","meta":{"_minecraft_slug":"custom-death-messages","_minecraft_project_id":"kwr9qL5o","_minecraft_author":"_blackdev_","_minecraft_license":"MIT","_minecraft_downloads":335,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"custom-death-messages.zip","_minecraft_size_bytes":7214,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T11:27:08.792902Z","_minecraft_date_created":"2025-08-24T22:18:21.071840Z","_minecraft_date_modified":"2025-08-24T20:52:09.365789Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/custom-death-messages","_minecraft_icon_attachment_id":52717,"_minecraft_imported_at":"2026-06-02T21:54:31+00:00","_minecraft_import_hash":"ee5a04aaca925c9c27b3385b430e56a1","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,43,89,127,128,867,92],"mod_loader":[132,133],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-52716","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-cursed","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","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"],"yoast_head":"\n