Traduza os valores de localidade existentes do recurso, preservando chaves, espaços reservados, códigos de controle e sintaxe de arquivo. A edição manual oferece controle máximo; a IA pode acelerar um lote revisado. Nenhum dos métodos torna seguro traduzir todas as strings entre aspas no código-fonte.
Encontre o sistema de localidade compatível
Leia a documentação do recurso e fxmanifest.lua. Procure por diretórios de localidade, dicionários JSON/Lua, arquivos de tradução NUI e uma configuração de idioma. Use o sistema que o criador fornece. Não adicione lua54 como uma correção de tradução; essa opção de manifesto está obsoleta e não tem relação com a localização.
Faça backup e inventarie as strings visíveis
- Copie o recurso ou crie um branch de controle de versão.
- Registre a versão exata e o idioma configurado.
- Liste rótulos visíveis para o jogador, notificações, texto do menu e mensagens de ajuda.
- Exclua chaves, nomes de eventos, comandos, colunas de banco de dados, caminhos de arquivo e identificadores, a menos que a documentação os marque explicitamente como traduzíveis.
- Crie um glossário para termos de framework, trabalhos, itens e terminologia do servidor.
Método manual: edite apenas os valores
Em um editor com reconhecimento de sintaxe, como o Notepad++, altere o valor legível por humanos no lado direito, mantendo a chave e a estrutura intactas.
{
"garage_open": "Open garage",
"price_label": "Price: %s"
}Para outro idioma, traduza Open garage e Price, mas preserve garage_open, price_label e %s. Mantenha sequências de escape, aspas, vírgulas, chaves, códigos de cores como ~r~, e tokens de formato como %s, %d ou {name} exatos.
Método com IA: envie um lote restrito somente com valores
Forneça apenas as entradas de localidade necessárias para a tradução — não o recurso privado completo, a configuração do servidor, a chave de licença, o webhook, os dados do jogador ou a exportação do banco de dados. Indique o idioma de origem e de destino, o glossário e os tokens invariantes. Exija o mesmo formato estruturado e peça ao modelo para deixar as chaves e todos os espaços reservados inalterados.
A saída da IA é um rascunho. Os modelos podem renomear uma chave, alterar a pontuação, traduzir um comando, descartar um espaço reservado ou retornar JSON/Lua inválidos, mesmo soando confiantes. Revise o diff entrada por entrada.
Valide antes de iniciar o recurso
- Analise JSON com um analisador JSON e Lua com o fluxo de trabalho de lint/teste compatível com o projeto.
- Compare o conjunto completo de chaves com a localidade de origem.
- Verifique a paridade exata de espaços reservados e códigos de controle por entrada.
- Procure por alterações acidentais em comandos, nomes de eventos e URLs.
- Inspecione o diff em busca de comentários adicionados ou cercas de Markdown.
Teste na UI
Inicie o locale traduzido no ambiente de teste e percorra todos os fluxos visíveis: menu, notificação, erro, confirmação, validação de entrada e texto de ajuda. Verifique cortes de texto, quebras de linha, caracteres acentuados, erros de plural/contexto e comportamento da direita para a esquerda, quando aplicável. Revise os logs do navegador/NUI, do F8 e do servidor.
Crie uma memória de tradução reutilizável
Armazene pares de origem/valor aprovados, decisões de glossário e notas do revisor fora do pacote do fornecedor. Quando o recurso for atualizado, compare o novo locale de origem com a versão anterior e traduza apenas as chaves adicionadas ou alteradas. Nunca sobrescreva às cegas um novo locale do fornecedor com um arquivo completo antigo.
Reverta com segurança
Mantenha o locale e a configuração originais disponíveis. Se o parsing, a interface ou o comportamento em tempo de execução regredir, restaure os arquivos que funcionavam, reinicie o recurso e confirme se o idioma padrão funciona. Corrija a tradução em uma nova versão, em vez de editar a produção sem um diff.