Como usar a pasta Lang.

Como funciona esta pasta

MuServer\Data\Lang contém as mensagens do GameServer em cinco idiomas. Cada linha associa um índice numérico ao texto mostrado por uma função do servidor. Os cinco arquivos do pacote analisado têm os mesmos 725 índices, do 0 ao 942, com lacunas entre eles. Uma lacuna não é uma reserva para clientes: as atualizações da Genesys podem preenchê-la.

LanguageCode fica em GameServerInfo - Common.dat. No pacote examinado, GameServer e GameServerCS estão em 1 (português). O prefixo 000 a 004 no nome do arquivo escolhe o idioma; ele não é o índice das mensagens dentro do arquivo.

Formato de cada linha

Index "Message"

Exemplo retirado de 001 - Por.txt:

0 "O Blood Castle irá fechar em %d minuto(s)"

Index é o número que o servidor usa para procurar a mensagem. Message é o texto entre aspas. Comentários iniciados por // ajudam a organizar o arquivo, e end encerra a lista. Uma linha nova só aparece no jogo se o recurso correspondente chamar aquele índice; adicionar texto ao arquivo não cria um aviso novo por si só.

Índices próprios e atualizações

Não use o próximo índice após as mensagens oficiais e não preencha as lacunas. A Genesys pode acrescentar novas linhas em sequência a cada atualização, e uma linha própria próxima das oficiais pode passar a ter o mesmo número.

Para mensagens próprias, comece em 10000 ou mais, confira que o índice está livre no pacote atualizado e mantenha uma lista dos números que reservou. Essa faixa é uma recomendação de organização baseada no pacote atual, não uma garantia de reserva permanente pela Genesys. Ao receber uma atualização, compare as novas mensagens oficiais antes de reaplicar suas personalizações.

Exemplo de numeração para um texto próprio:

10000 "Mensagem personalizada do meu servidor"

Essa linha só será exibida se algum recurso do servidor usar o índice 10000.

Se o servidor puder alternar idiomas, use o mesmo índice nos cinco arquivos e traduza somente o texto. Não renumere mensagens oficiais existentes. Guarde uma cópia dos arquivos personalizados fora da pasta que recebe atualizações.

Cuidados com o texto

• Preserve os marcadores de valor, como %d para números e %s para texto, na mesma quantidade e ordem. Uma tradução que troca ou remove um marcador pode mostrar dados errados.
• Mantenha a mensagem entre aspas e preserve o end ao final. Evite aspas não escapadas dentro do texto.
• Preserve a codificação do arquivo original ao salvá-lo: português e espanhol usam codificação ocidental legada, vietnamita usa UTF-8 com BOM, e chinês usa GBK. Converter todos os arquivos para uma codificação única pode quebrar acentos ou caracteres.
• Escreva mensagens curtas: o campo do GameServer comporta até 127 bytes de texto. Caracteres vietnamitas e chineses podem ocupar mais de um byte.
• Recarregue as mensagens pelo menu Common → Lang do GameServer e do GameServerCS e confira a mensagem no recurso que a utiliza.

O pacote atual possui apenas arquivos .txt. Se você adicionar um arquivo .xml correspondente com mensagens válidas, o servidor o carregará antes do .txt para aquele idioma; confirme qual formato está ativo antes de editar.