{"id":145705,"date":"2026-06-08T20:22:49","date_gmt":"2026-06-08T17:22:49","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/soulkeep\/"},"modified":"2026-06-08T20:22:49","modified_gmt":"2026-06-08T17:22:49","slug":"soulkeep","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/soulkeep\/","title":{"rendered":"SoulKeep"},"content":{"rendered":"

\n \"Minecraft
\n \"Paper
\n \"Zero\n<\/p>\n

SoulKeep<\/h1>\n

Persistent graves for Paper 1.21+<\/strong><\/p>\n

Graves, auto grave compass, lava\/void-safe placement \u2014 no database, no dependencies.<\/p>\n

—<\/p>\n

## Overview<\/p>\n

**SoulKeep** creates a grave when a player dies and restores items reliably on pickup.
\nIt is designed for **persistence** (restarts \/ chunk reloads) and **safe item retrieval**.<\/p>\n

—<\/p>\n

## Features<\/p>\n

– **Graves at death location**
\n Player head + hologram at (or near) the death spot.<\/p>\n

– **Grave Compass (on respawn)**
\n Optional compass that points to the grave. Removed after successful pickup.<\/p>\n

– **Lava\/Void-safe placement**
\n Graves spawn at the **nearest safe block** (configurable per world).<\/p>\n

– **Pickup rules**
\n Optional: allow teammates to pick up your grave.<\/p>\n

– **Auto-expire**
\n Default: **15 minutes** (configurable), including expire action (drop\/destroy).<\/p>\n

– **Per-player limits**
\n Default: **max 3 graves**. When exceeded, the oldest grave is handled by the configured rule.<\/p>\n

– **Slot-aware restoration**
\n Inventory\/Hotbar\/Armor\/Offhand are restored with priority and, when possible, returned to their original slots.<\/p>\n

—<\/p>\n

## Dupe-resistant design<\/p>\n

> **Important:** SoulKeep reduces dupe edge cases via locking and atomic retrieval.<\/p>\n

– **Locking:** a grave can only be processed by **one** player at a time (double-click ignored).
\n– **Atomic retrieval:** give items \u2192 remove grave \u2192 persist immediately.
\n– **Inventory full:** overflow drops at the grave (no silent loss, no dupe).
\n– **Persistence:** grave data survives restarts and graves respawn on chunk load when needed.<\/p>\n

—<\/p>\n

## Requirements<\/p>\n

– **Paper 1.21+**
\n– **Zero dependencies** (no Vault, no PlaceholderAPI, no external database)<\/p>\n

—<\/p>\n

## Installation<\/p>\n

1. Put `SoulKeep-.jar` into `plugins\/`
\n2. Start the server
\n3. Optional: edit `plugins\/SoulKeep\/config.yml`
\n4. Run `\/soulkeep reload` (or restart) after config changes<\/p>\n

—<\/p>\n

## Commands & Permissions<\/p>\n

| Command | Description | Permission |
\n|——–|————-|————|
\n| `\/soulkeep` | Lists your active graves (with coordinates) | \u2013 |
\n| `\/soulkeep reload` | Reloads the config | `soulkeep.admin` |
\n| `\/soulkeep clean` (`\/sk clean`) | Removes your graves and drops items; Admin\/Console can clean globally | Admin: `soulkeep.admin` |<\/p>\n

| Permission | Default | Description |
\n|———–|———|————-|
\n| `soulkeep.admin` | OP | Administrative functions (reload\/clean\/global) |
\n| `soulkeep.lavavoidproof` | Everyone | Enables lava\/void-safe placement (if permission-gated) |<\/p>\n

—<\/p>\n

## Configuration (excerpt)<\/p>\n

“`yaml
\n# Lava\/Void protection
\nlava-void-proof: true
\nlava-void-proof-worlds: {} # e.g. world_nether: false -> Overworld only<\/p>\n

# Grave Compass
\ncompass-tracking: true<\/p>\n

# Limits
\nmax-graves: 3<\/p>\n

# Expiration
\ngrave-expire-hours: 0.25 # hours (0 = never)
\nexpire-action: DROP # DROP or DESTROY<\/p>\n","protected":false},"excerpt":{"rendered":"

Lava\/Void-safe graves with automatic compass tracking. Recover items + XP with one click (Paper 1.21+, zero deps).<\/p>\n","protected":false},"featured_media":145706,"template":"","meta":{"_minecraft_slug":"soulkeep","_minecraft_project_id":"tNi03b21","_minecraft_author":"ClaziX","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":87,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"soulkeep.zip","_minecraft_size_bytes":60058,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:03:43.794567Z","_minecraft_date_created":"2026-02-15T06:04:52.881808Z","_minecraft_date_modified":"2026-02-12T01:28:21.820685Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/soulkeep","_minecraft_icon_attachment_id":145706,"_minecraft_imported_at":"2026-06-08T17:22:50+00:00","_minecraft_import_hash":"53d22eef26bb7a63f28b9e4b8accec35","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,88,89,127,128,129,91,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-145705","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-equipment","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-storage","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","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":"\nSoulKeep - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/soulkeep\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"SoulKeep - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Lava\/Void-safe graves with automatic compass tracking. Recover items + XP with one click (Paper 1.21+, zero deps).\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/soulkeep\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta property=\"og:image\" content=\"https:\/\/img.shields.io\/badge\/Minecraft-1.21+-62b47a?style=for-the-badge&logo=minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/soulkeep\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/soulkeep\\\/\",\"name\":\"SoulKeep - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/soulkeep\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/soulkeep\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/soulkeep-icon-0601ec7d8523843dde312a5c8d50e50e5714c507_96.webp\",\"datePublished\":\"2026-06-08T17:22:49+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/soulkeep\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/soulkeep\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/soulkeep\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/soulkeep-icon-0601ec7d8523843dde312a5c8d50e50e5714c507_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/soulkeep-icon-0601ec7d8523843dde312a5c8d50e50e5714c507_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/soulkeep\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"SoulKeep\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"SoulKeep - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/soulkeep\/","og_locale":"en_US","og_type":"article","og_title":"SoulKeep - Minecraft","og_description":"Lava\/Void-safe graves with automatic compass tracking. Recover items + XP with one click (Paper 1.21+, zero deps).","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/soulkeep\/","og_site_name":"Minecraft","og_image":[{"url":"https:\/\/img.shields.io\/badge\/Minecraft-1.21+-62b47a?style=for-the-badge&logo=minecraft","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/soulkeep\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/soulkeep\/","name":"SoulKeep - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/soulkeep\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/soulkeep\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/soulkeep-icon-0601ec7d8523843dde312a5c8d50e50e5714c507_96.webp","datePublished":"2026-06-08T17:22:49+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/soulkeep\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/soulkeep\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/soulkeep\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/soulkeep-icon-0601ec7d8523843dde312a5c8d50e50e5714c507_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/soulkeep-icon-0601ec7d8523843dde312a5c8d50e50e5714c507_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/soulkeep\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"SoulKeep"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/145705","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/145706"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=145705"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=145705"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=145705"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=145705"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}