?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
DeathRedeem

DeathRedeem

After a player dies, dropped items do not despawn or fall to the ground; instead, they are saved by the plugin. Players can then redeem their items using commands or a GUI, spending in-game currency.

3downloads
0followers
3downloads
0followers

Compatibility

Minecraft: Java Edition

1.21.x
1.20.x

Platforms

Tags

Creators

Details

Licensed MIT
Published 3 days ago
Updated 3 weeks ago

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    # 金剑不再计价（免费）