MossGraves: death graves that keep your items (Paper 1.21+)

Death graves: items and XP wait in a locked grave where the player died.

Dying far from home should cost a walk back, not everything you were carrying. MossGraves puts a player's items and XP in a grave where they died and gives it all back with one click.

It is small on purpose: one jar, one config file, no other plugins needed.

What it does

A grave on death. A player head (or any block you pick) with floating text: whose it is, how long it is locked and when it crumbles.
Everything goes back in place. Items return to the slots they were in, armor and off-hand included. What does not fit drops at the player's feet.
XP too. Keep all of it, a percentage, or leave XP to the normal game rules.
Owner lock. For the first minutes only the owner can open the grave. After that anyone can, or never, your choice.
Expiry. After a set time the grave crumbles and the items fall out (or are deleted). Turn it off to keep graves forever.
Hard to lose. Graves can't be blown up, pushed by pistons or washed away, and they survive restarts. A grave made in water or lava puts the liquid back afterwards.
/graves shows a player where their graves are and how long they have left.
Limits. A cap on graves per player, worlds without graves, and a switch for PvP deaths.
MiniMessage text everywhere: colors, gradients and hex in the floating text and messages.

Commands

/graves lists your graves
/graves of <player> lists a player's graves
/graves tp <player> [number] teleports to a player's grave
/graves reload reloads the config

Permissions

mossgraves.use to get a grave and use /graves (everyone by default)
mossgraves.bypass to open graves that are still locked (ops by default)
mossgraves.admin for the admin commands (ops by default)

Requirements

Paper 1.21 or newer (built and tested on Paper 1.21.1)
Java 21
No other plugins

Default config

# MossGraves
# Text uses MiniMessage: <green>, <bold>, <#55ff99>, <gradient:gold:yellow> ...

# The block a grave is made of. PLAYER_HEAD shows the head of the player who died.
block: PLAYER_HEAD

# Minutes a grave can only be opened by its owner. 0 = anyone can open it at once, -1 = owner only, always.
protect-minutes: 10

# Minutes until a grave crumbles. -1 = never. The clock keeps running while the player is offline.
expire-minutes: 60
# What happens to the items then: "drop" leaves them on the ground, "delete" removes them.
on-expire: drop

# How much of the player's XP goes into the grave, in percent. 0 = leave XP to the normal game rules.
xp-percent: 100

# A player with more graves than this loses the oldest one (it crumbles as above).
max-graves-per-player: 5

# false: a player killed by another player drops items the normal way.
graves-in-pvp: true

# Worlds without graves.
disabled-worlds: []

# The floating text over a grave. Leave the list empty for no text.
hologram:
  title: "<gold><player>'s grave"
  locked: "<gray>Locked for <white><time>"
  open: "<yellow>Anyone can open it"
  expires: "<gray>Crumbles in <white><time>"

messages:
  created: "<gray>Your items are in a grave at <white><x> <y> <z><gray> (<world>). Type <white>/graves<gray> to see it again."
  collected: "<green>You got your items back."
  looted: "<yellow>You emptied <player>'s grave."
  locked: "<red>This grave belongs to <white><player><red>. It unlocks in <white><time><red>."
  locked-forever: "<red>This grave belongs to <white><player><red>."
  expired: "<red>Your grave at <white><x> <y> <z><red> crumbled."
  inventory-full: "<yellow>Your inventory was full, the rest is at your feet."
  none: "<gray>You have no graves."
  none-other: "<gray><player> has no graves."
  list-header: "<gold>Graves of <player>:"
  list-line: "<gray><n>. <white><x> <y> <z><gray> in <world>, <time>"
  reloaded: "<green>MossGraves config reloaded."

Need something it does not do?

Custom plugins are made to order, from one feature to a full server core. Get in touch.

Get MossGraves, free