DeathChest

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

Permissions

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