dDeathPenalty | Money • XP • Items • WorldGuard • Per-Group Penalties

DeathPenalty punishes players on death — money lost, levels stripped, items destroyed, and monsters spawned — all from a single config file. Every penalty is tunable per-world and per-permission group, so a VIP player or a dangerous dimension can have completely different rules. No GUI needed, no database, no fluff — just a clean punishment model that makes every death count on your server.

• Money Penalties — Take a percentage of the player's balance or a flat amount via Vault. Set a minimum floor, a maximum cap, and a separate PvP multiplier for kills by other players.
• Money-First Fallback — Optionally make XP loss trigger only when a player has no money left to take. Money becomes the penalty; only broke players lose XP instead. One config flag, fully opt-in, works alongside any XP mode below.
• ⭐ XP / Level Loss — Keep all XP, wipe it entirely, remove a specific number of levels, or let vanilla handle it. Fully configurable per profile.
• Item Penalties — Five item modes: vanilla drops, keep all, clear all, randomly drop N stacks, or silently destroy N random stacks.
• ❤️ Respawn Penalties — Force a custom health amount, food level, and arbitrary potion effects on the player when they respawn.
• Spawn Monster on Death — Spawn any mob type at the death location. Optionally equip it with the victim's armor and held item.
• Run Commands on Death — Execute any console command with %player%, %world%, and %money_lost% placeholders.
• Per-World Config — Override any penalty setting for a specific world. Only list the keys you want to change.
• Per-Group Penalties — Assign players to groups via deathpenalty.group.<name> permission and give each group its own penalty profile.
• WorldGuard Region Support — Add the death-penalty deny flag to any region to silently disable all penalties inside it.
• PlaceholderAPI Leaderboards — Built-in %dp_*% expansion with per-player stats and server-wide top-N leaderboards by deaths and money lost.
• ️ Exempt & Ignore Permissions — Give a player deathpenalty.exempt to protect their inventory on death, or deathpenalty.ignore to disable the plugin for them entirely. Both support per-world variants.
• Automatic Stats Persistence — Death counts and money lost are cached in memory and flushed asynchronously to stats.yml on a configurable interval.

Aliases: /dp

• /deathpenalty reload — Reload config and messages (op)
• /deathpenalty check [player] — View death stats for yourself or another player (op)

• deathpenalty.admin — Grants reload + check (default: op)
• deathpenalty.reload — Reload the configuration (default: op)
• deathpenalty.check — View death stats (default: op)
• deathpenalty.exempt — Keep inventory on death, no penalty (default: false)
• deathpenalty.exempt.<world> — Same as above, specific world only (default: false)
• deathpenalty.ignore — Plugin completely disabled for this player (default: false)
• deathpenalty.ignore.<world> — Same as above, specific world only (default: false)
• deathpenalty.group.<name> — Assign player to a config group (default: false)

Install PlaceholderAPI alongside DeathPenalty to unlock the %dp_*% expansion.

• %dp_total_death% — Player's death count
• %dp_money_lost_player% — Player's total money lost
• %dp_total_money_lost_<world>% — Server-wide money lost in a specific world
• %dp_top_death_<rank>% — Name of the rank-N player by deaths
• %dp_top_death_amount_<rank>% — Death count at rank N
• %dp_top_money_lost_<rank>% — Name of rank-N player by money lost
• %dp_top_money_lost_amount_<rank>% — Money lost at rank N

• Paper 1.21.1+
• Vault + any economy plugin (EssentialsX recommended) — optional, required for money penalties
• PlaceholderAPI — optional, for %dp_*% placeholders
• WorldGuard 7 — optional, for per-region death-penalty flag
• Java 21+

If you like this plugin, feel free to review and share it with your friends! I appreciate all kinds of support. Thank you!
If you find any bugs or errors, please send me a private message before leaving a review. I'll do my best to fix it fast!