DeathLog_By_FeDen

DeathLog - Death History & Item Recovery

Lightweight death history and item recovery plugin for Paper/Spigot servers.

DeathLog is a lightweight admin plugin for Paper/Spigot that stores player death history, displays lost items through a convenient GUI, and allows staff to safely restore lost items.

---

---

✨ Features

- Logs player deaths using `PlayerDeathEvent` - Death history GUI - View lost items for each death - Full `ItemStack` saving: - meta - NBT - enchantments - lore - custom item data - Saves: - world - coordinates - death time - Detects: - death cause - killer - player / mob / projectile - Teleport staff to death locations - Restore items directly through GUI - Inventory free-space check before restore - One-time restore protection - Logs the administrator who restored items - Removes tracked world drops after restore - Removes items from players who picked up someone else's death loot - Removes equipped stolen items from: - armor slots - offhand - Removes placed blocks created from death loot - Attempts block rollback at death location - Configurable death limit per player with FIFO cleanup - Player opt-out system for death saving - EN/RU language support - Configurable prefix and core settings

---

📜 Commands

```bash /deathlog ```

Open your death history.

```bash /deathlog <player> ```

Open another player's death history.

```bash /deathlog clear ```

Clear your death history.

```bash /deathlog clear <player> ```

Clear another player's death history.

```bash /deathlog nosave <deathId> ```

Used by the opt-out button to remove a saved death.

---

🔑 Permissions

By default, only OP has access.

```txt deathlog.view ```

Access your own history.

```txt deathlog.others ```

View and manage other players' histories.

```txt deathlog.restore ```

Restore items.

---

♻️ Restore

Before Restore

- Player must be online - Free inventory space is checked - Death must not already be restored

After Restore

- Items are returned to the dead player - Armor is restored to armor slots if available - Offhand items are restored to the offhand slot if free - Inventory items return to original slots if available - Occupied slots fallback to free inventory space - Tracked drops are removed from the world - Picked-up items are removed from other players - Equipped stolen items are removed from: - inventory - armor - offhand - Blocks placed from death loot are removed - Restore administrator is logged

---

💀 Death Saving

After death, the player receives a chat message:

```txt Death info saved for staff. [Do not save] ```

Behavior

- If the player does nothing: - the death remains saved for staff - If the player clicks:

```txt [Do not save] ```

the death record is deleted and hidden from staff.

---

⚙️ Config

File:

```txt plugins/DeathLog/config.yml ```

```yml language: "en" prefix: "&8[&cDeathLog&8] &7"

storage: max_deaths_per_player: 10 date_format: "dd.MM.yyyy HH:mm:ss" auto_save_on_death: true allow_player_opt_out: true

restore: require_player_online: true check_inventory_space: true one_time_restore: true remove_world_drops: true remove_picked_items: true remove_picked_items_on_join: true remove_placed_blocks: true block_rollback: true notify_target: true

tracking: dropped_item_search_radius: 4.0 track_picked_items: true track_placed_blocks: true

gui: history_size: 54 details_size: 54 teleport_slot: 45 restore_slot: 49 back_slot: 53 ```

---

🌍 Languages

Default language:

```txt English ```

Available Languages

```txt en — English ru — Русский ```

Language Files

```txt plugins/DeathLog/lang/en.yml plugins/DeathLog/lang/ru.yml ```

Russian Language

```yml language: "ru" ```

After changing the language, restart the server.

---

💾 Storage

All deaths are stored in:

```txt plugins/DeathLog/deaths.yml ```

Saved Data

- Player UUID and nickname - Death time - World and coordinates - Yaw/Pitch - Death cause - Killer - Lost items - Original item slots - Tracked drop UUIDs - Players who picked up items - Blocks placed using death loot - Restore status - Restore administrator and timestamp

---

📦 Installation

1. Download

```txt DeathLog.jar ```

2. Move

Place the jar into:

```txt plugins/ ```

3. Restart

Start or restart your server.

4. Configure

Edit:

```txt plugins/DeathLog/config.yml ```

5. Language

```yml language: "ru" ```

---

🧩 Compatibility

```txt Minecraft: 1.20+ / 1.21+ Platform: Paper / Spigot Java: 17+ ```

---

🎯 Use Cases

DeathLog is useful for:

- Survival servers - Grief-control systems - Staff utility servers - Hardcore gameplay - Administrative moderation - Any server where staff need fast and safe item recovery tools

---

❤️ DeathLog

Simple. Safe. Staff-friendly death recovery.