Releases: BentoBoxWorld/DeathChest
Release list
Release 1.0.0
Release Highlights
First release. DeathChest saves a player's items into a chest when they die instead of dropping them — and, unlike a general-purpose death chest plugin, it knows where islands are.
- 🔺 Death chests that survive the void — a player who falls off their island, drowns in the acid sea, or dies somewhere they cannot build gets their chest on their own island instead of losing everything.
- ⚙️ Configurable expiry — chests last 60 minutes by default, then either drop their contents or are deleted. Per-player limits included.
- Experience storage — give back all of a player's dropped experience, or only a percentage, so dying still costs something.
- Team access and explosion protection — island members can share chests, and creepers cannot blow them up.
- Player and admin commands — see where your chests are, claim what the addon is holding for you, or teleport to one.
- 🔡 19 locales — English plus 18 machine translations awaiting a native-speaker pass.
Compatibility
✔️ BentoBox API 3.18.0 or later
✔️ Minecraft 26.1.2 and 26.2
✔️ Java 25 on the server (the addon itself is Java 21 bytecode, but Paper 26.x and BentoBox 3.18+ require Java 25)
Built against Paper 26.1.2 and BentoBox 3.18.1. Tested in game on Paper 26.2 with BentoBox 3.21.1 and AcidIsland.
Installation
- Drop the jar into
plugins/BentoBox/addons/. - Restart the server.
- Edit
plugins/BentoBox/addons/DeathChest/config.ymlif you want to change the defaults, then run/bentobox reload.
Permissions, all granted by default except the admin command:
| Permission | Default | What it allows |
|---|---|---|
[gamemode].deathchest |
true | /<gamemode> deathchest — list chests and claim held items |
[gamemode].deathchest.teleport |
true | /<gamemode> deathchest tp <n> |
[gamemode].admin.deathchest |
op | /<gamemode>admin deathchest |
🔺 This addon does nothing while
keepInventoryis on. If the gamerule keeps the player's inventory there are no drops to store, and DeathChest steps aside. TurnkeepInventoryoff in your game mode worlds if you want death chests to be the thing that saves players' items.
🔺 Chests expire. The default is 60 minutes, after which the chest breaks and its contents drop on the ground where they will despawn like any other item. Set
chest.expiry-minutes: 0if you would rather they lasted forever.
🔡 Translations are unreviewed. 19 locales ship in this release —
en-USplus cs, de, es, fr, hr, hu, id, it, ja, ko, lv, pl, ro, ru, tr, uk, vi and zh-CN. Everything except English was machine translated and has not been checked by a native speaker, so expect some awkward phrasing. Corrections are very welcome on issue #7.
Legend
- 🔡 locale files may need to be regenerated or updated.
- ⚙️ config options have been removed, renamed, or added.
- 🔺 special attention needed.
New Features
🔺 Island-aware chest placement
This is the reason the addon exists. A conventional death chest plugin assumes the player died somewhere a chest can be placed and later reached, and on an island server neither assumption holds — the void has no block to build on, another player's island cannot be reached, and the space between islands is neither protected nor walkable.
DeathChest picks the spot in stages:
- The death site, if the player died inside the protected part of an island they belong to and there is reachable ground — solid, within
chest.search-depthblocks below them, and not submerged. This is the normal case: you died on your island, your things are where you died. - Your own island, next to your home location, otherwise. Void deaths, deaths at sea, deaths in lava, deaths while visiting someone else and deaths in the wild all land here — which is also where you respawn.
- Held for you, if you have no island at all. The items sit in the addon's database until you run
/<gamemode> deathchest claim 1.
The "reachable ground" rule in stage 1 is what does the work. Failing it is not an error — it is the signal that sends the chest somewhere the player can actually get to it.
⚙️ Expiry, limits and experience
Chests expire after chest.expiry-minutes (default 60, 0 disables). On expiry, chest.expiry-action either drops the contents on the ground (DROP, the default) or destroys them (DELETE). chest.max-per-player (default 3) expires a player's oldest chest early once they exceed it, so a player who keeps dying does not litter their island.
Experience is stored with the chest and handed back when it is opened. experience.percent scales how much survives, so you can keep some sting in dying without taking everything.
Protection
Only the owner can open or break their chest. chest.team-access (default true) extends that to the island team when the chest is on an island they share. chest.protect-from-explosions (default true) keeps chests out of creeper and TNT blast lists. Records are cleared when an island is reset or deleted, since the blocks go with it.
Commands
| Command | Description |
|---|---|
/<gamemode> deathchest |
List your chests with location and time remaining |
/<gamemode> deathchest claim <n> |
Take the items the addon is holding for chest n |
/<gamemode> deathchest tp <n> |
Teleport to chest n |
/<gamemode>admin deathchest |
How many chests are stored |
/<gamemode>admin deathchest <player> |
List a player's chests |
/<gamemode>admin deathchest purge |
Expire everything past due now |
Aliases: deaths, grave.
Notes on behaviour
Items that do not fit. A player's inventory is 41 slots and a chest is 27, so overflow is normal rather than rare. The chest holds what fits; the rest stays with the addon and is moved into the chest automatically each time the player closes it. Empty the chest and it disappears along with its record.
If the chest block goes away for a reason the addon did not cause — a world edit, a rollback — the record survives and becomes a held chest that can be claimed with the command.
Tab completion needs BentoBox 3.22.0. On BentoBox versions with Brigadier command registration before 3.22.0, /<gamemode> deathchest runs and appears in /<gamemode> help, but is missing from tab completion. That is BentoBox #3039, fixed in BentoBox by PR #3040, and affects every addon that adds a sub-command — nothing needs to change in DeathChest.
What's Changed
- Initial commit: DeathChest addon MVP by @tastybento in df24d2f
- 🔺⚙️ Stop death chests landing on the sea bed by @tastybento in b26035d
- 🔡 Fix chests always being empty, and name worlds properly by @tastybento in 2e71fd0
- Test that commands are actually registered under the game mode by @tastybento in 8a57b25
- Clear the SonarCloud issues by @tastybento in 0be8916
- 🔡 Add 18 translated locale files by @tastybento in a778779
Full Changelog: https://github.com/BentoBoxWorld/DeathChest/commits/1.0.0