Launcher de Lineage 2: patches sem reinstalar o cliente

Um launcher de Lineage 2 faz três coisas: confere os arquivos do cliente do jogador, baixa os que faltam ou estão desatualizados e inicia system\L2.exe. Tudo o mais que ele mostra, de notícias a botões do Discord, é embalagem em volta dessas três tarefas. Com o laço de atualização certo, patches viram rotina. Com ele errado, cada mudança de conteúdo vira "reinstale o cliente" para algumas centenas de pessoas.
Aqui vão o laço de atualização, os dois formatos de manifesto ainda em circulação, onde os pacotes ficam no servidor web e as falhas que só aparecem na noite do lançamento.
O que o launcher está realmente conferindo
O launcher compara os arquivos locais do jogador com uma lista publicada pelo servidor. Cada entrada carrega caminho, tamanho e checksum. Se o hash bate, o arquivo está atualizado. Se não, o launcher baixa a cópia nova e substitui. Esse é o mecanismo inteiro, seja num L2Updater.exe de 2008 ou num launcher .NET 8 escrito no mês passado.
Três coisas separam uma versão que funciona de uma irritante:
- Arquivos críticos. Alguns arquivos precisam estar atualizados para o jogo abrir, porque cliente com protocolo diferente cai no login. Marque-os como obrigatórios e bloqueie o botão de iniciar até serem atualizados.
- Compressão. Arquivos de patch devem ser comprimidos e descomprimidos na hora. Um patch cru de algumas centenas de texturas tem várias centenas de megabytes.
- Uma versão visível. Quando um jogador reporta um bug, a primeira pergunta é qual build do launcher e qual revisão de patch ele tem. Se o launcher não mostra, o suporte vira adivinhação.

Dois formatos de manifesto: hash com JSON ou checksums por linha
Os dois funcionam. Diferem em quanto você precisa programar.
| Abordagem | Como funciona | Para quem |
|---|---|---|
| Manifesto moderno | Um manifesto remoto lista cada arquivo com hash. O launcher compara, baixa só as diferenças, e uma ferramenta separada gera os pacotes completo e incremental. O projeto de código aberto l2-launcher-custom funciona assim: launcher .NET 8, comparação por hash, Full Check manual e um PatchBuilder que gera arquivos .bz2, um manifesto files.xml e um endpoint download.php. | Servidores novos, ou quem não se importa em publicar um app .NET pequeno. |
| updates.lst clássico | Um arquivo de texto com uma linha por arquivo: caminho, CRC, tamanho e marca de obrigatório. O formato original do L2Updater usava linhas como F1=l2text\help.htm|<crc>|<size>|n sob um cabeçalho, com uma entrada própria como IAM=L2Updater.exe|<crc>|<size> para o launcher se atualizar. Uma ferramenta geradora monta o pacote e a lista. | Packs da era Interlude, ou equipes que herdam um launcher que já funciona. |
O formato clássico tem um truque extra que vale conhecer: uma flag ModifyHost que associa l2authd.lineage2.com ao IP do seu servidor de login no arquivo hosts do Windows no primeiro início. Poupa uma edição ao jogador e também significa que o launcher precisa de permissão para escrever nesse arquivo, que é a razão de alguns dispararem aviso de antivírus.
Empacotamento: instalação completa e patch incremental são produtos diferentes
Você precisa de dois artefatos e eles não são intercambiáveis:
- Pacote de cliente completo. Tudo, normalmente perto de 10 GB num cliente moderno, para quem não tem nada.
- Pacote de patch. Só os arquivos que mudaram desde a última versão, para quem já está na build anterior.
Gere o patch comparando duas builds da pasta do cliente, não lembrando quais arquivos você editou. A diferença importa: um arquivo que você mudou e depois reverteu continua indo, e uma textura trocada por outra ferramenta fica de fora. Guarde o manifesto de cada versão para poder produzir um delta entre quaisquer duas versões e mantenha o último pacote completo online de forma permanente.
Preserve a estrutura de pastas dentro do arquivo. Um patch que descompactasystemna raiz do cliente em vez de substituirclient\systemdeixa dois de tudo e o cliente ainda abre, o que faz o bug parecer aleatório.
Inclua sempre os arquivos críticos em cada patch mesmo que não tenham mudado. Custa alguns megabytes e conserta clientes que ficaram quebrados por uma atualização anterior pela metade.

Onde os pacotes ficam no servidor web
O diretório do updater é um host de arquivos estáticos com um manifesto ao lado. Pode ser servido pelo seu site, e também por um diretório simples do nginx:
/updater/
files.xml
download.php
system/
textures/
maps/
...
- Sirva por HTTPS. Um launcher baixando executáveis por HTTP puro é um man-in-the-middle esperando para acontecer.
- Espere picos de banda. Um patch envia as mesmas centenas de megabytes para todos que estão online. Se o updater divide link com o servidor de jogo, os jogadores sentem o patch como lag, então mantenha-os em hosts separados quando possível.
- Cacheie o pacote completo, nunca o manifesto. O manifesto deve ir com cabeçalhos no-cache para que clientes não comparem contra uma lista velha.
Integridade do cliente e falsos positivos de antivírus
Dois problemas chegam juntos no momento em que você publica um launcher:
- Jogadores com cliente modificado. Checagem de hash pega arquivos editados ou substituídos. Se quiser mais, alguns launchers trazem uma DLL pequena no cliente para verificação de adulteração e detecção básica de cheat. Decida antes de lançar se quer essa responsabilidade, porque é também a primeira coisa que um trapaceiro experiente reverte.
- Avisos de antivírus. Um executável que escreve dentro da pasta do jogo parece suspeito para heurísticas. Servidores grandes publicam uma nota clara pedindo para adicionar a pasta do jogo às exclusões, e alguns continuam sendo marcados depois de cada recompilação. Assinar o binário reduz o ruído mas não elimina.
Launchers que se auto-atualizam precisam da própria checagem de hash, ou alguém distribui um launcher modificado como "atualização" para os seus jogadores. Mantenha a entrada do próprio launcher no manifesto e recuse iniciar se não bater.
A falha que ninguém depura: protocolo diferente
Um launcher pode atualizar perfeitamente e ainda deixar jogadores sem entrar, porque o cliente entregue fala um protocolo diferente do que o servidor aceita. A configuração AllowedProtocolRevisions lista as revisões que o servidor aceita, por exemplo 267;268;271;273 numa build de High Five. Se a pasta system do cliente está em outro protocolo, o sintoma é tela de login seguida de desconexão sem erro útil.
Fixe a build exata de cliente na qual seu patch se baseia, envie essa pasta system em todo pacote completo e trate cliente de outra fonte como não suportado. O guia de arquivos do sistema do cliente explica como a revisão é checada e quais arquivos não se tocam.
Checklist do dia do lançamento
- Rode um Full Check numa instalação limpa e abra o jogo pelo launcher. Duas vezes, em máquinas diferentes.
- Mude um arquivo no servidor, regenere o manifesto e confirme que o launcher pega esse arquivo e só ele.
- Mate o download na metade. O launcher deve se recuperar e não deixar arquivo corrompido que passe numa checagem de tamanho.
- Teste numa máquina com antivírus recém-instalado, que é o mais perto da experiência de um jogador novo.
- Publique um download manual do patch para os jogadores cujo launcher simplesmente não coopera. Sempre existem alguns.
Depois que o patch funciona, faça as pessoas baixarem
Um launcher só serve para quem já instalou o cliente. Para o resto, a porta de entrada é a sua listagem. Coloque o servidor na frente de quem procura por crônica e rate com uma listagem grátis no L2Calendar, e se quiser o topo da categoria no dia da abertura, a colocação VIP é a versão paga. O guia do site do servidor cobre a página de download e o registro dos quais o launcher depende.
