HyTari Studios · Guía oficial de configuración

Server Diagnostics

Correcciones específicas siempre activas, diagnóstico pesado solo cuando hace falta.

Server Diagnostics corrige casos concretos y validados sin convertirse en un sistema de limpieza genérico. El perfil recomendado está operativo y silencioso: correcciones automáticas ON, diagnóstico profundo OFF.

INICIAR LA GUÍA PÁGINA DEL MOD

ANTES DE EMPEZAR

Primeros pasos

PASO 01

Instala e inicia

La configuración generada ya es el perfil recomendado.

PASO 02

Mantén activas las correcciones

Rotation Fix y Tracker Cleanup son los módulos automáticos validados.

PASO 03

Activa debug solo si hace falta

EntityTracker Diagnostics es una herramienta de investigación, no un requisito.

Server Diagnostics sigue una filosofía fail-open con correcciones muy concretas: los casos inciertos se dejan a Hytale en lugar de aplicar una limpieza genérica.

CAPÍTULO 01 · 1 EJEMPLOS

Perfil de producción

Una configuración limpia ya está lista para el uso normal.

01PROPERTIES

Perfil de producción recomendado

En una instalación limpia, las correcciones validadas están activas mientras las herramientas costosas permanecen desactivadas.

PROPERTIES
enabled=true

module.flyingNpcRotationFix.enabled=true
module.flyingNpcRotationFix.debug=false

module.droppedItemTrackerCleanup.enabled=true
module.droppedItemTrackerCleanup.dryRun=false

module.entityTrackerDiagnostics.enabled=false
module.entityTrackerDiagnostics.debug=false

mods/ServerDiagnostics/config.properties

QUÉ HACE

En una instalación limpia, las correcciones validadas están activas mientras las herramientas costosas permanecen desactivadas.

COMPORTAMIENTO IMPORTANTE

  • dryRun=false significa que el cleanup validado está realmente activo.
  • El diagnóstico profundo no es necesario para que funcione el cleanup.
  • El perfil normal está diseñado para ser silencioso y ligero.

CAPÍTULO 02 · 1 EJEMPLOS

Flying NPC Rotation Fix

Repara únicamente valores roll no finitos NaN/Infinity en modelos voladores configurados.

01PROPERTIES

Corrección de rotación de NPC voladores

Revisa los modelos configurados al entrar en ECS y repara solo valores de rotación no finitos.

PROPERTIES
module.flyingNpcRotationFix.enabled=true
module.flyingNpcRotationFix.debug=false

config.properties

QUÉ HACE

Revisa los modelos configurados al entrar en ECS y repara solo valores de rotación no finitos.

COMPORTAMIENTO IMPORTANTE

  • No cambia IA, pathfinding, velocidad, reglas de spawn ni rotaciones válidas.
  • El prefijo de modelo elegible por defecto sigue siendo NPC/Flying_.
  • Mantén el debug desactivado salvo que investigues un caso concreto.

CAPÍTULO 03 · 1 EJEMPLOS

Dropped Item Tracker Cleanup

Elimina solo updates ya inválidos que pueden correlacionarse con seguridad con dropped items eliminados.

01PROPERTIES

Cleanup EntityTracker para dropped items

Se ejecuta entre la cola de updates y el envío de paquetes, pero solo si una referencia inválida puede correlacionarse con seguridad con un dropped item ya eliminado.

PROPERTIES
module.droppedItemTrackerCleanup.enabled=true
module.droppedItemTrackerCleanup.dryRun=false
module.droppedItemTrackerCleanup.logToFile=true
module.droppedItemTrackerCleanup.summaryIntervalSeconds=300

config.properties

QUÉ HACE

Se ejecuta entre la cola de updates y el envío de paquetes, pero solo si una referencia inválida puede correlacionarse con seguridad con un dropped item ya eliminado.

COMPORTAMIENTO IMPORTANTE

  • No modifica dropped items vivos, ItemStacks, cantidades, temporizadores pickup/despawn ni updates válidos.
  • Las condiciones inesperadas son fail-open para que Hytale gestione el caso normalmente.
  • El intervalo de resumen de 300 segundos evita spam en producción.

CAPÍTULO 04 · 1 EJEMPLOS

Diagnóstico profundo

Herramientas solo de observación para investigar EntityTracker/ECS.

01PROPERTIES

Activa el diagnóstico profundo solo temporalmente

Para investigar avisos EntityTracker/ECS puedes activar el módulo de observación.

PROPERTIES
module.entityTrackerDiagnostics.enabled=true
module.entityTrackerDiagnostics.debug=true

config.properties

QUÉ HACE

Para investigar avisos EntityTracker/ECS puedes activar el módulo de observación.

COMPORTAMIENTO IMPORTANTE

  • Puede generar mucha más telemetría local y archivos mayores.
  • Registra contexto sobre arquetipos ECS, componentes, ciclo de vida, viewers y correlaciones.
  • Tras la investigación, vuelve al perfil mínimo.

CAPÍTULO 05 · 1 EJEMPLOS

Registros y retención

Un archivo persistente por categoría, compactado al iniciar y apagar.

01PROPERTIES

Retención por categoría

El mod mantiene un archivo por categoría y elimina los registros antiguos de ese mismo archivo.

PROPERTIES
logs.retention.enabled=true
logs.retention.entityTrackerDays=3
logs.retention.entityArchetypesDays=5
logs.retention.dropTrackerCleanupDays=3
logs.retention.flyingNpcRotationDays=5

config.properties

QUÉ HACE

El mod mantiene un archivo por categoría y elimina los registros antiguos de ese mismo archivo.

COMPORTAMIENTO IMPORTANTE

  • La compactación se realiza durante la inicialización y el apagado limpio.
  • No crea infinitos archivos diarios solo para implementar retención.
  • Los registros permanecen locales y el mod no los sube.

Antes de usar un ejemplo

No se requiere ningún comando ni permiso de jugador.

Los registros pueden contener contexto útil para depurar; revísalos antes de publicarlos.

Que los contadores de cleanup estén a cero no significa necesariamente que el mod no funcione; quizá el caso objetivo no se haya producido.

VOLVER ARRIBA