DeathPenaltyID

# 💀 DeathPenalty Advanced Death Management & Economy Penalty Engine    **DeathPenalty** is a modular, high-performance death management and economy penalty plugin engineered specifically for modern Minecraft survival, RPG, SMP, and large-scale network servers. The **Community (Free) Edition** is fully functional, completely free of charge, and built with **zero intrusive paywalls, no artificial limits, and zero advertisements**. --- ## ⚡ Why Choose DeathPenalty? * 🚀 **100% Native Folia & Leaf Multi-Threading** Engineered from day one for modern tick architectures. All scheduled tickers, bed sleep checks, and entities run safely across `RegionScheduler`, `EntityScheduler`, and `GlobalRegionScheduler`. No thread-stalling, desynchronization, or tick lag on multi-threaded servers. * 🌐 **Dynamic Per-Player Multi-Language (10 Languages)** Every player can choose their own language in real-time via `/dp info`. Out of the box: * 🇺🇸 English (`en_US`) * 🇮🇩 Bahasa Indonesia (`id_ID`) * 🇨🇳 简体中文 (`zh_CN`) * 🇯🇵 日本語 (`ja_JP`) * 🇪🇸 Español (`es_ES`) * 🇮🇹 Italiano (`it_IT`) * 🇸🇦 العربية (`ar_SA`) * 🇩🇪 Deutsch (`de_DE`) * 🇫🇷 Français (`fr_FR`) * 🇷🇺 Русский (`ru_RU`) * 💰 **Vault Economy Penalties & Physical Cash Drops** Deduct a flat fee or percentage of a player's Vault balance on death. Drop physical money items on the ground with custom heads/models for scavengers. * 📊 **Precise EXP Level Drops** Exact vanilla Minecraft EXP level math. Fully compatible with both `keepInventory: true` and `keepInventory: false` environments. * 🍎 **Attribute Debuffs (Health, Food & Saturation)** Temporarily penalize respawning players with reduced maximum health, food, and saturation with auto-restoration timers and configurable safety limit caps. * 🎒 **Random Inventory Item Drops & Soulbound Protection** Configure percentage chances to drop inventory items even when KeepInventory is active. Gear marked with Soulbound lore is strictly protected from dropping. * 👻 **Revenant Guardian Mob Spawns** Summon a corrupted hostile mob (ghost/revenant) at the death coordinates to guard the player's gravestone. * 🗄️ **Dual Database Architecture (SQLite & HikariCP MySQL)** Includes a built-in one-click database converter (`/dp convert` or via GUI) to seamlessly migrate data from SQLite to MySQL without data loss. * 🧰 **In-Game GUI Config & Native Chat Input** Configure all plugin settings inside `/dp config`. Edit values using native chat prompts—completely 100% NMS-free and immune to Minecraft version updates! * 🛡️ **WorldGuard 7 & PlaceholderAPI Integration** Custom region flag (`death-penalty: deny`) to disable penalties in safe zones, plus dozens of PAPI placeholders for scoreboards and menus. --- ## 💎 Free vs. Premium (Pro Edition) Looking for advanced survival and RPG mechanics? Here is a breakdown of the **Community (Free)** edition versus the upcoming **Premium (Pro)** edition: | Feature / System | 🆓 Free (Community) | 💎 Premium (Pro) | | :--- | :---: | :---: | | **Vault Economy Penalties (Flat & %)** | ✅ | ✅ | | **Physical Cash Drops & 3D Item Scavenging** | ✅ | ✅ | | **EXP Level Drops (KeepInventory Support)** | ✅ | ✅ | | **Health, Food & Saturation Debuffs** | ✅ | ✅ | | **Random Item Drops & Soulbound Protection** | ✅ | ✅ | | **Revenant Mob Spawning on Death** | ✅ | ✅ | | **Per-Player Multi-Language (10 Languages)** | ✅ | ✅ | | **Interactive GUI & Native Chat Prompt Config** | ✅ | ✅ | | **SQLite & MySQL (HikariCP) + In-Game Converter** | ✅ | ✅ | | **WorldGuard 7 Flag & PlaceholderAPI** | ✅ | ✅ | | 🧭 **Death Location Recovery (`/dp back` & Lodestone Compass)** | ❌ | ✅ | | 🛡️ **Death Insurance System (Policy Queue & Coverage)** | ❌ | ✅ | | ☠️ **Cause-Specific Death Curses (15+ Death Causes)** | ❌ | ✅ | | 💠 **Soul Stability (Progressive Instability & Multipliers)** | ❌ | ✅ | | ⛪ **Interactive Cleric NPCs (Curse Cleanse & Soul Trading)** | ❌ | ✅ | --- ## ⌨️ Commands & Permissions ### Player Commands | Command | Permission | Description | | :--- | :--- | :--- | | `/dp info` | *(None)* | View your death status, active debuffs, and cycle language. | | `/dp deaths` | `deathpenalty.deaths` | Open your personal death history GUI. | ### Admin Commands | Command | Permission | Description | | :--- | :--- | :--- | | `/dp config` | `deathpenalty.admin` | Open the interactive in-game configuration menu. | | `/dp reload` | `deathpenalty.admin` | Reload config files and database connections. | | `/dp convert` | `deathpenalty.admin` | Migrate player data from SQLite to MySQL. | --- ## 🧩 Compatibility & Requirements * **Minecraft Versions:** `1.20.x` – `26.2.x` * **Server Software:** Paper, Purpur, Leaf, or Folia *(Spigot supported)* * **Java Version:** Java 21 or Java 25+ * **Dependencies:** * [Vault](https://www.spigotmc.org/resources/vault.34315/) + Economy plugin (EssentialsX, etc.) *(Recommended)* * [PlaceholderAPI](https://hangar.papermc.io/HelpChat/PlaceholderAPI) *(Optional)* * [WorldGuard 7](https://enginehub.org/worldguard/) *(Optional)* --- ## 🚀 Installation 1. Download the **`DeathPenalty-1.9.1.jar`** file. 2. Drop it into your server's `plugins/` directory. 3. Restart your server to generate configuration files and localization packs in `plugins/DeathPenalty/`. 4. Run `/dp config` in-game as an Operator to customize your settings!