godot · engine · tutorial
Como traduzir jogos Godot para o português
O RuneTranslate traduz jogos Godot 3.x / 4.x — abrindo o .pck (mesmo quando embutido no .exe), descompilando GDScript e cenas com o GDRE Tools, e listando a interface + os diálogos. A exportação reempacota dentro do .exe ou do .pck independente. Verifique se a build roda.
O RuneTranslate traduz jogos construídos em Godot — o motor gratuito e de código aberto que silenciosamente se tornou uma das formas mais populares de lançar um jogo indie. O Godot historicamente foi um dos motores mais difíceis de traduzir de fora, porque um jogo Godot lançado é uma caixa selada: tudo mora em um único arquivo .pck (frequentemente colado no fim do próprio .exe), os scripts são compilados em bytecode GDScript e as cenas são salvas em binário. O RuneTranslate abre essa caixa, lê o texto e empacota sua tradução de volta.
O Godot abrange muitas versões e estilos de empacotamento, então antes de mais nada: se você apontar o RuneTranslate para um jogo Godot e ele não detectar, não abrir, ou a cópia exportada não rodar, por favor nos avise. Mais sobre isso no final.
O que o Godot realmente é
O Godot é um motor de jogo gratuito, licenciado sob MIT e de código aberto que se tornou uma escolha convencional para jogos indie 2D e 3D, e uma fatia crescente de títulos indie japoneses é lançada nele. Os jogos geralmente são escritos em GDScript, a linguagem própria do Godot parecida com Python, e organizados como cenas — árvores de nós salvas como recursos. Quando um jogo é exportado, tudo isso — scripts, cenas, imagens, áudio — é agrupado em um arquivo de pacote .pck, que fica ao lado do executável ou, muito comumente, anexado ao fim do próprio .exe. Esse empacotamento é exatamente o que faz os jogos Godot parecerem impenetráveis.
Por que os jogos Godot têm sido difíceis de traduzir
Diferente de um motor orientado a script como o Ren'Py, um jogo Godot lançado expõe quase nada em texto puro:
- Tudo está dentro do `.pck`. Não há arquivos de script ou texto soltos para editar — e quando o pacote está embutido no
.exenão há nem sequer um.pckvisível para apontar uma ferramenta. - Os scripts são compilados. O GDScript é distribuído como bytecode compilado (
.gdc) — e no Godot 4 moderno esse bytecode é adicionalmente comprimido — então o diálogo embutido no código não é algo que você possa pesquisar com grep ou abrir em um editor de texto. - As cenas são binárias. Os rótulos de interface e o texto de menu moram em arquivos de cena salvos no formato de recurso binário do Godot (
.scn), não no.tscnlegível que você vê no editor. - Nem todo jogo usa um arquivo de tradução. O Godot tem um sistema de localização de primeira classe (CSV /
.po→.translation), mas muitos jogos, especialmente títulos indie menores, nunca o usam e simplesmente fixam o texto nos scripts e cenas. O RuneTranslate lê os dois: as strings fixas (em.gd,.tscn,.tres,.cfgeproject.godot) e as tabelas de tradução CSV compiladas, que ele corrige no lugar na exportação. Os catálogos.podentro do pacote ainda não são lidos.
O que o RuneTranslate faz agora
O RuneTranslate trata o Godot como um motor de primeira classe e reconstrói o projeto legível para você. Nos bastidores ele inclui uma cópia do GDRE Tools (o kit de engenharia reversa de Godot de código aberto) e o usa para:
- Descompactar o `.pck` — independente,
data.pck, ou o pacote embutido no fim do.exe(o RuneTranslate detecta a assinatura de pacote embutido automaticamente). - Descompilar o GDScript compilado (
.gdc→.gd) para que os diálogos e a narração no código voltem a ficar legíveis. - Converter as cenas binárias (
.scn→.tscn) para que os rótulos e o texto de interface nelas possam ser extraídos.
Ele então varre o projeto recuperado e lista cada string traduzível (diálogos de script, texto de cena/interface, tabelas de tradução, conversas do Dialogic e do Dialogue Manager e arquivos de dados JSON) agrupados por arquivo no editor, com a marcação do motor mascarada atrás de placeholders para que o provedor nunca a estrague. Na exportação ele insere suas traduções de volta no código recuperado e reempacota uma cópia jogável do jogo (mais sobre exatamente como abaixo).
O que você precisa
- RuneTranslate para Windows ou Linux — gratuito, todos os motores e todos os provedores, exceto o RuneLingua, desbloqueados.
- Uma pasta de jogo Godot — normalmente apenas o
.exedo jogo (com o pacote embutido), ou um.exemais um.pck/data.pckao lado dele. Godot 3.x e 4.x são ambos suportados. - Um idioma de destino — português, inglês, espanhol, francês, alemão, russo, chinês, italiano, turco, vietnamita e mais de 20 outros.
- Um provedor de tradução. O Google Translate gratuito funciona de imediato; o DeepL tem um tier gratuito; o OpenAI, o Anthropic, um modelo local (Ollama / LM Studio) e qualquer API compatível com OpenAI exigem sua própria chave. Os jogos Godot geralmente têm muitos diálogos, então um LLM (OpenAI / Anthropic) ou o DeepL lê melhor para o texto de história.
Passo 1: Abra a pasta do jogo
Inicie o RuneTranslate, clique em Novo projeto e aponte-o para o diretório do jogo Godot — a pasta com o .exe do jogo (e um .pck, se ele vier separado). A detecção de motor roda automaticamente: ela reconhece a assinatura de pacote embutido no fim do executável, um .pck solto ou um projeto Godot. Seus arquivos originais nunca são modificados.
Passo 2: Descompacte e recupere o projeto
O RuneTranslate roda seu sidecar embutido GDRE Tools para descompactar o pacote, descompilar o GDScript compilado e converter as cenas binárias em código legível. Ele então varre esse projeto recuperado e lista cada linha traduzível (diálogos e narração dos scripts, rótulos e texto de interface das cenas, as tabelas de tradução do jogo, conversas do Dialogic e do Dialogue Manager e arquivos de dados JSON), agrupadas por arquivo. Caminhos de assets, nomes de nós e outros identificadores de código são filtrados para que você só traduza as strings que um jogador de fato vê.
Passo 3: Traduza
Escolha um provedor e rode. Para um jogo movido a história, um LLM (OpenAI / Anthropic) é o melhor para a voz dos personagens, o DeepL é rápido e limpo para narração, e o Google Translate gratuito serve bem para strings curtas de interface. Os jogos Godot muitas vezes mantêm seus diálogos como longos arrays de linhas dentro de um único script — um "banco de dados de história" — então o mesmo nome de personagem ou lugar aparece centenas de vezes. Coloque seu elenco e termos-chave no glossário logo de início para que sejam renderizados de forma idêntica em todo lugar; veja o Glossário 101. Uma passagem opcional com o refinador por IA aperta o fraseado engessado que a tradução automática costuma deixar.
Passo 4: Exporte uma build traduzida
Clique em Exportar. Como os scripts originais são bytecode compilado, o RuneTranslate usa uma abordagem de sobreposição de código-fonte: ele escreve suas traduções no código recuperado .gd / .tscn, descarta o .gdc compilado / .scn binário para que o motor recorra ao código traduzido solto, reempacota um novo .pck e o coloca de volta onde o jogo o guarda: reincorporado em uma cópia do .exe, ou gravado como o .pck ao lado dele. Seu jogo original permanece intocado; você recebe uma cópia separada, jogável e traduzida.
Escopo de exportação: a exportação funciona para jogos Godot 3 e Godot 4 por igual, seja com o pacote embutido no .exe ou como um .pck independente ao lado dele. Nos dois casos você recebe uma cópia separada, jogável e traduzida.
Passo 5: Verifique se a cópia roda
A build exportada depende de o runtime do Godot compilar o código traduzido solto no momento do carregamento, então inicie o jogo exportado uma vez e confirme que os diálogos e menus mostram seu idioma antes de compartilhá-lo. Se um script não carregar, esse é exatamente o tipo de relato que nos ajuda a fortalecê-lo (veja abaixo).
Limitações conhecidas
- Verifique se o jogo exportado inicia e é lido corretamente antes de redistribuir.
- Catálogos `.po`. O RuneTranslate lê texto no idioma de origem em scripts, cenas, arquivos de dados JSON, arquivos do Dialogic e do Dialogue Manager e nas tabelas de tradução CSV compiladas, mas não os catálogos
.podentro do pacote. - Jogos C# / .NET (Mono). O RuneTranslate foca no GDScript; texto compilado na lógica de um jogo Godot em C# só é alcançado quando o jogo carrega suas strings de um arquivo substituto próprio.
- Texto pintado em imagens. Um título ou logo renderizado como arte são pixels, não strings — isso é trabalho para a tradução de texto em imagem, não para a extração de scripts.
- Idiomas de destino não-latinos dependem de o jogo incluir uma fonte que consiga de fato renderizá-los.
Conte-nos o que quebra
O Godot abrange muitas versões de motor e estilos de empacotamento, e não vimos todos. Se um jogo não detectar, não descompactar, ou exportar algo que não inicia, por favor relate — o nome do jogo, sua versão do Godot e como ele está empacotado (pacote embutido vs um .pck solto) é exatamente o que nos ajuda a fortalecê-lo mais rápido.
Baixe o RuneTranslate, aponte-o para aquele jogo Godot que você pretendia ler, e experimente. Para outro motor moderno, veja o tutorial do Unity a seguir.
Leitura relacionada
Pronto para experimentar o RuneTranslate?
O plano gratuito libera todos os motores + todos os provedores de tradução, exceto o RuneLingua. O plano Supporter ($3,99/mo) libera velocidade total.
Baixar para Windows, Mac e Linux
