☠ 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.

DeathInventoryTracker

✨ 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: "" rel="noopener nofollow" target="_blank">https://discord.com/api/webhooks/YOUR_ID/TOKEN&quot;

# 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

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

Made by rradajbi