Lanzador de Lineage 2: parches sin reinstalar el cliente

Un lanzador de Lineage 2 hace tres cosas: revisa los archivos del cliente del jugador, descarga los que faltan o están desactualizados y arranca system\L2.exe. Todo lo demás que muestra, de noticias a botones de Discord, es un envoltorio alrededor de esos tres trabajos. Si el bucle de actualización está bien, los parches se vuelven rutina. Si está mal, cada cambio de contenido se convierte en "reinstala el cliente" para varios cientos de personas.
Aquí van el bucle de actualización, los dos formatos de manifiesto que siguen en circulación, dónde viven los paquetes en el servidor web y los fallos que solo aparecen la noche del lanzamiento.
Qué está comprobando realmente el lanzador
Un lanzador compara los archivos locales del jugador con una lista publicada por el servidor. Cada entrada lleva una ruta, un tamaño y un checksum. Si el hash coincide, el archivo está al día. Si no, descarga la copia nueva y la reemplaza. Ese es todo el mecanismo, tanto en un L2Updater.exe de 2008 como en un lanzador .NET 8 escrito el mes pasado.
Tres cosas marcan la diferencia entre una versión que funciona y una frustrante:
- Archivos críticos. Un puñado de archivos tiene que estar al día para que el juego arranque, porque un cliente con protocolo distinto se desconecta en el login. Márcalos como obligatorios y bloquea el botón de inicio hasta que se actualicen.
- Compresión. Los archivos del parche deben comprimirse y descomprimirse al vuelo. Un parche en crudo de unos cientos de texturas son varios cientos de megabytes.
- Una versión visible. Cuando un jugador reporta un fallo, la primera pregunta es qué build del lanzador y qué revisión de parche tiene. Si el lanzador no lo muestra, el soporte se convierte en adivinación.

Dos formatos de manifiesto: hash con JSON o checksums por líneas
Los dos funcionan. Se diferencian en cuánto tienes que programar tú.
| Enfoque | Cómo funciona | Para quién |
|---|---|---|
| Manifiesto moderno | Un manifiesto remoto lista cada archivo con su hash. El lanzador compara, descarga solo las diferencias y una herramienta aparte genera los paquetes completo e incremental. El proyecto de código abierto l2-launcher-custom funciona así: lanzador .NET 8, comparación por hash, Full Check manual y un PatchBuilder que emite archivos .bz2, un manifiesto files.xml y un endpoint download.php. | Servidores nuevos, o quien no tenga problema en publicar una pequeña app .NET. |
| updates.lst clásico | Un archivo de texto con una línea por archivo: ruta, CRC, tamaño y marca de obligatorio. El formato original de L2Updater usaba líneas con la forma F1=l2text\help.htm|<crc>|<size>|n bajo una cabecera, con una entrada propia como IAM=L2Updater.exe|<crc>|<size> para que el lanzador pudiera actualizarse a sí mismo. Una herramienta generadora arma el paquete y la lista. | Paquetes de la era Interlude, o equipos que heredan un lanzador que ya funciona. |
El formato clásico tiene un truco extra que conviene conocer: una marca ModifyHost que asocia l2authd.lineage2.com a la IP de tu servidor de login en el archivo hosts de Windows en el primer arranque. Ahorra una edición al jugador y también implica que el lanzador necesita permiso para escribir ese archivo, que es la razón de que algunos disparen avisos de antivirus.
Empaquetado: instalación completa y parche incremental son productos distintos
Necesitas dos artefactos y no son intercambiables:
- Paquete de cliente completo. Todo, normalmente cerca de 10 GB en un cliente moderno, para quien no tiene nada.
- Paquete de parche. Solo los archivos que cambiaron desde la última versión, para quien ya está en la build anterior.
Genera el parche comparando dos builds de la carpeta del cliente, no recordando qué archivos editaste. La diferencia importa: un archivo que cambiaste y luego revertiste se sigue enviando, y una textura que reemplazaste con otra herramienta se queda fuera. Guarda el manifiesto de cada versión para poder producir un delta entre dos versiones cualesquiera, y mantén el último paquete completo online de forma permanente.
Conserva la estructura de carpetas dentro del archivo. Un parche que descomprimesystemen la raíz del cliente en vez de reemplazarclient\systemdeja dos de todo y el cliente sigue arrancando, lo que hace que el fallo parezca aleatorio.
Incluye siempre los archivos críticos en cada parche aunque no hayan cambiado. Cuesta unos megabytes y repara clientes que quedaron rotos por una actualización anterior a medias.

Dónde viven los paquetes en el servidor web
El directorio del updater es un host de archivos estáticos con un manifiesto al lado. Puede servirlo tu web, y también un simple directorio de nginx:
/updater/
files.xml
download.php
system/
textures/
maps/
...
- Sírvelo por HTTPS. Un lanzador que descarga ejecutables por HTTP en claro es un man-in-the-middle esperando a pasar.
- Cuenta con picos de ancho de banda. Un parche envía los mismos cientos de megabytes a todos los que estén conectados. Si el updater comparte enlace con el servidor de juego, los jugadores notarán el parche como lag, así que mantenlos en hosts separados cuando puedas.
- Cachea el paquete completo, nunca el manifiesto. El manifiesto debe servirse con cabeceras no-cache para que los clientes no comparen contra una lista vieja.
Integridad del cliente y falsos positivos del antivirus
Dos problemas llegan juntos en el momento en que publicas un lanzador:
- Jugadores con clientes modificados. Las comprobaciones de hash detectan archivos editados o reemplazados. Si quieres más, algunos lanzadores incluyen una pequeña DLL en el cliente para verificar manipulación y detección básica de cheats. Decide antes de lanzar si quieres esa responsabilidad, porque también es lo primero que revierte un tramposo con experiencia.
- Avisos de antivirus. Un ejecutable que escribe dentro de una carpeta de juego resulta sospechoso para las heurísticas. Los servidores grandes publican una nota clara diciendo a los jugadores que añadan la carpeta del juego a las exclusiones, y algunos siguen siendo marcados tras cada recompilación. Firmar el binario reduce el ruido pero no lo elimina.
Los lanzadores que se autoactualizan necesitan su propia comprobación de hash, o alguien puede distribuir un lanzador modificado como "actualización" para tus jugadores. Mantén la entrada del propio lanzador en el manifiesto y niégate a arrancar si no coincide.
El fallo que nadie depura: protocolo distinto
Un lanzador puede actualizar perfectamente y aun así dejar a los jugadores sin poder entrar, porque el cliente que entregó habla un protocolo distinto al que acepta el servidor. El ajuste AllowedProtocolRevisions del servidor lista las revisiones con las que hablará, por ejemplo 267;268;271;273 en una build de High Five. Si la carpeta system del cliente está en otro protocolo, el síntoma es una pantalla de login seguida de una desconexión sin error útil.
Fija la build exacta de cliente sobre la que se basa tu parche, envía esa carpeta system en cada paquete completo y trata un cliente de otra fuente como no soportado. La guía de archivos del sistema del cliente explica cómo se comprueba la revisión y qué archivos no se tocan.
Lista de comprobación del día del lanzamiento
- Haz un Full Check en una instalación limpia y arranca el juego desde el lanzador. Dos veces, en máquinas distintas.
- Cambia un archivo en el servidor, regenera el manifiesto y confirma que el lanzador detecta ese archivo y solo ese.
- Corta la descarga a la mitad. El lanzador debe recuperarse y no dejar un archivo corrupto que pase una comprobación de tamaño.
- Prueba en una máquina con antivirus recién instalado, que es lo más parecido a la experiencia de un jugador nuevo.
- Publica una descarga manual del parche para los jugadores cuyo lanzador no coopere. Siempre hay unos cuantos.
Cuando el parche funcione, haz que la gente lo descargue
Un lanzador solo sirve a quien ya instaló el cliente. Para el resto, la puerta de entrada es tu listado. Pon el servidor delante de jugadores que buscan por crónica y rate con un listado gratis en L2Calendar, y si quieres lo más alto de la categoría el día de apertura, la colocación VIP es la versión de pago. La guía de la web del servidor cubre la página de descarga y el registro de los que cuelga el lanzador.
