Como Traduzir Scripts FiveM com Segurança (Manual + IA)

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

1. Copie o recurso ou crie um branch de controle de versão.
2. Registre a versão exata e o idioma configurado.
3. Liste rótulos visíveis para o jogador, notificações, texto do menu e mensagens de ajuda.
4. 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.
5. 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.