💀 Death Recovery - Never Lose Your Items Again

The Problem

You died in a deep cave. Your items scattered everywhere. The map shows a death marker, but no coordinates.

You know roughly where you died, but finding the exact spot? Good luck.

The Solution

Death Recovery is a professional server-side plugin that automatically tracks every death with precision:

✅ Complete death history - Last 5 deaths saved per player
✅ Exact coordinates - World name, X/Y/Z position, timestamp
✅ Death cause tracking - Know what killed you (fall, mobs, lava, etc.)
✅ Privacy controls - Share with everyone, whitelist only, or keep private
✅ Admin tools - Server admins can view any player's deaths
✅ Persistent storage - Data survives server restarts with automatic backups
✅ Anti-duplicate protection - Smart cooldown system prevents double-logging

🎮 Features

Core Functionality

Automatic death logging - No setup required, works instantly
5-death history - FIFO queue, oldest death removed when limit reached
Rich death data - Coordinates, world, timestamp, and cause of death
Chat notifications - Instant feedback when you die with coordinates
Persistent JSON storage - Atomic saves with automatic .bak recovery

Privacy & Sharing

3-tier privacy system:
- 🔒 Private (default) - Only you can see your deaths
- 🌐 Public - Anyone can view your death locations
- 👥 Whitelist - Share only with specific friends
Admin override - deathloc.admin permission bypasses privacy

Server-Ready

Debounced saves - Optimized for performance
Cooldown protection - Prevents duplicate death entries
Corruption recovery - Auto-backup system if JSON fails
Permission system - Integrates with server permission plugins

🎯 Commands

Basic Commands

Command	Alias	Description
`/lastdeath [player]`	`/deathloc`	Show last death location (yours or another player's)
`/deaths [count]`	-	List your death history (up to 5)
`/deathclear`	-	Clear your entire death history

Examples:

/lastdeath
→ Your last death: overworld (245, 64, -892) - Fall damage

/deaths 3
→ Shows your last 3 deaths with timestamps

/lastdeath Steve
→ View Steve's last death (if he shared it with you)

Privacy Management

Command	Description
`/deathshare on`	Enable sharing your death locations
`/deathshare off`	Disable sharing (default)
`/deathshare add <player>`	Add player to your whitelist
`/deathshare remove <player>`	Remove player from whitelist
`/deathshare list`	Show your current whitelist

Privacy Logic:

🔒 Sharing OFF → Nobody can see your deaths (except admins with permission)
🌐 Sharing ON + empty whitelist → Everyone can see your deaths
👥 Sharing ON + whitelist → Only whitelisted players can see your deaths

Examples:

/deathshare on
→ Death locations now visible to everyone

/deathshare add Steve
/deathshare add Alex
→ Only Steve and Alex can see your deaths (public sharing disabled)

/deathshare list
→ Whitelist: Steve, Alex

⚙️ Configuration

Default settings work for most servers, but you can customize by editing DeathSettings.java:

Setting	Default	Description
`MAX_DEATHS_PER_PLAYER`	`5`	Number of deaths saved per player
`SAVE_DEBOUNCE_MS`	`1500ms`	Delay before writing to disk
`DEATH_COOLDOWN_MS`	`2000ms`	Cooldown between death logs
`SHOW_TITLE_ON_DEATH`	`false`	Show title overlay on death
`SHARE_DEFAULT_ENABLED`	`false`	Default sharing state for new players

🛡️ Permissions

Permission	Description
`deathloc.admin`	View any player's death locations (bypasses privacy)

Default: All players can use basic commands. Only admins with deathloc.admin can bypass privacy settings.

📁 Data Storage

Files created:

deaths.json - Main data file (in plugin data folder)
deaths.json.bak - Automatic backup if corruption detected

Persistence features:

Atomic writes (write to .tmp → rename to .json)
Automatic corruption recovery
Debounced saves for performance
Snapshot-based serialization (thread-safe)

🎓 Use Cases

For Players:

Recover your items after an unexpected death
Learn from your deaths (see what killed you most)
Share challenging death locations with friends

For Server Admins:

Help players recover from griefing/bugs
Track problematic death locations (common death traps)
Moderate disputes about death circumstances
Server diagnostics and balancing

For PvP/Hardcore Servers:

Public death tracking creates high stakes
Whitelist system for team-based gameplay
Admin oversight for fair play enforcement

🐛 Troubleshooting

Death not saving?

Check cooldown (2 seconds between deaths by default)
Verify server logs for errors

Can't see another player's death?

Ask them to run /deathshare on
Check if you're on their whitelist with /deathshare list
Admins: verify you have deathloc.admin permission

JSON file corrupted?

Plugin auto-creates .bak backup
Server restarts cleanly even with corrupted file

📋 Requirements

Hytale Server (Early Access or later)
Java 17+ (required by Hytale)
Server-side only - No client installation needed

🤝 Support & Feedback

🐛 Report bugs: GitHub Issues
💡 Feature requests: GitHub or CurseForge comments
⭐ Enjoying the plugin? Leave a review and star on GitHub!

📜 License

Open source - check GitHub repository for details.

Made with ❤️ by SmugTox

DeathRecovery