GraveCompass
When a player dies their things do not scatter on the floor: they stay in a grave with their name on it. And they get a compass that really points at it.
Why another compass
Almost every grave plugin hands you coordinates in chat. Chat is gone the moment three players talk, and writing numbers down is not fun. Here the needle points at the grave, in the Nether and the End too, and its lore rewrites itself every second with the distance and the protection time left.
Installation
One minute. It needs no other plugin.
- Copy GraveCompass-1.0.jar into the plugins folderWorks on both Spigot and Paper, 1.21 and up. No Vault, no dependencies.
- Restart the serverIt creates
config.ymland the four language files. You can start dying now. - Pick your languageIn
config.yml,language:en,es,frorzh. - Give the teleport permission to your rank
lp group vip permission set gravecompass.teleport true— nobody has it by default, not even ops. Without it the compass still points at the grave and gives the distance, but they walk. - Set your ranks and reloadIn
grave-cooldownsandteleport-cooldowns, then/grave reload.
The grave
It is a head wearing the skin of the player who died, with floating text above it saying whose it is and how long it stays protected, counting down live.
Getting it back
Right-click the head, or hit it: either one opens it. It opens as a chest, you take what you want and whatever you leave stays inside. A full inventory no longer sends anything to the floor, which is exactly what happened when you ran back from spawn loaded with spare tools.
The Take everything button puts every item back in the slot it came from: the chestplate on your chest, the shield in your off hand and the hotbar in order. Only what no longer fits looks for a free slot.
Protection
For protection-seconds only the owner can open it. After that anyone can — and that is what makes dying out in the open cost something. Use -1 for owner-only forever, or 0 for never protected.
When it goes away
The despawn clock starts when the protection ends, not when you died: while the grave is still yours there is no reason for it to run. With despawn-drops-items: false it vanishes with everything inside, which is what keeps the world clean.
The compass
It is handed over automatically on respawn, or by hand with /grave compass. Everything is in its lore, rewritten every second:
Grave Compass
» World: world
» At 120, 64, -30
» Distance: 47 blocks
» Yours for 3m 12s
✦ Right-click to teleport thereThat last line is the one that changes with rank. Whoever cannot teleport reads what they are missing and where to get it — you write that text, so it can name your rank or your store command.
RECOVERY_COMPASS in the config: it exists since 1.19, it fits the theme and WorldEdit does not touch it.What you can sell
Two things, and both are set up the same way: how often a player gets a grave and how often they can teleport.
How to set it up
grave-cooldowns:
default:
permission: 'gravecompass.cooldown.grave.default'
minutes: 10
vip:
permission: 'gravecompass.cooldown.grave.vip'
minutes: 5
admin:
permission: 'gravecompass.cooldown.grave.admin'
minutes: 0- The block name (
vip,admin…) is only a label for you. What counts ispermissionand the number. - Hand the permission out with your permissions plugin:
lp group vip permission set gravecompass.cooldown.grave.vip true - The lowest number among the ranks a player holds wins. Stacking ranks can never hurt them.
- Whoever holds none falls back to
default.0means no wait. - You can add or remove ranks freely. Nothing else in the plugin needs to change.
teleport-cooldowns works exactly the same, but in seconds. And teleporting at all also needs gravecompass.teleport, which nobody has by default — not even ops.
Commands
Base: /grave · aliases /graves, /gc, /tumba
| Command | What it does | Who |
|---|---|---|
/grave | The help | Everyone |
/grave compass | Gives you the compass to your grave | Everyone |
/grave list | Your grave and where it is | Everyone |
/grave near | The graves around you | Admin |
/grave reload | Reloads config and language | Admin |
Permissions
| Permission | Grants | Default |
|---|---|---|
gravecompass.use | Get a grave on death and use the compass | true |
gravecompass.compass | Ask for the compass with /grave compass | true |
gravecompass.teleport | Teleport to their grave | nobody |
gravecompass.cooldown.grave.* | How often they get a grave (see Selling ranks) | per rank |
gravecompass.cooldown.teleport.* | How often they can teleport | per rank |
gravecompass.bypass | Open someone else's grave while protected | op |
gravecompass.admin | /grave near and /grave reload | op |
Configuration
Everything lives in config.yml, and the file updates itself: a new version brings its new options in with their documentation and keeps whatever you changed. All four language files are kept up to date the same way.
What you will actually change
| Option | What for |
|---|---|
graves.protection-seconds | How long it is yours alone. -1 always, 0 never |
graves.despawn-after-protection-seconds | How long it lasts once unprotected |
graves.despawn-drops-items | Whether it drops its contents or takes them with it |
graves.rescue-from-liquid | Lifts the grave out of the lava |
compass.item | COMPASS or RECOVERY_COMPASS (see WorldEdit) |
worlds.never-in | Worlds with no graves: arena, minigames… |
graves.open-as-chest | Open it as a chest instead of dumping it on you |
Version history
Every release and what changed in it.
- 🐛"Take everything" left a full copy of the items inside the grave, so it could be looted again and again. The grave now empties and disappears, as it always should have.
- 🐛Right-clicking a grave with an empty hand opened it twice, and that let a second player into the same grave at the same time, each taking a copy. Only one player at a time now.
- 🐛Restarting or reloading the server with a grave open saved it as it was when opened, so whatever the player had taken came back after the restart.
- 🐛Dying while looting your own grave, or a grave expiring while someone was looting it, no longer copies the items that had already been taken out.
- 🐛Items can no longer be put into a grave with the number keys, F or by dragging. That also stops "Take everything" from putting any block on your head as a helmet.
- 🐛Graves with more than 4 extra items (graves from 1.0, merged graves, drops added by other plugins) lost everything past the 4th as soon as they were opened.
- 🐛Graves in worlds loaded after the plugin (Multiverse and similar) were deleted from graves.yml. They are now kept and come back as soon as their world loads.
- 🐛"Take everything" with a full inventory dropped the rest on the ground. It now stays in the grave and the window stays open, showing what is left.
- 🐛Taking every item out by hand left the grave behind with only the experience in it. You now get the XP and the grave disappears.
- 🐛With nowhere to place the grave, the experience was lost. It now drops on the ground along with the items.
- 🐛Relogging reset the teleport cooldown, and the warm-up could be cut short by cancelling and clicking again. Both fixed.
- 🐛Teleporting to a grave floating over lava put you inside the head, with nothing under your feet. You now land on top of it.
- 🐛Right-clicking your grave with the compass in your hand opens it instead of teleporting you to where you already are.
- 🐛Setting graves.block to a plain block like STONE broke graves. It now falls back to a player head and says so in the console.
- 🐛Ranks you delete from grave-cooldowns or teleport-cooldowns no longer come back on the next restart.
- ✨The grave opens as a chest: take what you want and whatever you leave stays inside. A full inventory no longer throws anything on the floor.
- 🐛Recovering a grave now puts every item back in the slot it came from: the chestplate on your chest, the shield in your off hand, the hotbar in order.
- 🐛A creeper or a piston can no longer break or move the grave. Before, the grave could not be opened at all until the chunk reloaded.
- 🐛Merging two graves (over-limit: merge) dropped the older one's contents and lost its experience. Everything moves across now, as the config promised.
- 🔧Graves from 1.0 are still read as they are. Nothing is lost when you update, even if people have graves they have not collected yet.
- ✨Graves that keep your things when you die, wearing the dead player's own skin, with a floating countdown showing how long they stay protected.
- ✨A compass whose needle actually points at your grave - in the Nether and the End too - with the world, the coordinates, the distance and the protection time written on the item and rewritten every sec
- ✨Teleport to your grave, sold per rank: it needs a permission nobody has by default, and players without it still see where the grave is and how far.
- ✨How often each rank gets a grave and how often they can teleport, both set up as named ranks in the config.
- ✨Dying in lava does not burn your things: the grave rises out of it and floats above the surface with everything inside.
Discussion
Comment and share your experience on each plugin version.
No comments on this version yet — be the first!
No comments on this version yet — be the first!
No comments on this version yet — be the first!
Player reviews
What server owners think of this plugin.
No reviews yet.