A lightweight and customizable grave plugin with explosion protection, smart placement, particle effects, nametag display, expiry system and full config support.

⚰️ Graves

A lightweight, feature-rich grave plugin for Minecraft SMP servers. When you die, your items are stored in a grave — retrieve them by right-clicking it.

---

✨ Features

⚰️ Grave System

On death, all your items are automatically stored in a Soul Sand grave at your death location. Right-click it to retrieve everything instantly. Items that don't fit in your inventory are dropped on the ground.

📍 Smart Placement

The grave always finds a valid location — if you die in the air it places itself on the nearest solid block below, and if you die in water it surfaces to the top of the liquid.

💥 Explosion Protection

Graves are fully protected from explosions. TNT, creepers, and any other explosion source cannot destroy a grave block.

✨ Particles & Nametag

Each grave displays a custom nametag showing the owner's name and the time remaining before expiry, updated every second. Soul particles orbit the grave continuously, making it easy to spot.

🔊 Sounds

A sound plays when a grave is created and when it is looted — both configurable.

⏳ Expiry System

Graves expire after a configurable delay. When a grave expires, items either drop on the ground or are deleted — your choice. Set the delay to 0 to disable expiry entirely.

💬 Death Messages

Send a private message to the player who died and/or broadcast to the whole server — with or without coordinates, fully configurable.

🛡️ Admin Commands

Operators and players with the graves.admin permission can list, delete and clean up any player's graves and nametags via the /graveadmin subcommand system.

⚙️ Full Config Support

Customize expiry time, owner-only looting, nametag format, world blacklist, expiry behavior, death messages and sounds — all from config.yml.

---

📋 Commands

Command	Description
/grave	List your active graves with coordinates and time remaining
/graveadmin list <player>	List a player's active graves
/graveadmin delete <player> <id>	Delete a specific grave
/graveadmin cleantags	Remove all grave nametags across every loaded world
/graveadmin cleantag	Remove grave nametags within 5 blocks of your position
/graveadmin reload	Reload the config

---

🔐 Permissions

Permission	Description
graves.admin	Access to /graveadmin
graves.loot.others	Allows looting other players' graves

---

⚙️ Config

# Graves Plugin Configuration

# Grave expiry in seconds (0 = never expires)
grave-expiry: 600

# Only the owner can loot their grave (ops bypass this)
only-owner-can-loot: true

# Show a nametag above the grave
show-nametag: true

# Nametag format — placeholders: {player}, {time}
nametag-format: "§b{player} §8| §7{time}"

# Worlds where graves are disabled
worlds-blacklist:
  - world_nether
  - world_the_end

# Action when grave expires: drop (items fall on ground) | delete (items are lost)
expire-action: drop

# Death messages
death-message:
  player:
    enabled: true
    show-coords: true
    format: "§fYour grave was created at §7{x} {y} {z} §fin §7{world}§f."
  broadcast:
    enabled: false
    show-coords: true
    format: "§7{player} §fdied at §7{x} {y} {z} §fin §7{world}§f."

# Sounds
sounds:
  enabled: true
  create: entity_wither_spawn
  loot: entity_player_levelup

---

📦 Installation

Drop the .jar into your plugins/ folder and restart your server. No dependencies required.

---

🔧 Compatibility

• ✅ Paper / Spigot
• ✅ Minecraft 1.21.x // 26.x.x

---

Made with ❤️ by Gregwll