DeathRecovery

💀 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