Kronentroll's Graves

Keep your items safe. Recover your experience. Never lose track of your grave.

Kronentroll's Graves is a secure and multiplayer-friendly grave mod for Fabric.

When a player dies, their inventory, equipment and exact experience are stored in a protected grave. If no safe gravestone location is available, the contents remain stored as a virtual grave instead of being lost.

Open the gravestone to recover individual items, restore everything at once, or use a grave compass to find your way back.

At a Glance

• Stores the complete player inventory, armor and offhand item
• Preserves exact experience points
• Creates protected multipart gravestones
• Uses virtual graves when physical placement is unsafe
• Retries eligible virtual graves with an expanded search radius
• Supports lava and void recovery with temporary emergency platforms
• Includes a grave inventory with XP and level information
• Restores individual items or everything possible at once
• Keeps overflow safely inside the grave
• Provides automatically managed grave compasses
• Supports per-grave sharing and interactive access requests
• Includes English and German player languages
• Provides administrative inspection, restoration, relocation, repair and removal
• Protects graves against players, explosions, pistons, fire and replacement

The mod prioritizes preservation. It avoids deleting non-empty graves and avoids replacing unrelated solid blocks whenever possible.

Main Features

Secure Item and Experience Storage

After a player dies, the mod can store:

• The complete 36-slot player inventory
• Equipped armor
• The offhand item
• Exact stack sizes
• Item durability
• Item components and metadata
• Exact experience points

The complete grave record is saved before captured contents are removed from the player. If grave processing encounters a problem, the mod attempts to preserve the original inventory rather than silently deleting it.

Physical and Virtual Graves

Physical Graves

A physical grave is represented by a protected multipart gravestone in the world. It displays the owner's grave number and player name using a language-neutral label.

Virtual Graves

If no safe physical location is available, the grave remains stored virtually.

Virtual graves:

• Keep all stored items and experience
• Appear in the player's grave list
• Preserve the original death position
• Can be inspected by administrators
• Can be retried for physical placement
• Are not deleted merely because placement failed

Later placement attempts use the configured expanded search radius.

Safe Grave Placement

A valid grave location must:

• Be inside the world border
• Be inside the world's build height
• Have enough free space
• Have safe supporting terrain
• Avoid dangerous lava and fire positions
• Avoid overwriting unrelated solid blocks
• Avoid positions already reserved by another grave

The initial and expanded search radii are configurable separately.

Lava and Void Recovery

The mod can detect dangerous lava or void-like deaths and can:

• Search for a safer nearby position
• Create a temporary emergency platform
• Place the grave above that platform
• Persistently track all generated platform blocks
• Protect the platform while the grave exists
• Remove the platform safely after the grave is removed

Temporary-platform cleanup can continue after a server restart.

Interactive Grave Inventory

Right-click a physical gravestone to open its inventory.

The grave menu contains:

• Stored inventory items
• Stored armor
• The stored offhand item
• Total stored XP
• Equivalent Minecraft level and progress
• A restore-all button

Items cannot be inserted into the grave.

If the player's inventory is partly full:

• Items that fit are restored
• Experience can still be restored
• Remaining items stay safely inside the grave
• The player is told how many items remain

Experience Display

The experience display shows:

• Total stored XP
• Equivalent Minecraft level
• Percentage progress through that level
• XP progress toward the next level

Example:

Stored experience
425 XP
Equivalent to level 18 + 37%
18 of 49 XP toward the next level

The experience icon is informational and cannot be removed.

Quick Recovery

Sneak and right-click a gravestone to restore all possible contents immediately.

The restoration system:

• Uses preferred original slots first
• Restores armor and offhand items safely
• Merges compatible stacks
• Uses other free inventory slots when needed
• Never overwrites unrelated items
• Leaves anything that does not fit inside the grave

Grave Compasses

Use:

/grave compass <number>

A grave compass:

• Points toward the physical grave
• Displays the grave number and owner
• Displays the target dimension and coordinates
• Uses the player's selected language
• Updates automatically
• Disappears after the grave no longer exists
• Prevents duplicate compasses for the same grave

A compass is available only while a grave has a physical position.

Navigation

Navigation information can include:

• Grave number
• Grave status
• Dimension
• Coordinates
• Horizontal and complete distance
• Cardinal direction
• Height difference
• Clickable coordinate copying

If the grave is in another dimension, the player is informed that distance and direction can be calculated after entering that dimension.

Player Commands

Show help:

/grave

List your graves:

/grave list

Show detailed grave information:

/grave info <number>

Locate a grave:

/grave locate <number>

Obtain or update a grave compass:

/grave compass <number>

Change language:

/grave language english
/grave language deutsch

Show pending access requests:

/grave requests

Remove trusted access:

/grave untrust <grave number> <online player or UUID>

Access Control

Graves are private by default.

Access can be granted through:

• Grave ownership
• Trusted-player lists
• Interactive access requests
• Optional public access
• Administrative inspection permissions

When another player interacts with a private grave, they can request access from the owner. The owner receives clickable actions to allow or deny the request.

Requests expire automatically, cannot be duplicated for the same player and grave, require the owner to be online and are removed when the grave no longer exists.

Grave Protection

Non-empty graves can be protected against:

• Player attacks and block breaking
• Explosions
• Pistons
• Fire
• Lava and fluids
• Block replacement
• Wither-related destruction
• Enderman interactions
• Compatible external block-changing systems

The mod also monitors physical graves and can restore missing carrier blocks or display entities. If an unrelated solid block occupies the recorded position, the mod avoids overwriting it and preserves the grave data for administrative recovery.

Automatic Recovery and Repair

The mod can:

• Restore a missing grave carrier block
• Recreate missing display entities
• Remove duplicate display entities
• Migrate legacy grave blocks
• Detect blocked grave positions
• Mark graves that need administrative recovery
• Retry eligible virtual graves
• Use an expanded search radius on later attempts

Automatic retry processing is deliberately limited to control server load.

Administrative Tools

Administrators can:

• List every stored grave
• Inspect complete grave details
• Open graves in read-only mode
• Restore contents to an online player
• Relocate graves
• Repair grave representations
• Permanently remove graves with confirmation
• Review effective permissions

Commands:

/graveadmin list
/graveadmin info <grave UUID>
/graveadmin restore <grave UUID> <online player>
/graveadmin relocate <grave UUID>
/graveadmin remove <grave UUID>
/graveadmin repair
/graveadmin repair <grave UUID>
/graveadmin permissions

Administrative removal warns when a grave still contains items or XP. If the grave changes after confirmation was prepared, removal is cancelled and must be prepared again.

Permissions

Available permission nodes:

kronentrollsgraves.owner
kronentrollsgraves.admin
kronentrollsgraves.inspect
kronentrollsgraves.restore
kronentrollsgraves.remove
kronentrollsgraves.relocate
kronentrollsgraves.access/bypass

Administrative read-only access does not allow an administrator to restore another player's grave into their own inventory. Sensitive administrative actions can be written to a dedicated audit log.

Languages

Included languages:

• English
• German

Every player can select a language independently:

/grave language english
/grave language deutsch

Translated elements include menus, tooltips, XP information, restoration results, compass names and descriptions, navigation, access requests, protection messages and administrative confirmations.

Requirements

• Minecraft Java Edition 26.2
• Fabric Loader 0.19.5 or newer
• Fabric API 0.158.0+26.2 or newer
• Java 25 or newer

Installation

Dedicated Server

1. Install Fabric Loader for Minecraft 26.2.
2. Install the matching Fabric API version.
3. Place the Kronentroll's Graves JAR in the server's mods directory.
4. Start the server once.
5. Stop the server and review the generated configuration.
6. Start the server again.

Singleplayer

1. Install Fabric Loader for Minecraft 26.2.
2. Install the matching Fabric API version.
3. Place the mod JAR in the Minecraft mods directory.
4. Start the Fabric profile.
5. Back up important existing worlds before testing.

Updating

1. Stop the server completely.
2. Back up the world and configuration directory.
3. Replace the old mod JAR.
4. Start the server.
5. Review the log for migration or repair messages.

Complete Configuration

The configuration is generated at:

config/kronentrollsgraves.json

Complete default configuration:

{
  "configVersion": "2",
  "appearance": {
    "graveBlock": "minecraft:polished_blackstone_wall",
    "dropPlayerHead": true,
    "headCanDespawn": true,
    "removeGraveWhenEmpty": true
  },
  "storage": {
    "storeItems": true,
    "storeExactExperience": true,
    "keepOverflowInsideGrave": true,
    "useEmergencyVirtualGraves": true,
    "suppressNormalDropsAfterSaving": true,
    "saveBeforeRemovingPlayerItems": true,
    "maximumGravesPerPlayer": 0
  },
  "placement": {
    "initialHorizontalSearchRadius": 16,
    "initialVerticalSearchRadius": 16,
    "expandedHorizontalSearchRadius": 128,
    "expandedVerticalSearchRadius": 128,
    "maximumPlacementAttemptsPerTick": 512,
    "retryIntervalTicks": 20,
    "searchUntilSafePositionFound": true,
    "allowCrossChunkSearch": true,
    "loadRequiredChunks": true,
    "rescueFromLava": true,
    "rescueFromFire": true,
    "rescueFromVoid": true,
    "createVoidPlatform": true,
    "voidPlatformBlock": "minecraft:obsidian",
    "voidPlatformSize": 3
  },
  "protection": {
    "enabled": true,
    "protectWhileNotEmpty": true,
    "protectFromPlayers": true,
    "protectFromExplosions": true,
    "protectFromFire": true,
    "protectFromLava": true,
    "protectFromPistons": true,
    "protectFromWither": true,
    "protectFromEndermen": true,
    "protectFromFluids": true,
    "protectFromOtherMods": true,
    "preventBlockReplacement": true
  },
  "access": {
    "ownerCanOpen": true,
    "ownerCanBreak": true,
    "trustedPlayersCanOpen": true,
    "trustedPlayersCanBreak": true,
    "operatorsBypassProtection": false,
    "useLuckPerms": true,
    "administratorPermission": "kronentrollsgraves.admin",
    "allowIndividualGraveSharing": true,
    "allowPermanentSharing": false
  },
  "expiration": {
    "enabled": false,
    "expirationSeconds": 0,
    "publicAccessEnabled": false,
    "publicAccessAfterSeconds": 0
  },
  "messages": {
    "sendDeathCoordinates": true,
    "useClickableMessages": true,
    "showDimension": true,
    "showGraveNumber": true,
    "showRecoveryWarnings": true
  },
  "debug": {
    "enabled": false,
    "logPlacementSearch": false,
    "logProtectionDecisions": false,
    "logStorageOperations": false
  }
}

Configuration Reference

Appearance

• graveBlock: Grave carrier block identifier. Default: minecraft:polished_blackstone_wall.
• dropPlayerHead: Drops the player's head near a successfully placed grave.
• headCanDespawn: Allows the dropped head item to despawn normally.
• removeGraveWhenEmpty: Controls intended cleanup after all recoverable contents are removed.

Storage

• storeItems: Stores eligible inventory contents.
• storeExactExperience: Stores exact XP rather than an approximate level.
• keepOverflowInsideGrave: Keeps items that do not fit safely inside the grave.
• useEmergencyVirtualGraves: Preserves contents virtually if physical placement fails.
• suppressNormalDropsAfterSaving: Prevents successfully stored items from also dropping normally.
• saveBeforeRemovingPlayerItems: Saves the grave before captured contents are removed.
• maximumGravesPerPlayer: Maximum simultaneous physical, non-empty graves. 0 means unlimited. Additional graves remain virtual instead of being deleted.

Placement

• initialHorizontalSearchRadius: Horizontal radius for the first placement attempt.
• initialVerticalSearchRadius: Vertical radius for the first attempt.
• expandedHorizontalSearchRadius: Horizontal radius for later attempts.
• expandedVerticalSearchRadius: Vertical radius for later attempts.
• maximumPlacementAttemptsPerTick: Maximum candidate checks per placement attempt.
• retryIntervalTicks: Delay between retry checks. Normally 20 ticks are approximately one second.
• searchUntilSafePositionFound: Enables later attempts for eligible virtual graves.
• allowCrossChunkSearch: Configures cross-chunk placement searching.
• loadRequiredChunks: Configures the intended handling of required chunks.
• rescueFromLava: Enables special handling for lava deaths.
• rescueFromFire: Enables configured fire rescue behavior.
• rescueFromVoid: Enables special handling for void-like deaths.
• createVoidPlatform: Allows temporary emergency platforms.
• voidPlatformBlock: Configured emergency-platform block.
• voidPlatformSize: Odd platform width from 1 to 15; invalid values are corrected.

Suggested production settings for a larger server:

"maximumGravesPerPlayer": 5
"maximumPlacementAttemptsPerTick": 256
"retryIntervalTicks": 100

Protection

• enabled: Master protection switch.
• protectWhileNotEmpty: Keeps recoverable graves protected.
• protectFromPlayers: Prevents normal player destruction.
• protectFromExplosions: Protects recorded grave and platform blocks from explosions.
• protectFromFire: Removes supported nearby fire hazards.
• protectFromLava: Enables lava-related protection behavior.
• protectFromPistons: Prevents piston movement or destruction.
• protectFromWither: Intended Wither protection switch.
• protectFromEndermen: Intended Enderman protection switch.
• protectFromFluids: Intended fluid-change protection switch.
• protectFromOtherMods: Intended integration switch for compatible external systems.
• preventBlockReplacement: Protects recorded positions from supported replacement behavior.

Access

• ownerCanOpen: Allows owners to open their graves.
• ownerCanBreak: Configures intended owner breaking behavior.
• trustedPlayersCanOpen: Allows trusted players to open shared graves.
• trustedPlayersCanBreak: Configures intended trusted-player breaking behavior.
• operatorsBypassProtection: Enables configured operator bypass behavior.
• useLuckPerms: Enables permission-provider integration configuration.
• administratorPermission: Base administrative permission identifier.
• allowIndividualGraveSharing: Enables per-grave sharing.
• allowPermanentSharing: Controls permanent sharing behavior.

Expiration

• enabled: Enables expiration processing.
• expirationSeconds: Time before expiration state. 0 means no configured expiration.
• publicAccessEnabled: Allows delayed public access.
• publicAccessAfterSeconds: Delay before public access begins.

Useful values:

3600 = 1 hour
86400 = 1 day
604800 = 7 days
2592000 = 30 days

For safety, reaching expiration does not silently delete stored items.

Messages

• sendDeathCoordinates: Enables grave-coordinate information where supported.
• useClickableMessages: Enables clickable commands and coordinate copying.
• showDimension: Includes dimension information where supported.
• showGraveNumber: Includes owner-specific grave numbers.
• showRecoveryWarnings: Displays safety and recovery warnings.

Debug

• enabled: Master debug setting.
• logPlacementSearch: Adds placement-search logging where available.
• logProtectionDecisions: Logs selected protection decisions.
• logStorageOperations: Logs selected storage operations.

Debug logging should normally remain disabled on production servers.

Saved Data and Safety

Persistent grave data includes:

• Grave ID
• Owner UUID and name
• Owner-specific grave number
• Original death position
• Physical grave position
• Grave status
• Main inventory, armor and offhand item
• Exact experience
• Trusted players
• Public-access state
• Placement attempts
• Timing information

Emergency platforms are also tracked persistently.

Always create a world backup before updating, removing the mod, changing Minecraft versions or manually editing saved data.

Before permanently removing the mod:

1. Restore every grave.
2. Check player and administrative grave lists.
3. Confirm that no recoverable grave remains.
4. Stop the server.
5. Create a final backup.
6. Remove the mod.

Audit Log

Sensitive administrative operations may be written to:

logs/kronentrollsgraves-audit.log

Entries can include the timestamp, action, administrator, grave ID, owner, grave number, status, result and additional details.

Known Behavior

• Physical placement requires a safe available position.
• If no safe position exists, contents remain stored virtually.
• Later attempts use the expanded configured search area.
• Automatic retry processing is intentionally limited to control server load.
• Grave compasses require a physical grave position.
• Temporary-platform cleanup can be delayed while players remain nearby.
• Administrative removal of non-empty graves requires confirmation.
• The mod avoids replacing unrelated solid blocks.
• Keep Inventory prevents normal grave creation because inventory and XP already remain with the player.

Troubleshooting

A grave was stored virtually

No safe physical position was available. Check /grave list, return to the relevant area, review placement settings or ask an administrator to inspect or relocate the grave.

A grave compass disappeared

The associated grave no longer exists, no longer has a physical position, or the compass was an invalid duplicate.

Items remain inside the grave

The player's inventory lacks compatible space. Free slots and restore again.

A grave cannot be repaired automatically

The dimension or chunk may be unavailable, or an unrelated solid block may occupy the recorded position. Use administrative inspection, repair or relocation.

No grave was created with Keep Inventory enabled

This is expected. The player's items and experience already remain after death.

Reporting Issues

Please include:

1. Minecraft version
2. Fabric Loader version
3. Fabric API version
4. Kronentroll's Graves version
5. Java version
6. Singleplayer or dedicated server
7. Relevant configuration values
8. Exact reproduction steps
9. Relevant server-log excerpt
10. Whether the issue remains without unrelated mods

Remove private information such as IP addresses or authentication data before sharing logs.

Compatibility

The mod is designed for Fabric, multiplayer servers, singleplayer worlds, vanilla-style inventories and permission-controlled environments.

Compatibility with mods that replace death handling, inventory storage, block protection or experience behavior may vary. Using multiple grave mods at the same time is not recommended.

License

All Rights Reserved

You may download and use this mod for personal gameplay and on privately operated Minecraft servers.

You may not redistribute, re-upload, sell, modify and republish, or claim this mod or any part of it as your own without prior written permission from the copyright holder.

Inclusion in publicly distributed modpacks requires prior written permission unless explicitly stated otherwise.

This software is provided without warranty. The copyright holder is not responsible for data loss, world corruption, server downtime or other damages resulting from use of the software.

AI

AI helped me while building this project.