Perfect Graves

*A polished, claims-aware death-recovery system for Forge 1.20.1.

Lose nothing, find everything, suit up in one motion.*

When you die in vanilla Minecraft, your items hit the floor on a five-minute timer and anyone within sprinting distance can sweep the lot. Perfect Graves replaces that scramble with a gravestone that knows where you fell, what you were wearing, and what else is going on with your server. Right-click your grave (or break it — both work) and your gear snaps back into the exact slots it was in: armor in armor slots, accessories in their Curios slots, sword on the bar, XP credited straight to your bar. No 47-orb chase. No inventory Tetris.

A 10-minute protection timer (configurable, paused while you’re offline) keeps other players out of your stuff while you find your way back.

Death-proof in any biome

• Lava. 3×3 obsidian platform on the surface, grave on top.
• Void. Platform at your last safe ground (or a sane default Y).
• Underwater. Waterloggable — placed on the seafloor with the water column intact.
• Buried in stone. Nearest air spot, scanning up and down — even when you suffocate just under the Nether bedrock ceiling and the only air is below you.
• Bedrock-locked. When even that fails, your gear lands in a virtual vault you can pull back with /grave list. Items are never silently lost.

Find your way back

Up close: full hologram with name, item count, XP, protection timer. Step away: it crossfades into a smaller long-distance marker — ☠ <name> died 12m ago • 187m — readable from across an entire biome, out to 256 blocks by default. Markers are remembered across logouts and chunk unloads.

Every death is logged to a per-player history. /grave history opens a scrollable list — click any entry for read-only details: items at that moment, cause, dimension, exact coordinates.

Designed for modpacks

• Claim mods. Graves never spawn inside someone else’s claim. FTB Chunks, Open Parties and Claims, and Flan are recognized out of the box.
• Curios. Rings, amulets, charms, all custom slots — re-equipped to the same Curios slot they were in at death.
• Soulbound enchants. Items enchanted by Ender IO or Ars Elemental‘s soulbound stay with you across death — and if a third-party soulbound mod (Mystical Agriculture, etc.) returns your gear into the inventory grid, Perfect Graves automatically moves armor pieces back into their armor slots.
• Mod-added drops. Apotheosis affixes, Curios accessories, anything else that hooks LivingDropsEvent — captured in the grave alongside vanilla items.

When no placement is possible — claim blocks every option, you died deep inside bedrock, the void won the day — your stuff goes into a virtual vault. The chat message you get has a clickable, gold-bold /grave list link: one click types it for you.

Commands

| Command | What it does | Who |
|—|—|—|
| /grave list | Opens a menu of your virtual graves | everyone |
| /grave history | Browse every recorded death — items, cause, position | everyone |
| /grave restore <id> | Pulls a virtual grave straight into your inventory | everyone |
| /grave debug <player> | Lists every virtual grave for the target player (UUID, items, position) | OPs |
| /grave marker [...] | Live-toggle long-distance marker visibility, own-only filter, dismiss radius, max distance | client-side, anyone |

For Server Admins

Designed not to wreck your TPS:

• Grave placement is time-boxed (default 10 ms wall-clock per death) and early-exits as soon as it finds enough candidates.
• Never force-loads chunks during placement.
• Failed placements fall through a cascade that ends in either a safe drop or a virtual grave — items are never silently lost unless you explicitly set [fallback].mode = "VANILLA_DROP".
• Intercepts LivingDropsEvent at LOWEST priority, so mod-added drops (Apotheosis, etc.) land in the grave correctly.

Server-wide config lives at config/perfectgraves-common.toml. Per-dimension overrides supported. Per-client marker preferences live separately at config/perfectgraves-client.toml.

Full configuration reference, source code, and issue tracker on GitHub.

License: MIT.
Source: github.com/risenxxx/perfect-graves
Issues: github.com/risenxxx/perfect-graves/issues