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

# Language (zh_CN / en_US)
language: zh_CN

# Pricing mode: dynamic / fixed
pricing-mode: dynamic

Dynamic Pricing Parameters

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

  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

  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

fixed-pricing:
  price: 500.0   # Fixed price per redemption

Other Settings

# 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 redeeming? A: Check whether Vault and a valid economy plugin are installed. If all items are free (price 0), the free redemption will not deduct any currency.

Q: How do I change the currency name? A: Modify economy.currency-name in config.yml, then run /redeemadmin reload.

Q: Want to add/remove an item for pricing?

valuable-items:
  - +dragon_egg      # Add dragon egg for pricing
  - -golden_sword    # Golden sword no longer priced (free)

---

---

---

DeathRedeem — 死亡装备赎回插件

作者： YuHongChen(LiquidTeam)
版本： 1.0.0
适用服务端： Paper 1.21+（兼容 1.20 - 1.21）

---

功能介绍

玩家死亡后，掉落的物品不会消失或掉落在地上，而是被插件保存。玩家可以通过命令或 GUI 花费游戏币赎回自己的物品。

• ✅ 死亡不掉落（物品存入赎回系统）
• ✅ 支持跨维度赎回
• ✅ 动态定价 / 固定定价双模式
• ✅ 仅武器、装备、珍贵矿物参与计价，杂物免费
• ✅ Vault 经济插件集成
• ✅ 中英文双语（可切换）
• ✅ GUI 图形界面（分页查看物品详情）
• ✅ 可配置过期时间、最大记录数
• ✅ 热重载
• ✅ LuckPerms 权限节点支持

---

安装

1. 将 DeathRedeem-1.0.0.jar 放入服务器 plugins/ 文件夹
2. 确保已安装 Vault 和一个经济插件（如 EssentialsX、SimpleEconomy、CmiEconomy 等）
3. 重启服务器或 /plugman load DeathRedeem

---

命令

命令	说明	权限
/redeem list	查看你的死亡记录列表	deathredeem.use
/redeem redeem <id>	赎回指定 ID 的记录	deathredeem.use
/redeem gui	打开赎回 GUI 界面	deathredeem.use
/redeemadmin reload	热重载配置文件	deathredeem.command.redeemadmin
/dr	/redeem 的别名	—
/dra	/redeemadmin 的别名	—

---

权限节点

权限节点	默认	说明
deathredeem.use	✅ 所有人	使用赎回功能
deathredeem.command.redeem	✅ 所有人	允许执行 /redeem
deathredeem.command.redeemadmin	🔒 OP	允许执行 /redeemadmin reload
deathredeem.admin	🔒 OP	管理员权限（同上）
deathredeem.*	❌ 手动赋予	以上所有权限

在 LuckPerms 中给管理员：/lp group admin permission set deathredeem.* true

---

配置文件 — config.yml

基本设置

# 语言（zh_CN / en_US）
language: zh_CN

# 定价模式：dynamic（动态） / fixed（固定）
pricing-mode: dynamic

动态定价参数

dynamic-pricing:
  # 基础单价
  base-price: 100.0

  # 附魔每级加价百分比（0 = 关闭）
  enchantment-price-per-level: 30.0

  # 下界合金装备额外加价百分比
  netherite-bonus-percent: 50.0

  # 批量折扣：当贵重物品超过 N 件时打折
  bulk-discount-threshold: 10
  bulk-discount-percent: 10.0

  # 最低 / 最高价格（-1 为不限制）
  min-price: 1.0
  max-price: -1.0

自定义物品倍率

  item-multipliers:
    diamond: 5.0
    netherite_ingot: 10.0
    netherite_sword: 8.0
    # 附魔金苹果 12 倍（默认）
    # 实际价格 = 基础价 × 倍率 × 数量 + 附魔费 + 下界合金加成

贵重物品列表

  valuable-items:
    # 留空则使用内置默认列表
    # "+物品ID" 在默认列表基础上添加
    # "-物品ID" 从默认列表移除
    # 例如添加龙蛋、移除金剑：
    # - +dragon_egg
    # - -golden_sword

默认计入计价的物品：

• 盔甲：铁/金/钻/下界合金的头盔、胸甲、护腿、靴子
• 武器工具：铁/金/钻/下界合金的剑、斧、镐、锹、锄、矛
• 矿物：钻石、绿宝石、下界合金锭/碎片/块、金锭/铁锭/铜锭、金块/铁块
• 特殊：附魔金苹果、鞘翅、三叉戟、不死图腾、潜影盒、下界之星、重锤、沉重核心、龙蛋、龙头
• 附魔物品（仅限武器/工具/盔甲）

不计价的杂物（免费赎回）： 圆石、泥土、沙子、木头、石头、食物、药水、箭、花、告示牌等所有其他物品

固定定价

fixed-pricing:
  price: 500.0   # 每次赎回固定价格

其他设置

# 赎回有效期（小时，-1 = 永不过期）
redeem-time-limit-hours: 24

# 每人最多保留多少条死亡记录
max-death-records: 10

# 经济
economy:
  enabled: true
  currency-name: 金币       # 货币名称（可自定义）

# GUI
gui:
  title: "&8&l✞ 死亡物品赎回"
  rows: 4

---

热重载

修改配置后执行：

/redeemadmin reload

无需重启服务器。

---

数据文件

死亡记录保存在 plugins/DeathRedeem/data/ 文件夹下，每一条记录一个 .yml 文件。
文件名格式：<玩家UUID>_<记录ID>.yml

---

常见问题

Q: 为什么我死了物品还是掉地上了？
A: 这是正常现象。插件会立即清除掉落物并存入系统，所以地上即使闪一下也是正常的。如果物品依然留在地上说明插件未生效。

Q: 赎回时提示"交易失败"？
A: 检查是否安装了 Vault 和有效的经济插件。如果所有物品都是杂物（价格为 0），则免费赎回不会扣款。

Q: 怎么改货币名称？
A: 修改 config.yml 中的 economy.currency-name，然后 /redeemadmin reload。

Q: 想添加/移除某种物品参与计价？

valuable-items:
  - +dragon_egg      # 添加龙蛋参与计价
  - -golden_sword    # 金剑不再计价（免费）