Hyfixes

HyFixes

Correcciones de errores esenciales para los servidores de acceso anticipado de Hytale. Previene caídas y expulsiones de jugadores causadas por problemas conocidos.

Qué Soluciona

Caída por Recoger Ítem (Crítica)

Cuando un jugador se desconecta mientras recoge un ítem, el hilo del mundo se bloquea y expulsa a TODOS los jugadores en ese mundo.

• Error: NullPointerException en PickupItemSystem.tick() – null targetRef
• Solución: Marca de forma segura los ítems de recogida corruptos como finalizados antes de que causen un bloqueo en el servidor

Caída por Bloque de Resurrección (Crítica)

Cuando un jugador rompe una cama o un saco de dormir, es expulsado del servidor.

• Error: NullPointerException en RespawnBlock$OnRemove – array respawnPoints nulo
• Solución: Inicializa el array de puntos de resurrección antes de que se ejecute el código defectuoso de Hytale

Caída de Ventana de Banco de Procesamiento (Crítica)

Cuando un jugador rompe una hoguera o una mesa de trabajo mientras otro jugador la tiene abierta, es expulsado del servidor.

• Error: NullPointerException en BenchWindow.onClose0 – null ref durante el cierre de la ventana
• Solución: Limpia el mapa de ventanas antes de que se ejecuten los manejadores de cierre que causan el bloqueo

Salida de Instancia Sin Mundo de Retorno (Crítica)

Cuando un jugador sale de una instancia (mazmorras, cuevas, etc.) y los datos del mundo de retorno están corruptos, es expulsado del servidor.

• Error: IllegalArgumentException en InstancesPlugin.exitInstance – Mundo de retorno faltante
• Solución: Rastrea la posición del jugador antes de entrar en las instancias y la utiliza como destino de respaldo

Entidades de Arquetipo Vacías (Monitoreo)

Registra entidades con datos de componentes corruptos/vacíos para depuración. Estas no causan bloqueos, pero indican problemas en los datos del mundo.

Inflación de Memoria de Chunk (Alta – v1.2.0+)

Hytale no descarga correctamente los chunks cuando los jugadores se alejan, causando un crecimiento de memoria ilimitado y eventual bloqueo por falta de memoria.

• Síntomas: La memoria del servidor crece de 4GB a más de 14GB mientras los jugadores vuelan; los chunks nunca disminuyen
• Ejemplo: Un jugador carga 5,735 chunks, solo 317 están en el radio de visión, 5,400+ permanecen en memoria para siempre
• Solución: ChunkCleanupSystem se ejecuta en el hilo principal cada 30 segundos para activar la limpieza interna de chunks de Hytale
• Resultados: Se observó una reducción del 77% en los chunks cargados (942 → 211) después de la solución
• Comandos: /chunkstatus (ver conteos de chunks), /chunkunload (forzar limpieza)

Caída de Tarea de Objetivo de Recolección (Crítica – v1.3.0)

Cuando un jugador tiene una misión/objetivo y la entidad objetivo desaparece, el sistema de misiones se bloquea.

• Error: NullPointerException en GatherObjectiveTask.lambda$setup0$1 – null ref
• Solución: Monitorea los objetivos en cada tick mediante reflexión y limpia los objetivos corruptos antes del bloqueo

Protección de Chunk de Ítem Recogido (Crítica – v1.3.0)

Protección de respaldo para caídas de ítems recogidos durante eventos de descarga de chunks.

• Escenario: El jugador se teletransporta rápidamente mientras se está recogiendo un ítem
• Solución: RefSystem intercepta eventos de eliminación de entidades y valida targetRef antes de la cascada de bloqueos

Comando de Estado de HyFixes (v1.3.0)

Nuevo comando de administrador para ver estadísticas completas de HyFixes.

• Comando: /interactionstatus (alias: /hyfixes, /hfs)
• Muestra: Caídas prevenidas por tipo, estadísticas de memoria, errores conocidos de Hytale que no se pueden corregir

Caída de Banco de Gestión de Creación (Crítica – v1.3.1)

Cuando un jugador abre un banco de procesamiento mientras tiene una referencia de banco obsoleta, es expulsado del servidor.

• Error: IllegalArgumentException en CraftingManager.setBench – El tipo de bloque de banco ya está establecido
• Solución: Monitorea a los jugadores en cada tick y limpia las referencias de banco obsoletas antes del bloqueo

Caída de NPE de InteractionManager (Crítica – v1.3.1)

Cuando un jugador abre una mesa de trabajo en ubicaciones específicas, es expulsado del servidor.

• Error: NullPointerException en InteractionSystems$TickInteractionManagerSystem
• Solución: Valida las cadenas de interacción en cada tick y elimina las corruptas antes del bloqueo
• Problema en GitHub: #1

Protección de Tiempo de Espera del Cliente (Crítica – v1.3.3)

Cuando una cadena de interacción espera demasiado tiempo por datos del cliente, el jugador es expulsado del servidor.

• Error: RuntimeException: Client took too long to send clientData en InteractionChain.java:207
• Solución: Detecta proactivamente cadenas que esperan demasiado tiempo (>2.5 segundos) y las elimina antes de que Hytale expulse al jugador

Instalación

• Descarga hyfixes-x.x.x.jar
• Coloca en la carpeta mods/ de tu servidor
• Reinicia el servidor

Compatibilidad

• Hytale Early Access (2025+)
• Java 21+
• Solo del lado del servidor

Errores Conocidos No Solucionables

Algunos errores del núcleo de Hytale no pueden ser corregidos a nivel de plugin. Los hemos documentado en detalle para ayudar a los desarrolladores de Hytale:

• Desbordamiento de Búfer de Sincronización de InteractionChain – Causa desincronización en combate/comida/herramientas (400-2,500 errores/sesión)
• Interacciones de Reemplazo Faltantes – Faltan efectos de sonido y manejadores
• Desincronización de Interacción Cliente/Servidor – Fallos en la validación de acciones

Consulta HYTALE_CORE_BUGS.md para un análisis técnico completo.

Código Fuente

Repositorio de GitHub