☠ DeathInventoryTracker

Never lose track of what you lost — ever again.

DeathInventoryTracker is a powerful PaperMC plugin that saves a complete snapshot of every player death — inventory, armor, offhand, XP, killer info, and death message and lets admins browse, inspect, and restore them through a clean in-game GUI. Full offline player support, Discord notifications, and tab completion included.

---

---

---

✨ Features

📦 Complete Death Snapshots

Every death is recorded with:

• Full inventory contents (all 36 slots — hotbar + storage)
• Armor slots (boots, leggings, chestplate, helmet)
• Offhand item
• XP at time of death
• Killer name & type (Player / Mob / Environment)
• Death message
• Timestamp

All item data is preserved with full fidelity enchantments, durability, custom names, lore, and NBT all survive the round-trip.

---

🖥 In-Game GUI Browser

Open any player's death history in a clean 54-slot chest GUI:

• Player head icons for each death — skinned to the dead player
• Color-coded entries at a glance:
  • 🔴 Red title → killed by a player
  • 🟡 Gold title → killed by a mob
  • 🟢 Green title → environment / fall / fire / etc.
• Lore preview showing killer, item count, XP lost, and death message — without opening the entry
• Pagination — browse any number of deaths across multiple pages
• Filter buttons — switch between All Deaths, Player Kills, and Natural Deaths instantly
• Back button — return to the list from a death detail view without retyping commands

Death Detail Viewer

Click any entry to open a full 54-slot detail view showing:

• All 36 inventory items in their original slots
• Armor (slots 36–39)
• Offhand item (slot 40)
• Info book with full death metadata
• Restore button — sends all items + XP directly to the dead player (must be online)

---

🔄 Smart Inventory Restore

• Restore goes to the player who died, not whoever is viewing the GUI
• Admin gets a confirmation message; the recipient gets a notification telling them who restored it
• If the player is offline, restore is blocked with a clear error message

---

👤 Full Offline Player Support

• Deaths are stored in JSON files per player (PlayerName_uuid.json)
• Browse and inspect any player's deaths even when they're offline
• Tab completion shows both online players and offline players who have stored death records

---

⌨ Commands

Command	Description	Permission
/deathinv	Open your own death browser	deathinv.view.self
/deathinv view <player>	Browse a player's deaths	deathinv.view.others
/deathinv latest <player>	Show the most recent death details	deathinv.view.others
/deathinv list <player>	List last 10 deaths	deathinv.view.others
/deathinv reload	Reload config and all data	deathinv.admin
/deathinv cleanup [days]	Delete records older than N days	deathinv.admin

All commands work from the server console with formatted plain-text output.

---

🔐 Permissions

Permission	Default	Description
deathinv.view.self	Everyone	Open your own death inventory
deathinv.view.others	OP	View another player's deaths
deathinv.admin	OP	Reload, cleanup

---

🔔 Discord Integration

Get notified in Discord every time a player dies:

• Embedded message with player name, killer, death message, item count, valuable items, XP lost, and timestamp
• Red embed for player kills, orange for natural deaths
• Webhook sending runs asynchronously — zero server tick impact
• Enable/disable and set the webhook URL in config.yml

---

🗂 Data Storage

Deaths are saved as compact JSON files in plugins/DeathInventoryTracker/deaths/:

• One file per player, named PlayerName_uuid.json
• Only non-empty slots are stored — no wasted null entries
• Items serialized with Bukkit's native serialization (Base64) preserving all metadata
• Human-readable slot map format: { "0": "<base64>", "7": "<base64>" }
• Auto-loaded on startup, saved immediately on each death
• Corrupted files are skipped with a console warning — they won't crash the server

---

⚙ Configuration

# Discord Integration
discord:
  enabled: false
  webhook-url: "https://discord.com/api/webhooks/YOUR_ID/TOKEN"

# General Settings
settings:
  auto-cleanup-days: 30   # delete deaths older than N days (0 = never)
  log-deaths: true        # log each death to console

---

📋 Requirements

Requirement	Version
Server software	PaperMC
Minecraft	1.20.4+
Java	17+

This plugin uses Paper-specific APIs and will not work on Spigot or CraftBukkit.

---

🛠 Installation

1. Download the .jar file
2. Place it in your server's plugins/ folder
3. Restart the server
4. Edit plugins/DeathInventoryTracker/config.yml as needed
5. Use /deathinv reload to apply config changes without restarting

---

Made by rradajbi