Home

CustomDeathMessages

Custom, cinematic death messages for Spigot, Paper and Purpur servers running Minecraft 1.21 – 26.3 with Java 21+.

Modrinth · Source code · Issues

Features

Feature	What it does
Per-cause messages	Different text for falling, fire, PvP, projectiles, drowning and every Bukkit damage cause
Groups	Built-in default, vip and admin groups selected by permission
Per-world overrides	A world can use its own message
Hex colors	&#RRGGBB and <#RRGGBB>
Effects	Sounds, particles, titles, action bars and a darken-screen effect
Broadcast modes	GLOBAL, WORLD, RADIUS and VICTIM_ONLY, configured per effect
Epic deaths	Configurable chance with a special message, sound, particles and lightning
Conditional messages	Show a message only when a condition matches (distance, biome, potion effects...)
Placeholders	Victim, killer, weapon, biome, distance, coordinates, time and more
Integrations	PlaceholderAPI, Vault and Essentials, all optional
Preview	/cdm test <cause> shows the result without dying

Quick start

1. Install Java 21 or newer.
2. Stop the server and put customdeathmessages-1.6.1.jar in plugins/.
3. Start the server.
4. Edit plugins/CustomDeathMessages/config.yml and messages.yml.
5. Apply changes with /cdm reload.

Full details: Installation.

Compatibility

Item	Support
Minecraft	1.21 – 26.3
Java	21+
Servers	Spigot, Paper, Purpur
Optional	PlaceholderAPI, Vault (+ economy plugin), Essentials

Minecraft 1.20.x and older are not supported by 1.6.1. The plugin declares api-version: 1.21, so older servers reject it at startup. A separate legacy build for 1.16.5–1.20.x is planned.

Documentation

• Installation — requirements, install, updates, optional plugins
• Commands & Permissions — every command and permission node
• Configuration — config.yml reference
• Messages & Groups — messages.yml, groups, conditions
• Placeholders — built-in placeholders and PlaceholderAPI
• Building from Source — Maven build
• FAQ & Troubleshooting — common problems

License

MIT © 2026 SicklySurgeon.