DeathRedeem

# DeathRedeem — Death Item Redemption Plugin **Author:** YuHongChen(LiquidTeam) **Version:** 1.0.0 **Supported Server:** Paper 1.21+ (compatible with 1.20 - 1.21) --- ## Features When a player dies, the dropped items do not disappear or scatter on the ground — instead they are saved by the plugin. Players can redeem their items via commands or a GUI by spending in-game currency. - ✅ No drop on death (items stored in the redemption system) - ✅ Cross-dimension redemption support - ✅ Dynamic pricing / fixed pricing dual modes - ✅ Only weapons, armor, and valuable minerals are priced; miscellaneous items are free - ✅ Vault economy plugin integration - ✅ Bilingual (Chinese/English, switchable) - ✅ GUI interface (paged item details) - ✅ Configurable expiration time and max record count - ✅ Hot reload - ✅ LuckPerms permission node support --- ## Installation 1. Place `DeathRedeem-1.0.0.jar` into the server's `plugins/` folder 2. Make sure **Vault** and an economy plugin are installed (e.g. EssentialsX, SimpleEconomy, CmiEconomy, etc.) 3. Restart the server, or use `/plugman load DeathRedeem` --- ## Commands | Command | Description | Permission | |------|------|------| | `/redeem list` | View your list of death records | `deathredeem.use` | | `/redeem redeem <id>` | Redeem the record with the specified ID | `deathredeem.use` | | `/redeem gui` | Open the redemption GUI | `deathredeem.use` | | `/redeemadmin reload` | Hot-reload the configuration file | `deathredeem.command.redeemadmin` | | `/dr` | Alias for `/redeem` | — | | `/dra` | Alias for `/redeemadmin` | — | --- ## Permission Nodes | Permission Node | Default | Description | |----------|------|------| | `deathredeem.use` | ✅ Everyone | Use the redemption feature | | `deathredeem.command.redeem` | ✅ Everyone | Allows executing `/redeem` | | `deathredeem.command.redeemadmin` | 🔒 OP | Allows executing `/redeemadmin reload` | | `deathredeem.admin` | 🔒 OP | Admin permission (same as above) | | `deathredeem.*` | ❌ Manual grant | All of the above permissions | > Grant admins in LuckPerms: `/lp group admin permission set deathredeem.* true` --- ## Configuration — config.yml ### Basic Settings ```yaml # Language (zh_CN / en_US) language: zh_CN # Pricing mode: dynamic / fixed pricing-mode: dynamic ``` ### Dynamic Pricing Parameters ```yaml dynamic-pricing: # Base unit price base-price: 100.0 # Price increase percentage per enchantment level (0 = disabled) enchantment-price-per-level: 30.0 # Extra price percentage for netherite equipment netherite-bonus-percent: 50.0 # Bulk discount: applied when valuable items exceed N pieces bulk-discount-threshold: 10 bulk-discount-percent: 10.0 # Minimum / maximum price (-1 = no limit) min-price: 1.0 max-price: -1.0 ``` ### Custom Item Multipliers ```yaml item-multipliers: diamond: 5.0 netherite_ingot: 10.0 netherite_sword: 8.0 # Enchanted golden apple 12x (default) # Actual price = base price × multiplier × quantity + enchantment fee + netherite bonus ``` ### Valuable Items List ```yaml valuable-items: # Leave empty to use the built-in default list # "+item-ID" adds to the default list # "-item-ID" removes from the default list # E.g. add dragon egg, remove golden sword: # - +dragon_egg # - -golden_sword ``` **Items priced by default:** - Armor: iron/gold/diamond/netherite helmets, chestplates, leggings, boots - Weapons & tools: iron/gold/diamond/netherite swords, axes, pickaxes, shovels, hoes, tridents - Minerals: diamonds, emeralds, netherite ingots/scraps/blocks, gold/iron/copper ingots, gold/iron blocks - Special: enchanted golden apples, elytra, tridents, totems of undying, shulker boxes, nether stars, maces, heavy cores, dragon eggs, dragon heads - Enchanted items (weapons/tools/armor only) **Free items (not priced):** Cobblestone, dirt, sand, wood, stone, food, potions, arrows, flowers, signs, and all other items ### Fixed Pricing ```yaml fixed-pricing: price: 500.0 # Fixed price per redemption ``` ### Other Settings ```yaml # Redemption validity period (hours, -1 = never expires) redeem-time-limit-hours: 24 # Max death records kept per player max-death-records: 10 # Economy economy: enabled: true currency-name: Coins # Currency name (customizable) # GUI gui: title: "&8&l✞ Death Item Redemption" rows: 4 ``` --- ## Hot Reload After modifying the configuration, run: ``` /redeemadmin reload ``` No server restart is required. --- ## Data Files Death records are stored in the `plugins/DeathRedeem/data/` folder, one `.yml` file per record. File name format: `<playerUUID>_<recordID>.yml` --- ## FAQ **Q: Why did my items still drop on the ground when I died?** A: This is normal. The plugin **immediately removes the drops and stores them** in the system, so a brief flash on the ground is expected. If items remain on the ground, the plugin is not active. **Q: I get a "Transaction Failed" error when redeem