# \ud83e\udea6GraveDiggerX<\/p>\n
GraveDiggerX is an advanced plugin for Paper servers that automatically creates graves upon a player’s death. The plugin secures the player’s inventory, experience, and death location, providing clear visual information and easy recovery of lost items.<\/p>\n
<\/p>\n
## \u2705Key Features
\n– **Auto Graves** \u2013 After the player\u2019s death, their inventory and experience are transferred to a gravestone in the form of the player\u2019s head, accompanied by an informational hologram.
\n– **Interactive inventory recovery** \u2013 The owner can open the gravestone\u2019s GUI or quickly collect its contents by holding the sneak key and clicking on the gravestone.
\n– **Death site protection** \u2013 Gravestones are immune to destruction by explosions, fluids, pistons, hoppers, or mobs, and thieves are repelled by a special effect until the gravestone expires.
\n– **Guardian spirit** \u2013 A glowing Allay appears above the gravestone and remains until the loot is collected or the gravestone expires (can be disabled in the configuration).
\n– **Automatic cleanup** \u2013 Gravestones are removed after a defined period, and the owner receives a countdown in the action bar.
\n– **Persistent storage** \u2013 Gravestone data is saved in `data.json`, ensuring it is not lost after a server restart.<\/p>\n
## \ud83d\udce6Requirements and Installation
\n1. A Paper server version 1.21.4-1.21.10 is required.
\n2. Download the latest version of GraveDiggerX and place the JAR file in the `plugins\/` directory.
\n3. Start the server to generate configuration and language files.
\n4. Adjust the configuration as needed, then restart the server or use the `\/gravediggerx reload` command.<\/p>\n
## \u2699\ufe0f Configuration
\nThe most important options are located in the `config.yml` file:<\/p>\n
| Path | Description |
\n| — | — |
\n| `graves.grave-despawn` | Time (in seconds) after which the gravestone is removed. |
\n| `graves.max-per-player` | Maximum number of active gravestones per player; exceeding this limit prevents new gravestones from being created. |
\n| `graves.protected-effect-cooldown` | Cooldown time (in milliseconds) for the knockback effect applied to foreign players attempting to loot a fresh gravestone. |
\n| `graves.protection.*` | Enables\/disables protection against explosions, fluids, mobs, pistons, and hopper item extraction. |
\n| `spirits.enabled` | Controls the appearance of the guardian spirit above the gravestone. |
\n| `language` | Selects the language file (`EN`\/`PL`). You can customize messages in `lang\/messages_*.yml`. |
\n| `update.*` | Automatic update checking and downloading (Hangar\/GitHub\/Modrinth). |
\n| `stats.enabled` | Enables anonymous usage statistics collection. |<\/p>\n
## \ud83d\udcacCommands and Permissions
\nThe main plugin command is `\/gravediggerx` (shortcut `\/grx`). The following subcommands are available:<\/p>\n
| Command | Description | Permission | Additional Permissions:<\/p>\n | Permission | Description | > **Tip:** Operators (OPs) have full access to all plugin features without needing any additional permissions.<\/p>\n ## \ud83d\udcde Contact<\/p>\n If you need support or have any questions, join our Discord ## \ud83d\udcc4 License<\/p>\n This plugin is licensed under the **MIT License**. ## GitHub ## Support and Development <\/p>\n","protected":false},"excerpt":{"rendered":" GraveDiggerX is an advanced plugin for Paper servers that automatically creates graves upon a player’s death. The plugin secures the player’s inventory, experience, and death location, providing clear visual information and easy recovery of lost items.<\/p>\n","protected":false},"featured_media":77641,"template":"","meta":{"_minecraft_slug":"gravediggerx","_minecraft_project_id":"G6k3MNK0","_minecraft_author":"WieszczY","_minecraft_license":"MIT","_minecraft_downloads":950,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"gravediggerx.zip","_minecraft_size_bytes":8806637,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-16T08:46:12.504537Z","_minecraft_date_created":"2025-11-13T01:03:38.425105Z","_minecraft_date_modified":"2025-12-23T17:55:30.783017Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/gravediggerx","_minecraft_icon_attachment_id":77641,"_minecraft_imported_at":"2026-06-04T11:33:03+00:00","_minecraft_import_hash":"e76ea2ce61904c92af2b27ed345c2d2b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,88,89,127,128,92],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-77640","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-equipment","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n| — | — | — |
\n| `\/gravediggerx help` | Displays a list of available commands and basic information.| `grx.cmd.help` |
\n| `\/gravediggerx reload` | Reloads the configuration, messages, and refreshes plugin data without restarting the server.| `grx.cmd.reload` |
\n| `\/gravediggerx list` | Shows the owner the coordinates of all their active gravestones.| `grx.cmd.list` |
\n| `\/gravediggerx admin list
\n| — | — |
\n| `grx.opengrave` | Allows the owner to open the gravestone GUI and collect items using the \u201cCollect All\u201d button. |
\n| `grx.owner` | Master permission granting full access to all plugin features. |
\n| `grx.*` | Wildcard that provides access to all plugin permissions. |<\/p>\n
\nor message us directly via DM.<\/p>\n
\nYou can find the full license text in the LICENSE<\/p>\n
\nGITHUB<\/p>\n
\nThe plugin was designed for survival, hardcore, and RPG servers. Please report suggestions and bugs on the official Discord server or in the project repository so we can continue improving GraveDiggerX.<\/p>\n