Kronentroll’s Graves

A secure, configurable and server-side grave mod for Fabric.

When a player dies, Kronentroll’s Graves safely stores the player’s inventory, armor, offhand items and experience in a protected grave. Players can recover individual items, restore experience separately, restore everything at once, share access with trusted players and use a personalized grave compass to find the grave.

Server-side

This is a server-side mod. Players do not need to install the mod on their clients and can join with a normal compatible Minecraft client.

Fabric Loader and Fabric API are required on the server.

Features

Death storage and protection

Creates a grave only after Minecraft confirms the player’s death
Prevents duplicate death processing
Supports Totems of Undying
Stores main inventory, hotbar, armor, offhand and exact experience points
Saves grave data before removing captured contents from the player
Prevents successfully stored items from also becoming normal death drops
Keeps overflow safely inside the grave
Supports multiple graves per player
Preserves item components, enchantments, damage and custom data
Creates a virtual grave when no safe physical position is available
Retries virtual-grave placement automatically

Grave display

Configurable grave carrier block
Multipart gravestone display
Player name and owner-specific grave number
Optional player-head drop with the correct name and skin
Automatic cleanup of empty graves and display entities

Recovery

Right-click a grave to open its inventory
Recover individual items or use shift-click transfers
Restore stored experience separately
Restore all possible contents with one action
Prioritizes the original inventory, hotbar, armor and offhand slots
Uses safe free slots for items that cannot return to their original position
Never overwrites unrelated items
Keeps items inside the grave when the player’s inventory is full
Supports partial recovery without losing remaining contents
Removes the matching grave compass after complete recovery
Restores the matching compass when recovery remains partial

Automatic grave compasses

Automatically gives a compass after a physical grave is created
Supports separate compasses for multiple graves
Recovers missing compasses after reconnecting or restarting
Gives a compass when a virtual grave is placed later
Updates existing compasses when the grave position changes
Removes invalid and duplicate grave compasses
Does not drop compasses into the world when the inventory is full
Throttles full-inventory notifications
Shows the number of waiting compasses
Supports manual creation or updating with /grave compass <number>
Stores the correct grave ID and dimension in each compass

Safe placement and emergency platforms

Searches for a safe physical grave position
Supports configurable initial and expanded placement searches
Supports lava, fire and void rescue behavior
Can create tracked temporary emergency platforms
Configurable emergency-platform block and size
Protects registered platform blocks from collection, creative breaking, explosions and pistons
Removes registered platform blocks during cleanup without drops
Leaves normal blocks of the same type outside registered platforms unaffected

Grave protection

Protects non-empty graves from normal player breaking
Protects graves from explosions and pistons
Removes supported nearby fire hazards
Repairs missing grave carrier blocks when safe
Protects the supporting block below a physical grave
Protects configurable nearby block placement
Keeps container interaction usable while holding a block
Synchronizes rejected placements to prevent ghost blocks and incorrect stack counts
Allows water buckets, flowing water and waterlogging by default
Blocks lava placement and lava flow near graves by default
Supports configured administrator bypasses

Access and administration

Owner access checks
Trusted-player access and individual grave sharing
Access requests with accept and deny actions
Access removal for individual graves
Optional delayed public access
Optional grave expiration
Optional LuckPerms integration
Administrative read-only inspection
Administrative restoration, relocation and permanent removal with confirmation
Administrative repair tools
Permission overview
Grave diagnosis and integrity checks
Searchable audit-log access for administrators
Configuration reload with validation

Languages and player messages

English and German player messages
Per-player language selection
Optional death coordinates
Optional clickable actions
Optional dimension and grave-number information
Optional recovery warnings

Audit logging

Kronentroll’s Graves writes privacy-conscious audit events to:

logs/kronentrollsgraves-audit.log

Audit logging uses a separate file instead of flooding the normal server console. Entries include the timestamp, action, actor, actor UUID, grave ID, grave owner, grave number, grave status, result and relevant technical details.

Depending on the configuration, the audit log can record:

Grave creation and failed grave creation
Virtual-grave fallback
Later physical grave placement
Item recovery and blocked item transfers
Experience recovery and blocked experience transfers
Complete, partial and started restoration
Access denials and administrator bypasses
Access request creation, acceptance and denial
Compass creation, updates, removal and cleanup
Public-access and expiration events
Empty-grave and administrative removal
Administrative repair, relocation and restoration actions

The logger writes asynchronously so audit-file I/O does not run directly on the server tick thread. The active log rotates at 10 MiB and retains up to four files:

kronentrollsgraves-audit.log
kronentrollsgraves-audit.log.1
kronentrollsgraves-audit.log.2
kronentrollsgraves-audit.log.3
kronentrollsgraves-audit.log.4

The log records item IDs and amounts, but not complete private inventories or full item NBT by default.

Configuration

The active JSON5 configuration is stored at:

config/kronentrollsgraves.json5

An existing config/kronentrollsgraves.json file is detected and migrated automatically when no JSON5 configuration exists. Existing functional values are preserved. Configuration values are validated when loaded, and invalid values are corrected with a server-log warning.

The configuration can be reloaded by an administrator with:

/graveadmin reload

Always stop the server and back up the world and configuration directory before editing settings.

Important configuration groups include:

appearance — grave block, player heads and empty-grave cleanup
storage — item and XP storage, overflow and physical-grave limits
placement — safe-position search, retries and emergency platforms
protection — grave, explosion, piston, fire, lava and fluid protection
access — owners, trusted players, administrators and sharing
expiration — expiration and delayed public access
messages — coordinates, clickable messages and warnings
compass — automatic delivery, updates, cleanup and full-inventory notifications
nearbyPlacementProtection — block and fluid placement near graves
audit — independent audit categories
debug — optional diagnostic logging

The audit section supports these independent switches:

"audit": {
  "enabled": true,
  "logGraveLifecycle": true,
  "logItemTransfers": true,
  "logExperienceTransfers": true,
  "logCompassActions": true,
  "logAccessDecisions": true,
  "logRecoveryResults": true,
  "logAdministrativeActions": true,
  "logExpiration": true
}

Commands

Arguments in angle brackets are required. Grave numbers are shown by /grave list. Grave IDs, request IDs and confirmation IDs are UUID values displayed by the relevant command or clickable message.

Player commands

/grave — Show the player command overview
/grave list — List your stored graves
/grave info <number> — Show details for one of your graves
/grave locate <number> — Locate one of your physical graves
/grave compass <number> — Create or update a grave compass
/grave language — Show the current language
/grave language <english|deutsch> — Select a language
/grave requests — Show pending access requests
/grave request accept <requestId> — Accept an access request
/grave request deny <requestId> — Deny an access request
/grave untrust <graveNumber> <player> — Remove a player’s access

Administrative commands

/graveadmin — Show the administrative command overview
/graveadmin list — List all saved graves
/graveadmin info <graveId> — Show detailed grave information
/graveadmin permissions — Show effective permissions
/graveadmin diagnose <graveId> — Diagnose a grave’s stored and physical state
/graveadmin audit <graveId or player> — Search recent audit entries
/graveadmin integrity — Check stored graves for inconsistencies
/graveadmin reload — Reload and validate the configuration
/graveadmin restore <graveId> <targetPlayer> — Prepare administrative restoration
/graveadmin confirm <confirmationId> — Confirm a prepared restoration
/graveadmin cancel <confirmationId> — Cancel a prepared restoration
/graveadmin relocate <graveId> — Prepare grave relocation
/graveadmin remove <graveId> — Prepare permanent grave removal
/graveadmin repair — Scan and repair eligible grave and platform data
/graveadmin repair <graveId> — Repair one grave

Additional confirmation commands are provided by the relocation and removal command handlers.

Requirements

Server

Minecraft Java Edition 26.3
Fabric Loader 0.19.5 or newer
Fabric API 0.161.0+26.3 or newer
Java 25 or newer

Client

No client-side installation is required.

LuckPerms integration is optional.

Installation

Install Fabric Loader and Fabric API on the server.
Stop the server and create a world and configuration backup.
Remove the previous Kronentroll’s Graves JAR when updating.
Place the new JAR in the server’s mods directory.
Start the server.
Review config/kronentrollsgraves.json5.
Check the server log for configuration or Mixin errors.

No manual world-data migration is required when updating from an older supported version.

Important notes

Exact restoration of every original slot requires enough free inventory space.
Current unrelated items are never overwritten.
Contents that cannot be restored safely remain inside the grave.
Registered emergency-platform blocks are removed without drops.
Normal blocks outside registered emergency platforms remain unaffected.
Back up the world and configuration before every update.

License

The mod may be downloaded and used for personal gameplay and on privately operated Minecraft servers.

Redistribution, re-uploading, resale, modified republication or claiming the mod as your own is not permitted without prior written permission.

Public modpack inclusion is permitted only for modpacks distributed through CurseForge. Redistribution through other platforms or direct downloads requires prior written permission.

AI disclosure

AI-assisted tools were used during development for code review, debugging and documentation. The mod was tested and published under the responsibility of the project author.

Kronentroll’s Graves

介绍