DeathRecovery

💀 Recuperación de Muertes – Nunca Pierdas Tus Objetos de Nuevo

El Problema

Has muerto en una cueva profunda. Tus objetos están esparcidos por todas partes. El mapa muestra un marcador de muerte, pero sin coordenadas.

Sabes más o menos dónde has muerto, pero encontrar el lugar exacto? Buena suerte.

La Solución

La Recuperación de Muertes es un plugin profesional del lado del servidor que rastrea automáticamente cada muerte con precisión:

• ✅ Historia completa de muertes – Últimas 5 muertes guardadas por jugador
• ✅ Coordenadas exactas – Nombre del mundo, posición X/Y/Z, marca de tiempo
• ✅ Seguimiento de la causa de la muerte – Sabe qué te mató (caída, criaturas, lava, etc.)
• ✅ Controles de privacidad – Comparte con todos, solo lista blanca, o mantén privado
• ✅ Herramientas de administrador – Los administradores del servidor pueden ver las muertes de cualquier jugador
• ✅ Almacenamiento persistente – Los datos sobreviven a los reinicios del servidor con copias de seguridad automáticas
• ✅ Protección contra duplicados – Un sistema de enfriamiento inteligente previene el registro doble

🎮 Características

Funcionalidad Principal

• Registro automático de muertes – No se requiere configuración, funciona al instante
• Historia de 5 muertes – Cola FIFO, la muerte más antigua se elimina cuando se alcanza el límite
• Datos ricos sobre muertes – Coordenadas, mundo, marca de tiempo y causa de muerte
• Notificaciones en el chat – Retroalimentación instantánea cuando mueres con coordenadas
• Almacenamiento JSON persistente – Guardados atómicos con recuperación automática .bak

Privacidad y Compartición

• Sistema de privacidad de 3 niveles:
  • 🔒 Privado (predeterminado) – Solo tú puedes ver tus muertes
  • 🌐 Público – Cualquiera puede ver tus ubicaciones de muerte
  • 👥 Lista blanca – Comparte solo con amigos específicos
• Anulación de administrador – El permiso deathloc.admin ignora la privacidad

Listo para el Servidor

• Guardados con debounce – Optimizado para rendimiento
• Protección contra enfriamiento – Previene entradas duplicadas de muertes
• Recuperación de corrupción – Sistema de copias de seguridad automáticas si falla el JSON
• Sistema de permisos – Se integra con plugins de permisos del servidor

🎯 Comandos

Comandos Básicos

Comando	Alias	Descripción
/lastdeath [jugador]	/deathloc	Muestra la última ubicación de muerte (la tuya o la de otro jugador)
/deaths [cantidad]	–	Lista tu historial de muertes (hasta 5)
/deathclear	–	Elimina todo tu historial de muertes

Ejemplos:

/lastdeath
→ Tu última muerte: mundo (245, 64, -892) - Daño por caída

/deaths 3
→ Muestra tus últimas 3 muertes con marcas de tiempo

/lastdeath Steve
→ Ver la última muerte de Steve (si él la compartió contigo)

Gestión de Privacidad

Comando	Descripción
/deathshare on	Habilitar compartir tus ubicaciones de muerte
/deathshare off	Deshabilitar compartir (predeterminado)
/deathshare add <jugador>	Agregar jugador a tu lista blanca
/deathshare remove <jugador>	Eliminar jugador de la lista blanca
/deathshare list	Muestra tu lista blanca actual

Lógica de Privacidad:

• 🔒 Compartir DESACTIVADO → Nadie puede ver tus muertes (excepto administradores con permiso)
• 🌐 Compartir ACTIVADO + lista blanca vacía → Todos pueden ver tus muertes
• 👥 Compartir ACTIVADO + lista blanca → Solo los jugadores en la lista blanca pueden ver tus muertes

Ejemplos:

/deathshare on
→ Las ubicaciones de muerte ahora son visibles para todos

/deathshare add Steve
/deathshare add Alex
→ Solo Steve y Alex pueden ver tus muertes (compartición pública desactivada)

/deathshare list
→ Lista blanca: Steve, Alex

⚙️ Configuración

La configuración predeterminada funciona para la mayoría de los servidores, pero puedes personalizar editando DeathSettings.java:

Configuración	Predeterminado	Descripción
MAX_DEATHS_PER_PLAYER	5	Número de muertes guardadas por jugador
SAVE_DEBOUNCE_MS	1500ms	Retraso antes de escribir en disco
DEATH_COOLDOWN_MS	2000ms	Tiempo de enfriamiento entre registros de muerte
SHOW_TITLE_ON_DEATH	false	Mostrar superposición de título en la muerte
SHARE_DEFAULT_ENABLED	false	Estado de compartición predeterminado para nuevos jugadores

🛡️ Permisos

Permiso	Descripción
deathloc.admin	Ver las ubicaciones de muerte de cualquier jugador (ignora la privacidad)

Predeterminado: Todos los jugadores pueden usar comandos básicos. Solo los administradores con deathloc.admin pueden ignorar las configuraciones de privacidad.

📁 Almacenamiento de Datos

Archivos creados:

• deaths.json – Archivo de datos principal (en la carpeta de datos del plugin)
• deaths.json.bak – Copia de seguridad automática si se detecta corrupción

Características de persistencia:

• Escrituras atómicas (escribir en .tmp → renombrar a .json)
• Recuperación automática de corrupción
• Guardados con debounce para rendimiento
• Serialización basada en instantáneas (segura para hilos)

🎓 Casos de Uso

Para Jugadores:

• Recupera tus objetos después de una muerte inesperada
• Aprende de tus muertes (ve qué te mató más)
• Comparte ubicaciones desafiantes de muerte con amigos

Para Administradores de Servidor:

• Ayuda a los jugadores a recuperarse de griefing/bugs
• Rastrea ubicaciones problemáticas de muerte (trampas de muerte comunes)
• Modera disputas sobre las circunstancias de la muerte
• Diagnósticos y equilibrio del servidor

Para Servidores PvP/Hardcore:

• El seguimiento público de muertes crea altas apuestas
• Sistema de lista blanca para juego en equipo
• Supervisión de administradores para hacer cumplir el juego limpio

🐛 Solución de Problemas

¿La muerte no se guarda?

• Verifica el tiempo de enfriamiento (2 segundos entre muertes por defecto)
• Verifica los registros del servidor en busca de errores

¿No puedes ver la muerte de otro jugador?

• Pídeles que ejecuten /deathshare on
• Verifica si estás en su lista blanca con /deathshare list
• Administradores: verifica que tengas el permiso deathloc.admin

¿El archivo JSON está dañado?

• El plugin crea automáticamente una copia de seguridad .bak
• El servidor se reinicia correctamente incluso con un archivo dañado

📋 Requisitos

• Servidor Hytale (Acceso anticipado o posterior)
• Java 17+ (requerido por Hytale)
• Solo del lado del servidor – No se necesita instalación del cliente

🤝 Soporte y Comentarios

• 🐛 Reportar errores: Problemas en GitHub
• 💡 Solicitudes de características: Comentarios en GitHub o CurseForge
• ⭐ ¿Disfrutando del plugin? ¡Deja una reseña y una estrella en GitHub!

📜 Licencia

Código abierto – consulta el repositorio de GitHub para más detalles.

Hecho con ❤️ por SmugTox