LSurvivalCore 0.2.9

LSurvivalCore 0.2.9

LSurvivalCore (OpenMod)

Núcleo base para servidor LSurvival en Unturned con OpenMod. Incluye utilidades de supervivencia: sistema TPA, retorno a cama (/home), etiquetado de combate y persistencia JSON.

Versión del paquete: {{Version}}

Instalación rápida

openmod install LSurvivalCore
openmod reload

Características principales

• Prefijo configurable para mensajes.
• Sistema TPA completo:
• /tpa <jugador>: Solicita ir hacia el jugador objetivo.
• /tpahere <jugador>: Solicita que el jugador venga hacia ti.
• /tpaccept: Acepta la solicitud pendiente.
• /tpdeny: Rechaza la solicitud pendiente.
• /tpcancel: Cancela tu solicitud enviada.
• Tiempo de expiración de solicitudes, warmup y cooldown configurables.
• Home a cama reclamada:
• /home: Teletransporta a la cama reclamada con persistencia JSON.
• Warmup y cooldown configurables.
• Validación de combate para evitar abusos.
• Etiquetado de combate:
• Marcado por daño (listeners en preparación) con duración configurable.
• Cancelación de warmups cuando el jugador entra en combate.
• Persistencia JSON para “home”: almacena posición, yaw y referencias básicas de cama.
• Panel de diagnóstico para consola (diag ...): inspección de camas, TPA y combate, simulaciones y resync.
• Estadísticas de kills/deaths administradas via consola (statsctl ...) con persistencia JSON y rangos canónicos/display.

Comandos

• /ls: Verifica el estado del plugin.
• /tpa <jugador>: Pide teletransportarte hacia el jugador.
• /tpahere <jugador>: Pide que el jugador venga hacia ti.
• /tpaccept: Acepta la solicitud TPA pendiente.
• /tpdeny: Rechaza la solicitud TPA pendiente.
• /tpcancel: Cancela tu propia solicitud TPA.
• /home: Te lleva a tu cama reclamada.

Consola (solo administrador)

• diag beds scan|show: sincroniza y revisa camas persistidas.
• diag combat tag|clear: fuerza o limpia combat tag.
• diag tpa simulate: recorre el flujo completo de TPA en modo simulado.
• statsctl show <steam64>: muestra kills/deaths, rank canónico/display y faltantes para Leyenda.
• statsctl addkills <steam64> <n>: suma kills y recalcula rank.
• statsctl setkills <steam64> <n>: fija kills y rank.
• statsctl top [n]: lista el top global (por defecto TopDefault).

Configuración (appsettings.json)

Sección LSurvivalCore:

{
"LSurvivalCore": {
"Prefix": "&7[&aLSurvival&7] ",
"Home": {
"Enabled": true,
"RequireClaimedBed": true,
"BindToBed": true,
"WarmupSeconds": 5,
"CooldownSeconds": 30,
"BlockInCombat": true,
"BedProximityMetersForClaimScan": 2.5,
"OnMissingBed": "Block",
"DataPath": "data"
},
"TPA": {
"Enabled": true,
"RequestTimeoutSeconds": 60,
"WarmupSeconds": 5,
"CooldownSeconds": 30,
"BlockInCombat": true
},
"Combat": {
"TagSeconds": 15,
"DamageResetsTimer": true
},
"Stats": {
"DataPath": "OpenMod/plugins/LSurvivalCore/data/stats.json",
"TopDefault": 5
}
}
}

Permisos (propuestos)

Nota: La capa de permisos real de OpenMod se integrará en próximas versiones; por ahora los checks están estructurados para:

• Uso:
• lsurvival.home.use
• lsurvival.tpa.request
• lsurvival.tpa.here
• lsurvival.tpa.accept
• lsurvival.tpa.deny
• lsurvival.tpa.cancel
• Consola (implícito) ya que diag y statsctl se limitan a ConsoleActor.
• Bypass (opcionales):
• lsurvival.bypass.combat
• lsurvival.bypass.warmup
• lsurvival.bypass.cooldown
• Ámbito específico: lsurvival.bypass.home.*, lsurvival.bypass.tpa.*

Estado actual (0.2.x)

• Implementado: TPA, /home con persistencia JSON, prefijo configurable, warmups/cooldowns centralizados, panel diag, árbol statsctl con JsonStatsService (archivo único), validaciones básicas contra combate.
• En progreso: listeners de daño/desconexión/cama, verificación fuerte de cama y estrategias OnMissingBed, integración completa de permisos de OpenMod para jugadores.

Solución de problemas

• “No puedes usar /home en combate”: revisa LSurvivalCore:Home:BlockInCombat o asigna bypass de combate.
• “Cooldown activo”: espera el tiempo mostrado o asigna bypass de cooldown.
• “No tienes ninguna cama reclamada”: asegúrate de tener cama reclamada; valida el directorio JSON configurado.
• “statsctl … falla por servicio no disponible”: confirma que OpenMod/plugins/LSurvivalCore/data/stats.json existe (se crea solo al primer guardado) y que el plugin fue recompilado en 0.2.9.

Comprobación

En juego/consola: /ls → LSurvivalCore ✔ Todo OK.