Lost Loot

Lost Loot is a vanilla-friendly Spigot plugin that allows you to trade for previously destroyed items.

Minecraft is one of the harshest games concerning inventory contents. It will genuinely delete your items with very little concern for backing them up or saving them. Sometimes when you die, your gear doesn’t just drop, it's destroyed. Maybe it falls into lava, gets blown up, despawns, or gets blasted into oblivion. Either way, the result is the same: your items are gone forever.

Lost Loot introduces a vanilla-friendly system for recovering gear that would normally be unrecoverable.

Instead of deleting items when they break, burn, or vanish, this plugin quietly stores them in a hidden Lost Loot inventory unique to each player.

🧳 Retrieving Your Lost Loot

You buy your lost items back from Wandering Traders.

When you interact with a Wandering Trader, Lost Loot temporarily adds special trades offering your lost items for emeralds. These trades are visible only to you, ensuring no one else can buy your items before you do.

How it works

• Each lost item appears as a custom trade.
• Prices are determined by:
  • Item rarity
  • Enchantments
  • Damage state
  • A balanced random price curve
• When the menu closes, the trader’s trades return to normal.
• Items you recover are removed from your Lost Loot pool.

This keeps the whole system optional, balanced, and immersive.

---

🔑 Key Features

💾 Automatic Lost-Item Tracking

Lost Loot intercepts items that would otherwise be destroyed, including:

• Durability-broken gear
• Items burned in lava or fire
• Items blown up by TNT or creepers
• Items that despawn
• Items removed when chunks unload
• Death drops that spawn in dangerous or inaccessible areas

If the item has value (enchantments, rarity, custom name), it is rescued instead of deleted.

🎁 Condensed & Organized Storage

Items are sorted into three rarity tiers:

• Uncommon
• Rare
• Epic

Each tier is automatically:

• Condensed (smart stacking)
• Saved per player in JSON
• Persisted across server restarts

✨ Smart Rarity Assignment

Items that don’t naturally have a rarity get one assigned dynamically if they are:

• Enchanted
• Custom-named
• Broken from durability

This ensures that important equipment is always recoverable, while trivial items are ignored.

🛠 Safe & Exploit-Resistant

Lost Loot includes strong protections:

• No duplication (trade caching + recipe validation)
• Restores original Wandering Trader trades upon closing
• Recognizes chunk unload to avoid false “loss” events
• Only stores destroyed items, never intentional drops

📚 Commands

/lostloot

• Operator-only
• Instantly returns all stored Lost Loot to the executing player
• Mainly for debugging, emergencies, or testing

💾 Persistent Per-Player Data

Every player has a dedicated file at: plugins/LostLoot/lostloot/<uuid>.json

Lost items survive:

• Restarts
• Crashes
• World reloads
• Player absence

Everything is completely automatic.