Recover your Despawned Items or Items Lost to the End Void

This mod is designed to cure two of Minecraft's ultimate frustrations:

• Dying and losing hard-earned items when they despawn before you can reach them
• Dying in the Void with absolutely zero chance to recover it

With the White Hole Altar and Cosmic Eye, you can recover despawned items after dying and your lost inventory after falling into the Void.

Not literally a white hole physics object. Instead, it taps into an invisible cosmic force that expels what time or the Void has swallowed.

🟥 The Frustration of Vanilla Minecraft

• The Brutal Despawn Timer: You die far from spawn or deep in a treacherous cave. You sprint and navigate back to your death point as fast as humanly possible, but your items have already despawned and literally gone forever.
• The End Void: You slip while bridging across The End, and your hard-earned gear lost into the void with zero chance of recovery.

Vanilla Minecraft offers no second chances when time runs out or the void takes your loot. White Hole gives you a lore-friendly way to get it back.

🟩 The Solution: The White Hole Altar

This mod introduces a high-risk, high-reward mechanic that allows you to recover items from most recent despawned items after dying, and recent death into the Void.

• The White Hole Altar: A mysterious structure naturally generated at the center of Ancient Cities in the Overworld.
• The Cosmic Eye: A rare artifact to open the white hole hidden in Ancient City chests

🔎 Finding the Cosmic Eye

The Cosmic Eye can be found naturally in Ancient City chests, with a rarity comparable to an Enchanted Golden Apple.

Crafting the Cosmic Eye

❓ Frequently Asked Questions (FAQ)

Q: Can this mod recover items that I lost BEFORE installing it?
A: No. The mod can only track and save your inventory data for deaths that occur after the mod has been successfully installed and activated.

Q: Why are my items not recorded immediately if I die very far away?
A: The mod only records items when they actually despawn. The vanilla despawn timer depends on the player's simulation distance, chunks that are too far away will freeze. The mod will only record and save your items once you return to the death location and the despawn timer finishes counting down.

Q: Is this mod multiplayer-friendly?
A: Yes, but currently the mod must be installed on both the server and the client. Standalone server-side support (via Polymer) is in active development.

Q: What happens if I die multiple times before visiting the Altar?
A: The mod stores up to maxSavedItemSnapshots (3 by default) in history. This means the white hole will save your full inventory for the maximum 3 snapshots of death.

Q: Does this save items that I drop manually with 'Q' (default drop key)?
A: No. The despawn tracker specifically tags items dropped upon a player's death. Normal manual drops, thrown items, and automated farm drops will despawn naturally without being saved.

ℹ️ Future Updates

• Polymer Integration: Enable multiplayer servers to use the mod without requiring every player to install it on their client.
• Snapshot Selection Menu: Allow players to view and select which specific death snapshot they want to restore, instead of automatically recovering only the latest one.
• In-Game Configuration UI: Adding a config screen using cloth_config_api for both Fabric and NeoForge.
• Command: /wh reload command to reload configuration directly

⚙️ Default Configuration

minecraft/config/whitehole.json

{
  "voidRecovery": {
    "overworld": false,
    "nether": false,
    "end": true,
    "maxSnapshots": 3
  },
  "despawnRecovery": {
    "enabled": true,
    "maxSnapshots": 3
  },
  "altarCooldown": false,
  "defaultAltarCooldown": 1200
}

voidRecovery: per-dimension toggles for capturing your inventory when you die by falling out of the world. Defaults to The End only, since void deaths elsewhere are rare — server owners can enable the other dimensions if their playerbase wants that extra safety net.

despawnRecovery: universal safety net for items dropped on any death that nobody retrieves before they'd naturally despawn. Items still drop and can be looted normally in the meantime by anyone nearby — only items that would otherwise be lost to despawn are captured, regardless of how long your server is configured to keep items on the ground.

maxSavedItemSnapshots: determines how many full player-inventory snapshots can be saved by the White Hole.

defaultAltarCooldown: determines the default cooldown duration for the Altar.

Upgrading from an older version? If your existing whitehole.json still uses the old flat keys (recoverItemsFromEndVoid, etc.), it will be automatically migrated into the nested shape above the first time the server loads — your existing settings are preserved.