Death Penalty

DeathPenalty
The Ultimate Death Consequence & Economy Sink Plugin
Reward tactical survival, balance your server's economy, and introduce thrilling death penalties with extensive in-game GUI customization, dual-database support (MySQL & SQLite), and modern Paper / Spigot compatibility.

▶ Join our Community Discord Support ◀

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

✦ Key Features

• Dynamic Economy Penalties
  • Configurable money loss: choose between fixed flat amounts or percentage-based penalty.
  • Set a minimum penalty floor to ensure deaths always carry weight.
  • Option to drop money on the ground as physical pickup items with custom names & lore.
• Smart Inventory & EXP Loss
  • Randomly drop or permanently remove configurable item slots and item stacks upon death.
  • Full compatibility with KeepInventory game rules.
  • Native protection for Soulbound or protected gear (immune to drops/deletion).
  • Accurate Minecraft vanilla mathematical leveling calculation for EXP drops and penalties.
• ❤️ Respawn Health, Food & Saturation Control
  • Customizable health and hunger levels when players respawn.
  • Configurable maximum limit clamps for health, food, and saturation.
• ✨ Respawn Potion Effects
  • Grant custom potion effects (e.g. Slowness, Weakness, Blindness, Regeneration) upon respawn.
  • Fully adjustable effect duration and amplifier levels.
• Revenge Monster (Revenant) Spawning
  • Spawn aggressive custom mobs at the death location to guard player drops.
  • Equip mobs with helmets for sunlight resistance and custom entity types.
• High-Performance Dual Database (SQLite & MySQL)
  • High-speed async data handling powered by native HikariCP connection pooling.
  • Built-in 1-Click Database Migrator: effortlessly migrate SQLite to MySQL via /dp migrate or directly from the in-game GUI!
  • Smart memory cache with automatic TTL for zero-lag performance on high-population servers.
• ️ Interactive In-Game GUI & 100% NMS-Free Chat Prompt
  • Manage all settings visually with /dp config.
  • Crash-proof, 100% NMS-free interactive chat input system to enter values seamlessly.
  • Player death status & statistics menu with /dp info.
• ️ WorldGuard 7 & Per-Group / Per-World Customization
  • Full integration with WorldGuard 7 using custom deathpenalty region flags.
  • Per-world configurations and permission group overrides (LuckPerms).
• Multi-Language & Modern Color Formatting
  • Full language files included: English (en_US.yml) and Indonesian (id_ID.yml).
  • Full support for MiniMessage, Hex Colors (&#RRGGBB), and legacy color codes.

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

1. Download the latest DeathPenalty jar.
2. Ensure Dependencies are installed:
   • Vault and a compatible economy plugin (e.g. EssentialsX, EconomyShopGUI).
   • LuckPerms (or any Bukkit-compatible permissions plugin).
   • PlaceholderAPI (Optional, for placeholders).
   • WorldGuard 7.x (Optional, for region flags).
3. Place the .jar into your server's /plugins/ directory.
4. Start or restart your server to generate default configuration files.
5. Configure settings via /dp config or directly in config.yml and messages.yml.

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

✦ Commands & Permissions

• /dp info (Alias: /deathpenalty info)
  ▸ Description: Opens the interactive GUI displaying personal death stats and active penalties.
  ▸ Permission: Granted to all players by default
  
• /dp config (Alias: /deathpenalty config)
  ▸ Description: Opens the admin configuration GUI to modify penalties, limits, potion effects, and mobs visually.
  ▸ Permission: deathpenalty.admin
  
• /dp reload (Alias: /deathpenalty reload)
  ▸ Description: Instantly reloads config.yml, messages.yml, and language files without restarting the server.
  ▸ Permission: deathpenalty.admin
  
• /dp migrate (Alias: /deathpenalty convert)
  ▸ Description: Seamlessly migrates all player statistics, death history, and logs from local SQLite to MySQL database.
  ▸ Permission: deathpenalty.admin

✦ Bypass & Group Permissions

• deathpenalty.bypass.money — Protects players from losing money upon dying.
• deathpenalty.bypass.items — Protects inventory from random slot/stack drops or deletion.
• deathpenalty.bypass.exp — Protects players from losing experience points or levels on death.
• deathpenalty.group.<group> — Assigns custom per-group penalty rules configured in config.yml (e.g. VIP, MVP).

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

✦ PlaceholderAPI Expansions
Identifier: %dp_...% — Fully integrated with Scoreboards, TAB, Chat, and Holograms

• %dp_money_lost_player% ➔ Formatted total money lost by the player (e.g. $250.00)
• %dp_money_lost_raw% ➔ Raw numeric money lost by player (e.g. 250.0)
• %dp_total_death% ➔ Formatted total death count for player (e.g. 12 deaths)
• %dp_total_deaths_raw% ➔ Raw numeric player death count (e.g. 12)
• %dp_total_money_lost% ➔ Server-wide total money lost across all worlds (e.g. $48,500.00)
• %dp_total_money_lost_<world>% ➔ Total money lost within a specific world (e.g. %dp_total_money_lost_world_nether%)
• %dp_top_death% ➔ Top player name with the highest death count on the server
• %dp_top_money_lost% ➔ Top player name who has lost the most money on the server

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

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

• Equip spawned revenge monster with death player's equipment.
• Increased drop money/percentage if killed by another player (PvP bounty).
• World-specific death penalty multipliers and custom curves.
• Discord webhook integration for death penalty notifications.

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

Requirements & Compatibility:
✔ Spigot / Paper / Purpur 1.16.5 – 1.21+ (including PaperMC 26.2)
✔ Java 17, Java 21, and Java 25

Need assistance or have suggestions?
Visit our Discord Server or post on the Discussion tab.
Please do not use the reviews section to report bugs or request features.

This plugin utilizes bStats to collect anonymous server statistics.