Graveyard UI Pages
The Graveyard plugin provides two main UI pages: the Graveyard Menu (browsing/settings) and the Loot UI (recovering items).
Graveyard Menu
How to open: /ksgraveyard menu (aliases: /grave menu, /gy menu)
Permission: ks.graveyard.user.use (default: allowed for all players)
The menu uses a sidebar navigation layout (ItemControl style) with 4 tabs:
Gravestones Tab
Shows all active gravestones for the player.
| Element | Description |
|---|---|
| Gravestone list | Each entry shows world name, coordinates (X, Y, Z), protection status, and item count |
| Protection badge | Green = protected (owner only), Red = public (anyone can loot) |
| Teleport button | Teleport to the gravestone location (if allowTeleportToGravestone is enabled; may cost currency) |
| Item count | Number of items stored in the gravestone |
Designs Tab
Browse and select gravestone designs.
| Element | Description |
|---|---|
| Design grid | Shows all available designs with 3D model preview |
| Selected indicator | Highlights the currently active design |
| Premium badge | Shows price for premium designs (with Buy button if economy is available) |
| Locked state | Premium designs show a lock icon until purchased or granted by admin |
Click a design to select it as your active gravestone appearance. Free designs can be selected immediately. Premium designs require purchase or admin grant.
Particles Tab
Browse and select particle effects. Only visible when enableParticles is true in config.
| Element | Description |
|---|---|
| Particle list | Shows all available particle effects with preview |
| "None" option | Always available — disables particle effects |
| Premium badge | Shows price for premium particles |
| Color preview | Shows the configured hex color for each effect |
Statistics Tab
View personal death and graveyard statistics.
| Statistic | Description |
|---|---|
| Total Deaths | Number of times the player has died |
| Total Gravestones | Number of gravestones created |
| Items Lost | Total items destroyed by the item loss system |
| Items Recovered | Total items recovered from gravestones |
| Expired Gravestones | Number of gravestones that despawned |
| Looted by Others | Number of gravestones looted by other players |
Loot UI
How to open: Press F on a gravestone block in the world
The Loot UI uses a custom background image (images/gravestone_bg.png) and shows:
Owner's Gravestone
| Element | Description |
|---|---|
| Player avatar | Loaded from HyVatar (cached in avatar-cache/) |
| Item grid | Shows all items stored in the gravestone with quality-colored backgrounds |
| Item tooltips | Hover over items to see details |
| Loot All button | Recovers all items to inventory at once |
| Individual pickup | Click individual items to pick them up selectively |
Other Player's Gravestone (Protected)
When the gravestone is still in its protection period, other players see:
| Element | Description |
|---|---|
| Player avatar | Shows the owner's avatar |
| Player name | Shows the owner's name |
| Memorial mode | Items are hidden — only the avatar and name are visible |
| Protection timer | Shows remaining protection time |
Other Player's Gravestone (Public)
After the protection period expires, other players can loot the gravestone with the same UI as the owner.
WorldMap Integration
When showWorldMapMarker is enabled:
| Element | Description |
|---|---|
| Death marker icon | Custom icon placed on the world map at each gravestone location |
| Item count | Shows how many items are stored |
| Protection status | Shows whether the gravestone is still protected |
| Visibility | Only visible to the gravestone owner |
Markers are registered via the GraveyardMarkerProvider and update automatically when gravestones are created, looted, or removed.