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.

6 min de leitura

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 .exe não há nem sequer um .pck visí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 .tscn legí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, .cfg e project.godot) e as tabelas de tradução CSV compiladas, que ele corrige no lugar na exportação. Os catálogos .po dentro 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 .exe do jogo (com o pacote embutido), ou um .exe mais um .pck / data.pck ao 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 .po dentro 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.

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