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

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

Make death mean something, configure exactly what players lose.



[​IMG]
DeathPenalty

Make death mean something — configure exactly what players lose.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✦ What is DeathPenalty?
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.
[​IMG]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✦ Features
  • 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.
  • ⭐ 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.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✦ Commands
Aliases: /dp

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

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✦ Permissions
  • 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)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✦ PlaceholderAPI
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

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

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

✦ Setup Guide

Drop DzusillCore.jar and DeathPenalty.jar into your server's plugins/ folder. If you want money penalties, also add Vault and an economy plugin (EssentialsX works great). Start the server once to generate config files.

Edit plugins/DeathPenalty/config.yml. The default: section applies to everyone. Use worlds: and groups: to override specific keys for specific worlds or permission groups.
Code (Text):

default:
  money:
    mode: PERCENT   # take 10% of balance on death
    amount: 10.0
    pvp-multiplier: 1.5  # 15% if killed by another player

worlds:
  world_nether:
    money:
      amount: 25.0  # Nether is more dangerous — lose more

groups:
  vip:             # requires permission: deathpenalty.group.vip
    money:
      amount: 5.0  # VIPs only lose 5%
 

Use LuckPerms (or any permission plugin) to assign group permissions:
Code (Text):

/lp group vip permission set deathpenalty.group.vip true
/lp user Steve permission set deathpenalty.exempt.world_nether true
 

To disable penalties in a specific region, set the custom flag after selecting the region:
Code (Text):

/rg flag <region> death-penalty deny
 

Code (Text):

/deathpenalty reload
/deathpenalty check <yourname>
 
Die in-game and confirm the configured penalties are applied. Check plugins/DeathPenalty/stats.yml after the flush interval to verify persistence.

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!
Resource Information
Author:
----------
Total Downloads: 1
First Release: Today at 5:44 PM
Last Update: Today at 5:44 PM
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings