THE ORB
Iniciando o studio

Tradutor de resources: guia e tutorial

Traduza para qualquer idioma um resource que você comprou.

O tutorial em vídeo chega em breve

Enquanto isso, o guia escrito abaixo te leva por cada passo.

O que é

O Resource Translator pega um script que só fala inglês (ou qualquer outro idioma) e devolve ele falando o seu. Você solta o resource, um escaneamento grátis mostra quais arquivos de idioma ele tem e quantas mensagens os seus jogadores vão ler, depois o ORBIE traduz e você baixa o resource inteiro com o arquivo do idioma novo gravado ao lado do original. Nomes, valores e códigos de cor dentro de cada mensagem ficam travados para a tradução não quebrar o script, e as palavras que você escolhe para o seu servidor ficam salvas, para todo script que você traduzir dizer a mesma coisa.

Para quem é

  • Donos de servidor cujos jogadores não leem inglês e que rodam scripts que só vêm em inglês.
  • Servidores com dezenas de scripts que querem a mesma palavra para a mesma coisa em todo lugar (stash, dispatch, garagem).
  • Quem comprou um script que diz suportar o seu idioma e achou o arquivo vazio.

Antes de começar

  • O resource: um .zip, a pasta, ou só os arquivos de idioma .lua e .json dele.
  • Para traduzir (não para escanear): uma conta da THE ORB e créditos. Veja os preços.

Escaneie o resource de graça

  1. 1

    Abra o tradutor

    Entre no Resource Translator.

  2. 2

    Solte o resource

    Arraste a pasta ou o .zip para a caixa, ou use Escolher um .zip ou arquivos ou Escolher uma pasta. Arquivos .lua e .json soltos também funcionam.

  3. 3

    Leia o resumo

    O painel mostra o nome do resource e um veredito de uma linha, por exemplo que o script mostra um certo número de mensagens aos seus jogadores e que todas estão em arquivos de idioma. Embaixo: mensagens que os jogadores veem, palavras, quantas têm um nome ou um número, quantas são botões e rótulos curtos e quantos arquivos de idioma existem.

O escaneamento inteiro acontece no seu navegador. Nada é enviado e não custa nada.

Ele entende quatro tipos de arquivo de idioma: scripts de ESX, scripts de QBCore e de Qbox, ox_lib e qualquer coisa que guarde o texto num arquivo .json, e scripts com uma lista simples de mensagens.

O que o escaneamento te mostra

O visor lista tudo o que o escaneamento encontrou, o mais surpreendente primeiro:

  • Vale saber: o script diz que fala um idioma, mas esse arquivo está vazio. Ligar esse idioma na config não muda nada, os seus jogadores continuam vendo inglês. O ORBIE pode preencher.
  • Idiomas que este script diz falar: todos os idiomas que ele traz, com os vazios marcados.
  • Um cartão por arquivo de idioma: o caminho, o idioma, o formato, quantas mensagens ele tem e algumas linhas de exemplo quando você abre.
  • Termos que vale decidir uma vez: palavras que aparecem neste script e na maioria dos outros que você tem, com quantas vezes cada uma é usada.
  • Mensagens que não podemos traduzir para você: texto escrito direto no script em vez de num arquivo de idioma. Mudar esses textos exige editar o script, coisa que a tool não faz sozinha, porque um erro ali faz o script parar de funcionar. Abra o cartão para ver onde está cada um.

Se o script não tem nenhum arquivo de idioma e tudo está escrito dentro do código, não tem nada para traduzir com segurança. O veredito diz isso.

Passo 1: escolha um idioma

  1. 1

    Vá para Traduzir

    Clique em Traduzir na barra da esquerda. O painel mostra três passos.

  2. 2

    Escolha o idioma

    Em Escolha um idioma, clique num. A primeira lista mostra os idiomas marcados com um brilho: para esses, a gente anotou como a cena de FiveM daquele idioma fala de verdade. Use Mostrar todos ou a caixa de busca para os outros.

  3. 3

    Confira de qual idioma você traduz

    Se o script traz vários idiomas, escolha em Traduzindo de qual usar como origem. Inglês vem escolhido primeiro. Não dá para traduzir um idioma para ele mesmo: a tool avisa e deixa os botões desligados.

Passo 2: combine as palavras uma vez (o glossário)

O glossário é uma lista curta de termos e de como o seu servidor fala cada um. É ele que impede a mesma palavra de sair de três jeitos diferentes em trinta scripts.

  1. 1

    Revise os termos sugeridos

    Na primeira vez que você usa um idioma, a lista vem preenchida com termos deste resource. Nos idiomas com notas da cena, as respostas já vêm com o que os servidores daquele idioma costumam dizer. Mude o que você não concordar.

  2. 2

    Defina como o servidor fala com os jogadores

    Em alguns idiomas tem um campo para o tom (por exemplo, tratamento formal ou informal). Deixe vazio para usar o padrão que aparece embaixo.

  3. 3

    Adicione ou tire termos

    Use Adicionar um termo para uma linha nova, e o X no fim de uma linha para tirar.

  4. 4

    Aperte Salvar o glossário

    Você precisa estar logado. A partir daí, todo script que você traduzir para esse idioma usa ele. Cada idioma tem o seu glossário.

O glossário é salvo sozinho antes de cada prévia e de cada tradução completa, então o que está na tela é o que vai ser usado.

Passo 3: veja, e depois faça

  1. 1

    Aperte Testar 10 strings

    O ORBIE traduz as dez primeiras mensagens com o seu glossário aplicado. O visor mostra cada uma em duas colunas, o original e o seu idioma, com um aviso embaixo de qualquer linha que mereça uma segunda olhada. Isso custa 1 crédito por padrão; o preço aparece no botão.

  2. 2

    Aperte Traduzir tudo

    Isso traduz o resource inteiro para esse idioma numa cobrança só, não importa em quantos arquivos ele esteja dividido. Por padrão são 2 créditos por idioma; o preço aparece no botão e o seu saldo aparece em cima dele.

  3. 3

    Espere, ou continue trabalhando

    O ORBIE traduz em grupos de 40 mensagens e o contador sobe a cada grupo que termina. Enquanto isso, você pode ir para outras páginas do site: a tradução continua e o botão de tarefas na barra de cima te traz de volta para baixar.

Antes de traduzir, cada variável (como %s, %{amount} ou um código de cor como ~r~) é travada, e depois de traduzir ela é conferida de novo. Uma mensagem cujas variáveis não sobreviveram é descartada em vez de entregue. Uma tradução que falha nessa conferência não é cobrada.

Cada idioma a mais é uma cobrança separada. Traduzir para espanhol e para português são duas traduções.

Quando o script atualiza

Traduza a versão nova do mesmo jeito. A tool lembra, neste navegador, do que você já traduziu para aquele resource e idioma, e só manda as linhas novas. Se não tem nada novo, ela avisa em vez de cobrar.

A tela de resultado mostra quantas mensagens foram traduzidas desta vez e quantas foram reaproveitadas de antes.

O que você baixa

Quando termina, o visor diz que o resource está pronto e lista os arquivos que ele gravou. Aperte Baixar o resource traduzido. Você recebe <resource>-<idioma>.zip com:

  • O resource inteiro como você enviou, sem mudança nenhuma.
  • O arquivo do idioma novo ao lado de cada original, com o nome do idioma novo. Por exemplo, locales/en.lua ganha um locales/es.lua do lado.
  • Se o resource já tinha um arquivo para aquele idioma, ele fica exatamente como estava e a tradução vai para um arquivo terminado em -orbie ao lado (por exemplo es-orbie.lua), para você comparar e ficar com o que preferir.
  • Três arquivos de notas, ORBIE-TRANSLATION-NOTES.txt, ORBIE-NOTAS-DE-TRADUCCION.txt e ORBIE-NOTAS-DE-TRADUCAO.txt, com o que foi escrito, o glossário usado e o que vale a pena olhar.

Instalar no seu servidor

  1. 1

    Faça backup da pasta antiga

    Copie a pasta do resource para algum lugar fora de resources/.

  2. 2

    Troque a pasta

    Descompacte e coloque o resource em resources/ no lugar do antigo, com o mesmo nome de pasta.

  3. 3

    Ligue o idioma

    O arquivo novo não faz nada até o script ser configurado para usar ele. A maioria dos scripts tem uma opção de idioma no arquivo de config, por exemplo uma linha como Config.Locale = 'es'. Siga o que as instruções do próprio script dizem.

  4. 4

    Confira o manifest

    Se o fxmanifest.lua do script lista os arquivos de idioma um por um em vez de usar um padrão como locales/*.lua, adicione o arquivo novo nessa lista. Se não, ele não carrega.

  5. 5

    Reinicie

    Reinicie o servidor, ou digite ensure seguido do nome do resource no console do servidor, e confira algumas mensagens no jogo.

Mantenha o arquivo do idioma original. A maioria dos frameworks quer ele lá como reserva, e é por isso que a tradução é gravada ao lado e nunca por cima.

Problemas comuns

Os botões continuam cinza.

Escolha um idioma primeiro, e confira que ele não é o mesmo que está em Traduzindo de.

Diz que o script não tem arquivos de idioma.

Tudo o que ele diz está escrito no código. A tool não edita o código, porque uma mudança errada faz o script parar de rodar. Peça ao autor uma versão com arquivos de idioma, ou peça para alguém tirar os textos do código.

Diz que não tem nada novo para traduzir.

Todas as mensagens já estão na sua tradução salva para aquele resource e idioma. Baixe pelo resultado, ou traduza para outro idioma.

Os jogadores continuam vendo inglês depois de instalar.

O script continua configurado em inglês. Mude a opção de idioma na config dele para o código do idioma novo e reinicie. Confira também se o manifest carrega o arquivo novo.

Algumas strings foram rejeitadas.

As variáveis ou os códigos de cor delas não voltaram intactos, então elas foram descartadas em vez de serem entregues quebradas. Essas linhas ficam no idioma original no arquivo novo.

A conexão caiu enquanto ele traduzia.

Aperte o botão de novo com o mesmo arquivo. Se a tradução terminou, você recebe sem pagar duas vezes. Uma tradução terminada fica no nosso servidor por 24 horas depois que você pega, ou por 30 dias se você nunca voltou para buscar.

Perguntas frequentes

O que é enviado para o servidor de vocês?

Só as mensagens que estão sendo traduzidas, e só quando você aperta um botão. Os arquivos são lidos e remontados no seu navegador. O seu glossário fica salvo na sua conta.

Quantos idiomas tem?

Mais de 50. Os marcados com um brilho têm notas sobre como a cena de FiveM daquele idioma fala, então termos como dispatch ou stash saem do jeito que os jogadores esperam.

Ele vai quebrar o meu script?

Ele só traduz texto que é claramente um valor num arquivo de idioma, nunca as chaves nem os nomes de eventos, e trava cada variável antes de traduzir. Uma mensagem que volta com uma variável quebrada é descartada.

Tem limite?

Uma passada aceita até 4.000 mensagens. Uma mensagem sozinha com mais de 2.000 caracteres é pulada.

Pago de novo se traduzir o mesmo script duas vezes?

Se nada mudou, ele avisa que não tem nada novo e não cobra. Depois de uma atualização, uma nova passada traduz só as linhas novas, mas continua sendo uma cobrança para aquele idioma.

O glossário vale para outros scripts?

Vale. Ele pertence à sua conta e ao idioma, então o próximo script que você traduzir para esse idioma já começa com ele.

Conferido com a ferramenta em 15 de novembro de 2026.

Experimente o Tradutor de resources agora

Comprou um script que só fala inglês? Traduza para qualquer idioma e baixe o resource de volta, com as suas próprias palavras usadas em todos os scripts que você tem.

Mais guias de Scripts