promotional bannermobile promotional banner
premium banner

DeathRecovery

Died in a cave and lost everything? This plugin saves your death locations with full history and sharing controls.

Description

💀 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