DeathsOffice

Death's Office

Adds OSRS-inspired death recovery with timed graves, stored items, reclaim fees, Death's Coffer, and safe return travel.

Death's Office is a Paper plugin that replaces harsh item loss with a structured PvE death recovery system. When a player dies, their eligible items and dropped experience can be stored in a death record, shown at a temporary grave, and later reclaimed either from the grave or from Death's Office.

The plugin is designed for survival and RPG servers that want death to matter without turning one bad moment into permanent inventory loss.

Features

• OSRS-inspired death item storage and reclaim.
• Timed active graves after PvE deaths.
• Stored item stacks keep their original inventory slots where possible.
• Stored dropped experience can be reclaimed with the death record.
• Grave reclaim flow while the grave is still active.
• Office reclaim flow after the grave expires.
• Generated shared DeathsOffice world.
• Death NPC desk interaction when NPCs is installed.
• Inventory GUI for viewing death records, stored items, reclaim fees, and return options.
• Death's Coffer for depositing valuable held items as non-withdrawable reclaim credit.
• Safe return travel from Death's Office to bed spawn, world spawn, or unlocked visited villages.
• Clickable chat return buttons for office exits.
• Village visit tracking through VillageMemory when available.
• Configurable grave duration.
• Configurable reclaim fee percentages for grave and office reclaim.
• Configurable free-value threshold.
• Configurable Death's Coffer minimum value and credit rate.
• Configurable material value overrides.
• StormEconomy material-worth integration when available.
• Built-in fallback item values when no economy value is configured.
• Durability-aware values for armour, tools, weapons, elytra, shields, bows, crossbows, tridents, maces, and other gear.
• Non-curse enchantments increase reclaim value.
• Premium enchantments add additional value.
• Paid reclaim fails closed if StormEconomy is unavailable or unhealthy.
• Free reclaim remains available without StormEconomy.
• PvP deaths stay vanilla by default.
• keepInventory is respected by default.
• NPC fake-player deaths are ignored so NPCs do not create player graves.
• Disabled-world list for worlds where Death's Office should not capture deaths.
• Managed office world protection against building, breaking, damage, mobs, and explosions.
• SQLite storage by default, with YAML, MySQL, and MariaDB support.
• Admin status, storage, save, backup, reload, rebuild, expire, restore, and audit tools.
• Bukkit service API for other plugins to inspect active graves, office records, coffer balances, storage health, and individual death records.

Death Flow

When a player dies in an enabled world, Death's Office can capture their inventory and dropped experience into a stored death record.

By default:

• PvE deaths are captured.
• PvP deaths are not captured.
• keepInventory deaths are ignored.
• Empty inventories are ignored.
• NPC fake-player deaths are ignored.

After capture, the player's drops are removed from the death event, the stored grave is created, and the player is sent to Death's Office on respawn. They can review their death records, reclaim what fits in their inventory, and return safely.

Graves

Active graves are temporary reclaim points in the world.

Players can interact with their grave marker to open the death record and reclaim items while the grave is still active. Grave reclaim uses the configured grave fee rate, which is lower by default than office reclaim.

When the grave timer expires, the record moves to Death's Office instead of being deleted. Stored items remain available until reclaimed or handled by staff.

Death's Office

Death's Office creates a managed DeathsOffice world with a dark office, a desk for Death, reclaim menus, coffer access, and exit choices.

Players can open the office menu with:

• /deathoffice
• /deaths
• /death

If NPCs is installed, Death appears as a protected neutral fake-player NPC at the desk. If NPCs is missing, command and GUI access still work.

Reclaim Fees

Death's Office prices stored item payloads directly when reclaiming. That means old records and records with missing stored values are revalued instead of becoming free by mistake.

Fee behaviour is configurable:

• Grave reclaim fee percentage.
• Office reclaim fee percentage.
• Free-value threshold.
• Per-material value overrides.
• StormEconomy material-worth lookup.
• Built-in fallback values for normal items.

Durable gear becomes cheaper as durability drops. Useful non-curse enchantments increase value, and rare enchantments such as Mending, Silk Touch, Infinity, Swift Sneak, Wind Burst, Soul Speed, Frost Walker, and Channeling receive extra value.

Death's Coffer

Death's Coffer lets players sacrifice eligible held items while inside Death's Office.

Coffer credit:

• Is stored per player.
• Can pay future reclaim fees.
• Cannot be withdrawn as money or items.
• Uses configurable minimum item value.
• Uses configurable credit basis points.
• Can use StormEconomy material values or Death's Office fallback values.

This gives players a way to prepare for future deaths without turning the coffer into a bank.

Return Travel

Return travel is only available while physically inside the managed Death's Office world.

Players can return to:

• Bed spawn.
• Last remembered world spawn.
• Visited villages unlocked through VillageMemory.

Commands:

• /deathoffice exit bed
• /deathoffice exit world
• /deathoffice exit village <id>

The GUI also provides exit buttons and clickable chat shortcuts.

Storage

Death's Office supports:

• SQLite
• YAML
• MySQL
• MariaDB

SQLite is the default. Storage includes death records, stored item payloads, stored experience, coffer balances, visited villages, audit records, and reclaim state.

Supported admin tools include manual save, backup, reload, storage diagnostics, forced grave expiry, office rebuild, record restore, and audit review.

Commands

Main player command:

• /deathoffice [grave|exit|coffer]

Aliases:

• /deaths
• /death

Player commands:

• /deathoffice
• /deathoffice grave
• /deathoffice coffer
• /deathoffice exit
• /deathoffice exit bed
• /deathoffice exit world
• /deathoffice exit village <id>

Admin command:

• /deathofficeadmin status|storage|save|backup|reload|rebuild|expire|restore|audit

Admin commands:

• /deathofficeadmin status
• /deathofficeadmin storage
• /deathofficeadmin save
• /deathofficeadmin backup
• /deathofficeadmin reload
• /deathofficeadmin rebuild
• /deathofficeadmin expire
• /deathofficeadmin restore <record-id>
• /deathofficeadmin audit [limit]

Permissions

Normal player access is granted by default through deathoffice.defaults.

Player permissions:

• deathoffice.use
• deathoffice.coffer

Admin permissions:

• deathoffice.admin
• deathoffice.admin.command
• deathoffice.admin.status
• deathoffice.admin.storage
• deathoffice.admin.save
• deathoffice.admin.backup
• deathoffice.admin.reload
• deathoffice.admin.rebuild
• deathoffice.admin.expire
• deathoffice.admin.restore
• deathoffice.admin.audit

Optional Integrations

Death's Office works standalone, but can use other Thunder plugins when available.

• StormEconomy provides paid reclaim, formatted money, and material-worth lookups.
• NPCs provides the visible Death fake-player at the office desk.
• VillageMemory unlocks visited-village return travel.
• ThunderPerms is a soft dependency for compatibility with the wider plugin set.

All integrations are optional. Missing NPCs or VillageMemory support does not disable reclaim. Paid reclaim that requires StormEconomy fails safely if the economy is missing or unhealthy.

Notes

Death's Office is built for servers that want death recovery to feel fair, thematic, and configurable. Items are not dropped into unsafe terrain forever, graves do not become instant permanent loss, and valuable gear still carries a reclaim cost.

The default configuration keeps PvP deaths vanilla, respects keepInventory, stores PvE deaths, applies reclaim fees from the first positive item value, and keeps stored death records available until the player reclaims them or staff intervenes.