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.

--- []() []() []() []()

---

---

✨ 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:

- Back button for each death — skinned to the dead player - Back button at a glance: - 🔴 Red title → killed by a player - 🟡 Gold title → killed by a mob - 🟢 Green title → environment / fall / fire / etc. - Back button showing killer, item count, XP lost, and death message — without opening the entry - Back button — browse any number of deaths across multiple pages - Back button — 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 both online players and offline players - 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 - asynchronously for player kills, asynchronously 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 non-empty slots 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 ```

---

📋 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*