DeathInventoryTracker

# ☠ 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. --- (https://img.shields.io/badge/version-1.0.0-blue)]() (https://img.shields.io/badge/Paper-1.21.x-orange)]() (https://img.shields.io/badge/Discord-Webhook-purple)]() (https://img.shields.io/badge/downloads-1+-green)]() --- <p align="center"> <img src="https://cdn.modrinth.com/data/cached_images/2444df5554290a044a50a3389cd051805cdda729_0.webp" alt="DeathInventoryTracker" width="600"/> <br/> <em></em> </p> --- ## ✨ 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 ` | 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 ```yaml # 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 ``` --- ## 📋 Requir