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