DeathChest

Death chests that safely store items and XP on death, for Paper/Purpur 1.21.x

Version 1.0.0 · Minecraft 1.21.x · Java 21 · Server-side

When a player dies, DeathChest stores their items and XP in a protected chest at the death location. The chest block is only a marker: the items live in a virtual 45-slot GUI, which closes many vanilla dupe and hopper vectors. Owners get a clickable location message, a "Collect All & Equip" button, temporary protection, holograms, particles, configurable expiry and optional public looting.

Features

• Virtual item storage: items are held in a GUI, not in the chest block, so the block is always empty (no hopper pulls, no vanilla dupe surface).
• XP storage with a configurable percentage and a click-to-claim indicator.
• Collect All & Equip button that transfers everything and equips armor.
• Temporary protection with configurable duration; optional access for the killer during protection and public looting after it expires.
• Chest expiry with DROP_ITEMS, DELETE_ITEMS or KEEP_PUBLIC actions.
• Block protection: prevent breaking, explosions, hoppers, pistons and fire/lava from destroying the chest.
• Safe placement: searches for a safe spot, handles void deaths and water-surface placement.
• Holograms (armor stands, no dependency) and particles around the chest.
• Per-player chest limits with optional override of the oldest chest.
• Clickable coordinates to teleport/locate your chest.
• SQLite persistence, multi-language (English, Portuguese, French), and a developer API (DeathChestAPI).

Commands

Command	Description	Permission
/deathchest locate (aliases /dc, /dchest)	Locate your death chests	deathchest.locate
/deathchest list	List death chests	deathchest.admin
/deathchest remove	Remove a death chest	deathchest.admin
/deathchest reload	Reload the configuration	deathchest.admin
/deathchest cleanholograms	Clean up orphan holograms	deathchest.admin.clean

Permissions

Node	Description	Default
deathchest.use	Have death chests created on death	true
deathchest.locate	Locate your own death chests	true
deathchest.admin	Full admin access to death chest commands	op
deathchest.admin.clean	Clean orphan holograms	op
deathchest.bypass	Bypass protection and access any death chest	op
deathchest.break.others	Break other players' death chests	op

Configuration

Highlights of config.yml:

general:
  language: en_US             # en_US | pt_PT | fr_FR

worlds:
  mode: blacklist             # whitelist | blacklist
  list: [world_example_disabled]

chest:
  create-with-keep-inventory: false
  store-xp: true
  xp-percentage: 1.0
  max-chests-per-player: 5
  override-oldest-on-max: true

placement:
  safe-search-radius: 10
  void-placement-radius: 16
  void-y-threshold: -64
  water-surface-placement: true

protection:
  duration-seconds: 300               # 0 = permanent until claimed
  allow-public-loot: false
  allow-killer-loot-during-protection: false
  allow-public-loot-after-expiry: true
  expiry-seconds: 3600                 # 0 = never expire
  expiry-action: DROP_ITEMS            # DROP_ITEMS | DELETE_ITEMS | KEEP_PUBLIC
  prevent-breaking: true
  explosion-proof: true
  hopper-proof: true
  lava-safe: true
  piston-proof: true

visuals:
  hologram-enabled: true
  particles-enabled: true

Protection vs. expiry

Two separate timers control access:

• duration-seconds — the protection window during which only the owner (and, if enabled, the killer) can loot the chest.
• allow-public-loot-after-expiry — when true, once the protection window ends, anyone can loot. With the default duration-seconds: 300, that means other players can loot the chest 5 minutes after the death. Set it to false to keep chests owner-only.
• expiry-seconds / expiry-action — how long the chest exists before it is removed, and what happens to the items when it does.

Installation

1. Requires Paper or Purpur 1.21.x and Java 21.
2. Drop the JAR into plugins/ and start the server once to generate config.yml.
3. Review the protection section (especially the public-loot options), then run /deathchest reload.

Dependencies

• PlayerSettings (optional) — per-player language selection, if installed.
• BuildersDream (optional) — filters "dream items" out of death chests, if installed.

No hard dependencies. The SQLite driver is bundled; holograms use armor stands (no hologram plugin required).

Support / Source

Source code: https://github.com/henriquescrrrr/carrageis-deathchest