Nos servidores Metin2, as alterações feitas no lado do cliente devem chegar corretamente aos jogadores. Quando os arquivos root, locale, uiscript, icon, item_proto, mob_proto, map ou effect são atualizados, podem ocorrer sérias incompatibilidades caso o jogador entre no jogo com os arquivos antigos.

Se o patcher não estiver funcionando, se o arquivo não estiver baixando, se os jogadores estiverem logando com o pacote antigo ou se alguns jogadores apresentarem erros e outros não, o problema geralmente está no sistema de atualização do cliente.

1. Sintomas de problema de patch

• Novos ícones de itens não aparecem para os jogadores.
• Alguns jogadores enfrentam desligamentos de clientes, outros não.
• A nova mudança na interface não se reflete no player.
• O novo mapa não abre para alguns jogadores.
• O Patcher não baixa arquivos ou apresenta erro.
• Mesmo que a raiz seja atualizada, o jogo roda com o arquivo Python antigo.
• Erros de arquivo de pacote ausente aparecem no syserr do cliente.

2. Quais arquivos devem ser atualizados?

Os arquivos do pacote que precisam ser atualizados variam dependendo das alterações feitas.

• Mudança na interface Python: pacote de root
• Textos de tradução e interface: pacote local
• Ícone de novo item: pacote de ícones e item_list
• Novo item/multidão: cliente item_proto, mob_proto, arquivos de ícone/modelo
• Novo mapa: pacote de mapas, atlasinfo, arquivos de terreno/propriedade
• Novo efeito: arquivos de efeitos e definições de efeitos

Atualizar apenas um arquivo pode não ser suficiente. Por exemplo, ao adicionar um novo item, os arquivos item_proto do servidor, item_proto do cliente, item_list e ícone devem ser compatíveis.

3. O player está realmente usando o cliente atual?

A primeira verificação é se o jogador recebeu um patch atualizado. Enquanto o desenvolvedor vê o arquivo atualizado em seu cliente, os jogadores podem continuar fazendo login com o arquivo antigo.

Coisas para verificar:

• O Patcher baixou o novo arquivo?
• A data do arquivo na pasta Pack é atual?
• O player pula o patcher e entra direto com o exe?
• A antiga pasta do cliente poderia ser usada?
• O arquivo está realmente atualizado no servidor de patch?
• O Cache ou o CDN poderiam estar fornecendo o arquivo antigo?

4. Lista de patches ou verificação de arquivo de versão

Os sistemas patcher geralmente funcionam por meio de uma lista de patches, arquivo de versão ou lista de hash de arquivo. Se a lista de patches não for atualizada mesmo que o arquivo esteja atualizado, o patcher poderá não baixar o novo arquivo.

Lógica de controle geral:

• O arquivo do pacote atualizado foi adicionado à lista de patches?
• O tamanho do arquivo está correto?
• O valor de hash ou CRC foi atualizado?
• O número da versão foi aumentado?
• O caminho do arquivo está em conformidade com o formato do patcher?

A infraestrutura do Patcher pode ser diferente em cada servidor. Portanto, tomando como exemplo uma linha de arquivo de trabalho existente, a nova linha de arquivo deve ser editada no mesmo formato.

5. O arquivo do pacote realmente mudou?

Às vezes, o arquivo é editado na pasta de origem, mas o arquivo do pacote não é reembalado. Nesse caso, o desenvolvedor pensa que fez uma alteração, mas o cliente ainda usa o conteúdo antigo do pacote.

Lista de verificação:

• O root ou o locale foram realmente reembalados?
• O arquivo empacotado foi copiado para a pasta correta do cliente?
• O arquivo no servidor de patch é antigo ou novo?
• O Patcher grava o arquivo baixado no local correto?
• O arquivo de índice do pacote mostra o novo arquivo?

6. O que acontece se os jogadores pularem o patcher?

Alguns jogadores podem executar o arquivo exe do cliente diretamente em vez do patcher. Nesse caso, eles não recebem atualizações e tentam entrar no jogo com arquivos antigos.

Como resultado:

• Novos itens não aparecem.
• Novos mapas não serão abertos.
• As interfaces Python apresentam erros.
• Ocorre incompatibilidade de proto cliente-servidor.
• Certos sistemas funcionam para alguns jogadores e não para outros.

Em servidores profissionais, o comportamento de bypass do patcher deve ser evitado ou o controle de versão do cliente deve ser feito.

7. Detectando problemas de patch com o cliente Syserr

Nas notificações de erro provenientes do player, o cliente deve ser syserr.txt arquivo deve ser solicitado.

Em caso de deficiência do patch, podem ocorrer os seguintes erros:

CANNOT_FIND_PACK_FILE
Failed to load image
No such file or directory
LoadScriptFile Error
Traceback File "uiInventory.py"

Se houver um erro de arquivo ausente no arquivo syserr do player, o patcher pode não ter baixado esse arquivo ou o arquivo pode não ter sido adicionado ao pacote.

8. Como realizar testes de cliente limpo?

Um teste de cliente limpo deve ser realizado para entender se a atualização está realmente distribuída corretamente.

• Não use a pasta do cliente antiga.
• Obtenha uma cópia limpa do cliente.
• Execute o patcher do zero.
• Verifique se todos os arquivos foram baixados.
• Faça login no jogo e teste o sistema atualizado.
• Verifique o arquivo syserr.txt do cliente.

Se funcionar em um cliente limpo, mas não funcionar no player, deve-se considerar que o player não recebeu um patch ou está usando um cliente antigo.

9. Se você usar CDN ou cache

Se os arquivos de patch estiverem atrás de um CDN ou cache, os arquivos antigos poderão continuar a ser veiculados por um tempo. Neste caso, mesmo que o arquivo esteja atualizado no servidor de patch, o player pode baixar o arquivo antigo.

Como solução:

• O cache do CDN deve ser limpo.
• O nome do arquivo ou o número da versão podem ser alterados.
• O valor hash da lista de patches deve ser atualizado.
• O tamanho do arquivo baixado pelo player deve ser verificado.

Erros Comuns

• Esquecendo de editar e compactar o arquivo raiz
• Não atualizando patchlist ou valor de hash
• Permitindo que os jogadores ignorem o patcher e entrem via exe
• Não realizando testes de cliente limpos
• Não percebendo que arquivos antigos estão sendo distribuídos devido ao cache do CDN
• Ignorando a atualização do pacote do cliente ao atualizar o servidor

Perguntas frequentes

Funciona para mim, mas não funciona para os jogadores, por quê?
Você pode estar usando um cliente atualizado. Os jogadores podem ter recebido um pacote antigo, root antigo ou patch ausente.

Adicionei um novo item, alguns jogadores não possuem ícone. Qual é o motivo?
O novo ícone, item_list ou cliente item_proto pode não estar atualizado no cliente dos jogadores.

O Patcher não está baixando arquivos, o que devo verificar?
Patchlist, caminho do arquivo, hash/CRC, número da versão, acesso ao servidor web e cache CDN devem ser verificados.

Recomendações de operação

• Execute testes limpos do cliente após cada atualização do cliente.
• Verifique a lista de patches e os hashes dos arquivos regularmente.
• Use o controle de versão para evitar que os jogadores ignorem o patcher.
• Planeje alterações de raiz, localidade e proto juntos.
• Examine os arquivos syserr.txt recebidos dos jogadores após a atualização.

Este artigo foi preparado especialmente para PvPServer.