Kronentroll's Graves

Kronentroll's Graves

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

When a player dies, their inventory, armor, offhand items and experience are stored safely inside a grave. Players can recover individual items, restore everything at once, share access and use a grave compass to find their way back.

Server-Side Mod

Kronentroll's Graves runs on the server. Players do not need to install the mod on their clients and can join with a normal compatible client.

Fabric Loader and Fabric API are required on the server.

Features

Death and Storage

• Creates a grave only after Minecraft confirms the player's death
• Compatible with Totems of Undying
• Prevents duplicate death processing
• Stores the main inventory, hotbar, armor and offhand
• Stores exact experience points
• Saves grave data before removing captured items 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
• Supports virtual graves when no safe physical position is available
• Retries virtual-grave placement automatically
• Supports cross-chunk placement searches and configurable search limits

Grave Appearance

• Configurable grave carrier block
• Multipart gravestone display
• Player name and grave number display
• Optional player-head drop
• Player heads use the correct player name and skin
• Identical unchanged player profiles can stack correctly
• Empty gravestones and display entities are removed automatically

Recovery

• Right-click a grave to open its inventory
• Take individual items normally
• Use shift-click transfers
• Restore stored experience
• Use the emerald button for complete restoration
• Use supported sneak-right-click restoration
• Original inventory and hotbar slots are prioritized
• Items collected after death are moved to safe free slots whenever possible
• Existing unrelated items are never overwritten
• Contents that cannot be restored safely remain inside the grave
• The matching grave compass is removed before complete restoration
• If restoration is only partial, the matching compass is returned
• Compasses for other graves remain untouched

Automatic Grave Compasses

• Automatic compass delivery after respawn
• Separate compasses for multiple graves
• Compass recovery after reconnecting or restarting the server
• Compass delivery after later placement of a virtual grave
• Existing compasses can be updated
• Invalid compasses can be removed
• Duplicate compasses for the same grave can be removed
• No compass is dropped into the world when the inventory is full
• Full-inventory notifications are throttled
• Missing compasses can be requested manually
• Compasses point to the correct grave and dimension

Safe Placement and Emergency Platforms

• Searches for a safe physical grave position
• Expanded placement search for virtual graves
• Rescue behavior for lava, fire and void deaths
• Configurable temporary emergency platforms
• Configurable platform block and size
• Registered platform blocks cannot be collected
• Creative-mode breaking is prevented
• Platforms are protected from explosions and pistons
• Automatic cleanup replaces registered platform blocks directly with air
• Platform cleanup creates no block or experience drops
• Normal blocks of the same type outside registered platforms remain unaffected

Grave Protection

• Protects non-empty graves from normal player breaking
• Protects graves from explosions
• Protects graves from pistons
• Removes supported nearby fire hazards
• Repairs missing grave carrier blocks when safe
• Prevents supported replacement of protected grave positions
• Protects the supporting block directly below a physical grave
• Allows an already missing support block to be replaced
• Configurable solid-block placement protection near graves
• Container interaction remains available while holding a block
• Rejected placements synchronize block states and inventory immediately
• Prevents ghost blocks and incorrect stack counts
• Water buckets, flowing water and waterlogging are allowed by default
• Lava buckets and lava flow are blocked by default

Access and Administration

• Grave ownership checks
• Trusted-player access
• 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 with confirmation
• Administrative relocation with confirmation
• Administrative permanent removal with confirmation
• Administrative grave repair
• Permission overview command
• Administrative actions are audit logged

Languages and Messages

• English player messages
• German player messages
• Per-player language selection
• Optional death coordinates
• Optional clickable messages
• Optional dimension display
• Optional grave-number display
• Optional recovery warnings

Audit Logging

• Administrative inspection and actions
• Normal item removal
• Shift-click transfers
• Main-inventory, armor and offhand transfers
• Acting player name and UUID
• Grave ID and owner
• Item identifier and transferred amount
• Remaining item count
• Remaining stack count
• Remaining experience
• Privacy-conscious logging without complete book pages, container contents or unrestricted components
• Global audit switch
• Automatic rotation at 10 MiB
• Previous audit file retained as kronentrollsgraves-audit.log.1

Configuration

The configuration uses JSON5:

config/kronentrollsgraves.json5

An existing config/kronentrollsgraves.json file is detected and migrated automatically. Existing values are preserved. JSON5 comments are supported.

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

Complete Default Configuration

The generated file also contains explanatory description fields. The block below lists every functional option and its default value.

{
  configVersion: "3",

  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,
    allowIndividualGraveSharing: true,
    allowPermanentSharing: false
  },

  expiration: {
    enabled: false,
    expirationSeconds: 0,
    publicAccessEnabled: false,
    publicAccessAfterSeconds: 0
  },

  messages: {
    sendDeathCoordinates: true,
    useClickableMessages: true,
    showDimension: true,
    showGraveNumber: true,
    showRecoveryWarnings: true
  },

  compass: {
    giveAutomatically: true,
    giveAfterVirtualPlacement: true,
    updateExisting: true,
    removeInvalidCompasses: true,
    removeDuplicateCompasses: true,
    notifyWhenInventoryIsFull: true
  },

  nearbyPlacementProtection: {
    enabled: true,
    horizontalRadius: 1,
    verticalRadius: 1,
    allowWater: true,
    allowLava: false,
    operatorsBypass: false
  },

  audit: {
    enabled: true,
    logItemTransfers: true
  },

  debug: {
    enabled: false,
    logPlacementSearch: false,
    logProtectionDecisions: false,
    logStorageOperations: false
  }
}

Configuration Notes

• maximumGravesPerPlayer: 0 means unlimited.
• Search radii and platform size are validated when the configuration loads.
• allowWater controls water-bucket placement and water flow near graves.
• allowLava controls lava-bucket placement and lava flow near graves.
• Waterlogging remains supported with the default settings.
• operatorsBypass controls bypass for nearby placement protection.
• operatorsBypassProtection controls administrative grave-protection bypass behavior.
• audit.enabled disables or enables audit output globally.
• Detailed debug logging is disabled by default.
• Some compatibility switches are reserved for direct or future integrations. The generated descriptions identify options that are not fully implemented as universal hooks.

Commands

Arguments in angle brackets are required. Grave numbers are the numbers 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 detailed information about one of your graves.
• /grave locate <number> — Show navigation information for one of your graves.
• /grave compass <number> — Create or update a compass for one of your physical graves.
• /grave language — Show the current language and available language options.
• /grave language <language> — Change the personal language, for example english or deutsch.
• /grave requests — List pending grave-access requests.
• /grave request accept <requestId> — Accept a pending access request.
• /grave request deny <requestId> — Deny a pending access request.
• /grave untrust <graveNumber> <player> — Remove a player's access to one of your graves.

Internal Clickable Access Commands

These commands are used by clickable chat actions and can also be entered manually when the required UUID is known.

• /graveaccessrequest send <graveId> — Send an access request for a grave.
• /graveaccessrequest accept <requestId> — Accept an access request.
• /graveaccessrequest deny <requestId> — Deny an access request.

Administrative Commands

Administrative commands require the corresponding operator or permission access.

• /graveadmin — Show the administrative command overview.
• /graveadmin list — List all saved graves.
• /graveadmin info <graveId> — Show detailed information about a grave.
• /graveadmin permissions — Show the administrative permission overview.
• /graveadmin restore <graveId> <targetPlayer> — Prepare restoration of a grave to a target player.
• /graveadmin confirm <confirmationId> — Confirm a prepared administrative restoration.
• /graveadmin cancel <confirmationId> — Cancel a prepared administrative restoration.
• /graveadmin relocate <graveId> — Prepare relocation of a grave to the administrator's position.
• /graveadmin remove <graveId> — Prepare permanent removal of a grave.
• /graveadmin repair — Scan and repair eligible grave and emergency-platform data.
• /graveadmin repair <graveId> — Repair one specific grave.

Administrative Confirmation Commands

These are generated as clickable confirmation actions after preparing a relocation or removal.

• /graveadminrelocate confirm <confirmationId> — Confirm a prepared relocation.
• /graveadminrelocate cancel <confirmationId> — Cancel a prepared relocation.
• /graveadminremove confirm <confirmationId> — Confirm a prepared permanent removal.
• /graveadminremove cancel <confirmationId> — Cancel a prepared permanent removal.

Interaction Guide

• Right-click your grave to open it.
• Take items normally or with shift-click.
• Use the experience control to recover stored experience.
• Use the emerald control to restore everything that fits safely.
• Administrators can use the supported sneak interaction for read-only inspection.
• Access-request prompts provide clickable accept and deny actions.
• Grave compasses identify the grave number, dimension and coordinates.

Requirements

Server

• 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

Client

No client-side installation is required.

LuckPerms integration is optional.

Installation

1. Install Fabric Loader and Fabric API on the server.
2. Stop the server and create a backup.
3. Remove the previous Kronentroll's Graves JAR when updating.
4. Place the new JAR in the server's mods directory.
5. Start the server.
6. Review config/kronentrollsgraves.json5.
7. 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 not overwritten.
• Contents that cannot be restored safely remain in the grave.
• Registered emergency-platform blocks are removed without drops.
• Normal Obsidian outside registered emergency platforms is unaffected.
• Back up the world and configuration before every update.

License

All Rights Reserved.

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.