> For the complete documentation index, see [llms.txt](https://papertweaks.machinemaker.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://papertweaks.machinemaker.me/modules/graves.md).

# Graves

A simple graves plugin to capture player drops and experience. Has some configuration options to allow grave robbing and locating.

If you would like to remove all graves, use the command below:

```
/execute as @e[type=minecraft:armor_stand] if data entity @s "BukkitValues".vanillatweaks:player_uuid run kill @s
```

You can limit the range of deletion to 20 blocks by adding a `,distance=..20` to the first entity selector. **This command destroys the items in the graves, so be careful.**

## Commands

<table><thead><tr><th width="242" align="right">Command</th><th>Info</th></tr></thead><tbody><tr><td align="right">/graves locate</td><td><strong>Permission:</strong> <code>vanillatweaks.graves.locate</code><br><strong>Description:</strong> Locates your most recent grave</td></tr><tr><td align="right">/graves grave-key</td><td><strong>Permission:</strong> <code>vanillatweaks.graves.admin.grave-key</code><br><strong>Description:</strong> Obtain a grave key capable of opening any grave</td></tr><tr><td align="right">/graves admin config</td><td><strong>Permission:</strong> <code>vanillatweaks.graves.admin.config</code><br><strong>Description:</strong> Configure Graves in-game</td></tr></tbody></table>

## Permissions

<table><thead><tr><th width="339" align="right">Permission</th><th>Info</th></tr></thead><tbody><tr><td align="right">vanillatweaks.graves</td><td><strong>Default:</strong> <mark style="color:green;">true</mark><br><strong>Description:</strong> Player death can spawn a grave</td></tr><tr><td align="right">vanillatweaks.graves.locate</td><td><strong>Default:</strong> <mark style="color:green;">true</mark><br><strong>Description:</strong> Use the graves locate command to find your last grave (requires grave locations to be toggled on in the configuration)</td></tr><tr><td align="right">vanillatweaks.graves.admin.admin-key</td><td><strong>Default:</strong> <mark style="color:orange;">op</mark><br><strong>Description:</strong> Use the command to get a grave key</td></tr><tr><td align="right">vanillatweaks.graves.admin.config</td><td><strong>Default:</strong> <mark style="color:orange;">op</mark><br><strong>Description:</strong> Configure Graves in-game</td></tr></tbody></table>

## Configuration

```yaml
# Enable to use crouching on the grave to retrieve it
legacy-shift-behavior: false
# When enabled, players can open graves they don't own
grave-robbing: false
# When grave-robbing is enabled, this is the number of seconds to prevent grave robbing
grave-robbing-timer: 0
# When enabled, players can see the coordinates of their last grave
grave-locating: true
# When enabled, graves collect experience dropped on death
xp-collection: true
# Worlds listed here will not create graves for players
disabled-worlds:
  - "disabled_world_name"

```
