🪦 GravesSystem

Your death. Your grave. Your items.

GravesSystem is a lightweight, immersive, and highly optimized grave plugin for Paper, Purpur, and Folia 1.21+.

Forget messy item drops and outdated death chest systems. When a player dies, GravesSystem safely stores their inventory and experience, then creates a grave at the death location using the player's own Minecraft head and skin.

A live hologram displays the player's name, cause of death, and a countdown until the grave expires.

No commands. No complicated menus. No unnecessary hassle.

Simply return to your grave, right-click it, and recover your items exactly as they were before you died.

⚠️ Important Notice

If you encounter any issues with the plugin, please report them on our Discord server!

✨ Features

🪦 Immersive Player Graves

Every grave uses the deceased player's own head with their real Minecraft skin, creating a more immersive alternative to ordinary death chests.

🎒 Exact Inventory Preservation

Your inventory is preserved slot-for-slot, including:

• Main inventory
• Armor
• Offhand
• Experience points

Everything is restored to its original position whenever possible.

⚡ Instant Item Restoration

Simply right-click your grave to retrieve your belongings.

• No commands required.
• No menus or unnecessary delays.
• Items return to their original inventory slots.
• If your inventory is full, remaining items are dropped at your feet.

🛡️ Grief-Proof Graves

Graves are protected against common forms of destruction, including:

• Explosions
• Fire and burning
• Water and lava
• Pistons
• Withers
• End Crystals

Protection also covers buckets, dispensers, and waterlogged blocks where applicable.

Every protection feature can be configured individually.

🔄 Self-Healing Graves

If a grave block disappears because of another plugin, WorldEdit, or another external change, GravesSystem automatically attempts to restore it.

Your items won't remain trapped in an invisible grave simply because its block disappeared.

🔒 No Item Loss. No Duplication.

GravesSystem is designed to handle death and item recovery safely.

• Atomic grave looting prevents the same grave from being emptied multiple times.
• keepInventory is handled safely.
• Void deaths are handled appropriately.
• Multiple deaths at the same location are supported.
• Cancelled death events are handled safely.

📍 Smart & Safe Placement

Graves are placed on suitable, solid ground near the player's death location.

The placement system avoids:

• Lava
• The void
• Locations occupied by other graves
• The Nether roof

A configurable search radius allows you to control how far the plugin searches for a suitable location.

👑 Secure Grave Ownership

By default, only the grave's owner can retrieve its contents.

Server administrators can optionally allow graves to become accessible to other players after a configurable amount of time.

💬 Modern Holograms

GravesSystem uses lightweight Minecraft TextDisplay entities instead of traditional armor-stand holograms.

Customize the hologram's height and text, including:

• Player name: {player}
• Cause of death: {reason}
• Time remaining: {time}

Holograms update only when their displayed text changes, reducing unnecessary processing.

💾 Persistent Storage

Graves are stored in an SQLite database and persist across server restarts and crashes.

Your players' graves remain available without relying on temporary in-memory storage.

🌍 Full Folia Support

GravesSystem is designed with region-aware execution for Folia.

One JAR supports Paper, Purpur, and Folia.

🔔 Update Notifications

Administrators can receive clickable chat notifications when a newer version is available on Modrinth.

Configure the update checker, including its interval, pre-release notifications, and join notifications.

⚡ Highly Optimized

GravesSystem is built for performance and reliability.

• Cached configuration for reduced overhead.
• Asynchronous database writes.
• No forced chunk loading.
• Efficient hologram updates.
• Region-aware execution for Folia.
• No unnecessary packet manipulation.

📦 Zero Dependencies

No ProtocolLib. No external hologram plugins. No additional dependencies.

Install the JAR and you're ready to go.

⚙️ Configuration

GravesSystem offers extensive configuration options with sensible defaults.

🪦 Grave Management

• Grave lifetime: 30m, 24h, 7d, or unlimited.
• Expiration behavior: delete the grave or drop its items.
• Safe placement and configurable search radius.
• World blacklist.

🎒 Inventory & Experience

• Inventory, armor, and offhand preservation.
• Experience storage.
• Configurable percentage of experience retained.
• Curse of Vanishing behavior, vanilla-like by default.

🔒 Protection & Ownership

• Owner-only grave access.
• Optional timer before other players can loot graves.
• Explosion protection.
• Fire protection.
• Water and lava protection.
• Piston protection.
• Wither protection.
• End Crystal protection.

Every supported protection option can be enabled or disabled individually.

💬 Holograms & Messages

• Enable or disable holograms.
• Configure hologram height.
• Customize displayed lines.
• Use {player}, {reason}, and {time} placeholders.
• Configure the sound played when looting a grave.
• Customize chat messages and prefixes using & color codes.

🔔 Update Checker

• Configure the update-check interval.
• Enable or disable pre-release notifications.
• Toggle update notifications when administrators join.

Automatic configuration updates: New options are added to your existing config.yml automatically when supported by the plugin's update process, helping preserve your existing settings.

🛠️ Commands & Permissions

Players don't need to remember any commands to use their graves.

All /grave commands are intended for administrators and are hidden from regular players.

Commands

Permissions

🧩 Developer API

GravesSystem provides an API for developers who want to integrate grave functionality into their own plugins.

Available events:

• GraveCreateEvent
• GraveLootEvent
• GraveDestroyEvent
• GraveExpireEvent

Grave creation and looting events are cancellable, allowing developers to customize how the plugin interacts with their own mechanics.

📋 Requirements

• Minecraft: 1.21+
• Server software: Paper, Purpur, or Folia
• Java: 21+
• Dependencies: None

Not supported: Plain Spigot/Bukkit.

🚀 Why GravesSystem?

GravesSystem is built for server owners who want a reliable, immersive, and performance-friendly death recovery system.

Instead of scattering items across the ground or relying on outdated chest mechanics, your players get a dedicated grave that preserves their inventory and makes recovery simple.

✅ Immersive player-head graves
✅ Exact inventory restoration
✅ Configurable protection and ownership
✅ Persistent SQLite storage
✅ Modern holograms
✅ Paper, Purpur, and Folia support
✅ Developer API
✅ No dependencies
✅ No commands required for normal players

🪦 Death Is Only the Beginning.

Give every death a proper grave with GravesSystem.