Sueta

GraveDiggerX

1.1.2

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

·Plugin

Logo GraveDiggerX

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.

gravelook.png

Logo Key Features

  • Auto Graves – After the player’s death, their inventory and experience are transferred to a gravestone in the form of the player’s head, accompanied by an informational hologram.
  • Grave Teleportation – Added a dedicated GUI for teleporting to your active graves.
  • Interactive inventory recovery – The owner can open the gravestone’s GUI, use teleportation features, or quickly collect its contents by holding the sneak key and clicking on the gravestone.
  • Death site protection – Gravestones are immune to destruction by explosions, fluids, pistons, hoppers, or mobs, and thieves are repelled by a special effect until the gravestone expires. Enhanced WorldGuard integration ensures that if a player dies in a protected region where building is disabled (build: false), graves won't spawn and items drop normally as a fallback.
  • Guardian spirit – A glowing Allay appears above the gravestone and remains until the loot is collected or the gravestone expires (can be disabled in the configuration).
  • Automatic cleanup – Gravestones are removed after a defined period, and the owner receives a countdown in the action bar.
  • Persistent storage – Gravestone data is saved in data.json, ensuring it is not lost after a server restart.

📦Requirements and Installation

  1. A Paper server version 1.21.8-26.2 is required.
  2. Vault plugin (required for economy integration and teleportation costs).
  3. Download the latest version of GraveDiggerX and place the JAR file in the plugins/ directory.
  4. Start the server to generate configuration and language files.
  5. Adjust the configuration as needed, then restart the server or use the /gdx reload command.

⚙️ Configuration

The most important options are located in the config.yml file:

PathDescription
graves.grave-despawnTime (in seconds) after which the gravestone is removed.
graves.max-per-playerMaximum number of active gravestones per player; exceeding this limit prevents new gravestones from being created.
graves.protected-effect-cooldownCooldown time (in milliseconds) for the knockback effect applied to foreign players attempting to loot a fresh gravestone.
graves.protection.*Enables/disables protection against explosions, fluids, mobs, pistons, and hopper item extraction.
teleport.enabledEnables or disables the grave teleportation feature.
teleport.costCost required to teleport to a grave (integrated with Vault).
spirits.enabledControls the appearance of the guardian spirit above the gravestone.
languageSelects the language file (EN/PL). You can customize messages in lang/messages_*.yml.
update.*Automatic update checking and downloading (Hangar/GitHub/Modrinth).
stats.enabledEnables anonymous usage statistics collection.

💬Commands and Permissions

The main plugin command is /gravediggerx (shortcut /gdx). The following subcommands are available:

CommandDescriptionPermission
/gravediggerx helpDisplays a list of available commands and basic information.gdx.cmd.help
/gravediggerx reloadReloads the configuration, messages, and refreshes plugin data without restarting the server.gdx.cmd.reload
/gravediggerx listShows the owner the coordinates of all their active gravestones.gdx.cmd.list
/gravediggerx tpOpens the graphical interface to view and teleport to active graves.gdx.cmd.tp
/gravediggerx admin list <player>Lists all gravestones of a specific player (for administrators).gdx.cmd.admin

Additional Permissions:

PermissionDescription
gdx.opengraveAllows opening and collecting items from graves.
gdx.cmd.tpAllows viewing the tp GUI.
gdx.cmd.helpAllows viewing the help command.
gdx.cmd.reloadAllows reloading the GraveDiggerX configuration.
gdx.cmd.listAllows listing active graves.
gdx.cmd.adminAllows using administrative commands.
gdx.ownerAllows using all GraveDiggerX commands.
gdx.*Wildcard that provides access to all plugin permissions.

Tip: Operators (OPs) have full access to all plugin features without needing any additional permissions.

📞 Contact

If you need support or have any questions, join our Discord
or message us directly via DM.

📄 License

This plugin is licensed under the MIT License.
You can find the full license text in the LICENSE

GitHub

GITHUB

❤️ Like the plugin? If GraveDiggerX helps you out, a quick heart/like on Modrinth would mean the world to us and help the plugin reach a wider audience! Thank you for your support!

Support and Development

The 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.

syntaxdevteam_logo.png

Similar projects

Plugin →