unreal · guides · engine · localization
Como traduzir jogos Unreal Engine
Jogos Unreal distribuem seu texto em tabelas .locres compiladas dentro de containers .pak ou IoStore. Veja como lê-las, e por que a saída é um pak de override minúsculo em vez de um jogo reconstruído.
Um jogo em Unreal Engine parece a coisa mais difícil de traduzir no seu disco. Não há pasta data, não há arquivos de script, não há um .json para abrir — só um executável, um diretório Content/Paks com um ou dois arquivos .pak enormes e, talvez, um par de containers .utoc/.ucas. A boa notícia é que o texto que você realmente quer normalmente não está escondido dentro desses arquivos de propósito. O Unreal tem um sistema de localização de primeira classe, e a maioria dos jogos lançados o usa. Seu trabalho é achar a tabela, trocar as strings e entregar ao motor um arquivo pequeno que tem prioridade sobre o original.
Essa última parte é o que torna o Unreal agradável depois que você entende como funciona. Você não reconstrói um jogo de 60 GB. Você produz um arquivo de override medido em kilobytes e o coloca ao lado dos originais.
Uma coisa antes dos passos: o suporte a Unreal no RuneTranslate já foi confirmado jogável em títulos UE4 e UE5 reais, mas a superfície do formato é enorme e cada estúdio empacota de um jeito. Verifique uma build exportada dentro do jogo antes de se comprometer com uma execução longa de tradução.
O que um jogo Unreal realmente distribui
O Unreal guarda o texto voltado ao jogador em arquivos `.locres` — a forma compilada do FTextLocalizationResource. Há um por cultura, num caminho como <Game>/Content/Localization/Game/ja/Game.locres, com irmãos para en, zh-Hans e o que mais o estúdio tenha distribuído. Um jogo sem tradução nenhuma normalmente ainda tem um, para a cultura em que foi escrito.
Um .locres não é um arquivo de texto nem uma lista simples de chave/valor. É uma tabela binária organizada em namespaces, cada um contendo keys, e cada key apontando para uma string. Nas versões modernas, o namespace e a key são armazenados como hashes (CRC32 na versão 2, CityHash64 sobre UTF-16 na versão 3) em vez de nomes legíveis, e as próprias strings ficam numa tabela de busca compartilhada e desduplicada, com contagem de referências. O runtime nunca procura uma string pelo texto em inglês — ele a procura por aquele par namespace/key, que é compilado nos Blueprints e no C++ do jogo em tempo de build.
Essa estrutura dita a única forma segura de editar um. O RuneTranslate preserva cada hash de namespace, hash de key e hash de string de origem byte a byte e muda só o valor, depois reconstrói a tabela de strings desduplicada e suas contagens de referência. Nada recalcula um hash, então nada pode produzir uma key que o jogo não encontre. As traduções ficam livres para ser mais longas ou mais curtas que o original.
Esses arquivos .locres são então empacotados em arquivos .pak — identificados por um valor mágico 0x5A6F12E1 num footer bem no fim do arquivo — ou, em títulos UE5 modernos, em containers IoStore .utoc/.ucas.
Confira o escopo antes de gastar uma hora
O .locres cobre interface, menus, mensagens de sistema, texto de tutorial, nomes de itens e habilidades, e legendas — algo em torno de 90% do texto visível de um jogo típico. É essa parte que o RuneTranslate lê primeiro.
O que o .locres não cobre: texto compilado em DataTables ou embutido em pacotes `.uasset` cozidos. Alguns estúdios, em especial em projetos menores ou muito movidos a Blueprint, guardam o diálogo ali, e não no sistema de localização. O RuneTranslate lê isso também. Quando um jogo não tem .locres próprio, ele descompacta os arquivos do jogo e varre os pacotes cozidos atrás de texto, o que leva minutos e não segundos em um jogo grande, e em jogos com arquivos .pak soltos ele também acrescenta o diálogo embutido que o .locres deixou escapar. A única lacuna: um jogo UE5 IoStore que distribui o próprio .locres recebe só o texto do .locres.
Vale saber cedo: a forma mais rápida de conferir é rodar a criação do projeto e olhar o que saiu. Algumas centenas de strings curtas, todas do tipo Continue, Options, Are you sure?, significam que a interface está localizada e o script não. Vários milhares de strings, com frases inteiras, significam que você está em boa situação.
O IoStore do UE5 é diferente, e a extração é direcionada
Títulos UE5 distribuem cada vez mais containers IoStore em vez de paks simples: um diretório .utoc acompanhado de um blob de dados .ucas, usando compressão Oodle. A abordagem ingênua aqui é descompactar tudo, o que num jogo de 105 GB nem chega a ser uma abordagem.
O RuneTranslate embute o retoc (licenciado sob MIT) e pede a ele que converta os containers para um pak legado filtrado só nos arquivos de localização — o equivalente a to-legacy -f locres --no-shaders --no-script-objects. Um título IoStore de 105 GB filtra para alguns kilobytes de .locres, em segundos e não em horas. O retoc também cuida da compressão Oodle do próprio container, e é por isso que jogos IoStore contornam o problema de Oodle que paks soltos podem ter.
A metade importante disso é que o IoStore só complica a leitura. A escrita é universal, e é o assunto da próxima seção.
A saída é um pak de override, não um jogo reconstruído
Essa é a parte que nenhum guia concorrente explica direito, e é o motivo de traduzir Unreal ser barato assim que funciona.
O Unreal monta os arquivos pak numa ordem definida, e qualquer arquivo cujo nome termine em `_P` é montado por último. As montagens posteriores vencem. Então um arquivo pequeno contendo nada além do seu .locres modificado, no mesmo caminho virtual que o jogo base usa, simplesmente sobrepõe o original — o gerenciador de localização carrega o seu e nunca vê o que veio no jogo.
- Sem re-assinar. O override deixa os arquivos do próprio jogo intocados, então não há nada a re-assinar.
- Um arquivo simples e sem compressão. O override é gravado como um pak comum, sem compressão, que o motor lê diretamente.
- Sem reempacotar o jogo. Os arquivos base ficam intocados. Uma instalação de 60 GB continua com 60 GB; sua tradução é um arquivo medido em kilobytes.
- Funciona para jogos IoStore também. O
.locresé lido pelo sistema de arquivos de pak, e não pelo carregador de pacotes Zen, então um_P.paksolto e comum é reconhecido até por um jogo UE5 cujos assets moram todos em.utoc/.ucas.
Você instala copiando o _P.pak produzido para <Game>/Content/Paks/ — a mesma pasta em que estão os originais. Alguns jogos também montam uma subpasta ~mods/, o que funciona igualmente bem. Remover a tradução é apagar aquele único arquivo, o que torna o rollback trivial e torna seguro testar cedo.
Os passos
- Instale o RuneTranslate pela página de download e entre na conta. É preciso entrar com uma conta gratuita (Patreon, Google ou e-mail) no primeiro início; o tier gratuito libera todos os motores e todos os provedores, exceto o RuneLingua — ele limita a velocidade e mantém um projeto por vez.
- Crie um novo projeto e aponte-o para a pasta raiz do jogo — aquela que contém o executável e o diretório
<Game>. A detecção procura porContent/Pakse pelo valor mágico do footer de pak, ou por.utoc/.ucas. - Deixe o RuneTranslate abrir os arquivos. A maioria dos jogos não precisa de nada da sua parte nesta etapa.
- Deixe a extração terminar. Você recebe as entradas
.locresda cultura de origem, agrupadas por alvo de localização, prontas para revisão. - Escolha um provedor e traduza. Strings curtas de interface e diálogos longos podem ir para provedores diferentes, se você quiser gastar dinheiro só onde importa.
- Revise o que voltou. Strings de menu são onde a tradução automática é mais fraca — um
SaveouLoadsozinho não tem contexto, e um botão de duas palavras que volta como uma frase vai estourar o widget. - Exporte. O RuneTranslate grava um
_P.pakcontendo o seu texto traduzido no caminho correto relativo ao motor, mais um README. Para os poucos jogos cujo motor nunca carrega paks de patch, ele também grava o texto como um.locressolto, e o README diz onde ele vai. - Copie esse arquivo para
<Game>/Content/Paks/e inicie o jogo.
Teste depois do passo 8 com um punhado de strings traduzidas, antes de passar o jogo inteiro por um provedor. Se o override for ser ignorado — pasta errada, cultura errada, montagem incomum —, você quer descobrir isso em cinco minutos, e não depois de pagar por 9.000 strings.
Placeholders e rich text
A formatação de FText do Unreal usa {0}, {1} para argumentos posicionais e {PlayerName}, {Count} para os nomeados, além da marcação <RichText> com fechamento </> para estilo inline. Se um provedor de tradução descarta ou corrompe um desses, o jogo não mostra uma frase levemente errada — ele mostra uma string de formato quebrada, ou o argumento some da linha em silêncio.
O RuneTranslate mascara cada um deles atrás de um placeholder neutro antes de o provedor ver a string, e os restaura depois. O provedor traduz em volta dos marcadores em vez de através deles, então um argumento não pode ser apagado por um modelo que achou que as chaves eram um erro de digitação. Se você quiser ir além e segurar strings específicas fora da tradução por completo, os filtros de exclusão por regex funcionam em qualquer motor, e um glossário mantém os nomes próprios estáveis no jogo inteiro.
A armadilha dos acentos, que é um bug de codificação e não de fonte
Esta merece documentação própria porque o sintoma aponta exatamente para o lado errado. O Unreal serializa uma string com um prefixo de tamanho: tamanho positivo significa um byte por caractere, tamanho negativo significa UTF-16. O motor escolhe a forma estreita só quando todo caractere é ASCII de 7 bits — a checagem dele rejeita qualquer coisa acima de 0x7F. O carregador foi feito do mesmo jeito, então, se receber uma string estreita contendo um byte alto, ele substitui cada um por um ? literal.
A consequência prática: uma tradução com poción mágica escrita na forma estreita chega ao jogador como poci?n m?gica. E a faixa afetada é U+0080–U+00FF, que é exatamente a das letras acentuadas do espanhol, do francês, do alemão, do português, do italiano e das línguas nórdicas. Polonês, turco, tcheco, grego, cirílico, japonês e chinês ficam todos acima de U+00FF, tomam o ramo largo automaticamente e nunca são afetados.
Então a assinatura é: os acentos quebram em espanhol, mas o russo está bem. Se você vir isso, é um bug de codificação em quem escreveu o arquivo, e não um glifo faltando na fonte do jogo — um glifo faltando aparece como um quadradinho ou como nada, nunca como uma interrogação. O RuneTranslate tinha exatamente esse bug e o corrigiu na 0.49.4; o codificador agora mora em um lugar só e grava a forma larga para qualquer coisa fora do ASCII. Vale conhecer porque outras ferramentas dessa área ainda erram nisso.
Escolhendo um provedor
Cinco dos doze provedores não exigem chave de API nenhuma (o Google, o DeepL gratuito, os modelos Classic/Next-gen do DeepL, o Yandex Translate e o Gemini Nano, que roda no seu próprio PC pelo Chrome), e o tier gratuito te dá todos eles. Para um jogo que é quase só interface, um provedor gratuito serve muito bem. Para títulos com muito diálogo, um provedor de LLM lida com contexto muito melhor; o OpenAI, o Anthropic, o DeepSeek, qualquer endpoint compatível com OpenAI e um modelo local via Ollama ou LM Studio estão todos disponíveis, e os planos pagos incluem ainda o RuneLingua, nosso tradutor próprio, sem nada para configurar. A comparação de provedores percorre no que cada um é bom e ruim, com números reais de custo.
Resolução de problemas
O jogo roda, mas nada está traduzido
Quase sempre é uma de três coisas. O arquivo não está em <Game>/Content/Paks/ — colocá-lo ao lado do executável não faz nada. O nome do arquivo perdeu o sufixo _P, caso em que ele monta na ordem alfabética comum e o pak base pode vencer. Ou o jogo está rodando numa cultura que você não traduziu: ele carrega o .locres da cultura que resolveu na inicialização, então um jogo que força en vai ignorar um override escrito só para ja. Confira antes de tudo o idioma configurado no jogo.
A extração falha num pak solto comprimido com Oodle
Um .pak solto comprimido com Oodle precisa de um descompressor que não pode ser embutido. Se o jogo também distribui containers IoStore, o caminho pelo retoc cuida do Oodle e você está bem. Se forem só paks soltos, isso é uma parada definitiva por enquanto, relatada de forma explícita e não como um resultado vazio silencioso.
O jogo não tem .locres em lugar nenhum
Então o texto dele está compilado em assets cozidos, e o RuneTranslate o lê de lá: ele descompacta os arquivos do jogo e varre os pacotes cozidos atrás de texto, o que pode levar alguns minutos em um jogo grande. Se isso também não achar nada, o RuneTranslate diz isso explicitamente, em vez de te entregar um projeto vazio.
A detecção não dispara
Aponte para a pasta que contém o executável, não para o Content/Paks em si e nem para uma pasta-mãe cheia de outros jogos. Se ainda assim não detectar, o empacotamento é incomum e vale relatar — o formato pak tem layouts de footer específicos por versão, e um dialeto que ninguém viu ainda é exatamente o tipo de coisa que acaba sendo adicionado.
Limites honestos
O suporte a Unreal foi confirmado jogável dentro do jogo em títulos UE4 e UE5, por meio de .locres dentro de arquivos .pak e do IoStore do UE5 e de texto lido de assets cozidos. Um jogo UE5 IoStore que distribui o próprio .locres recebe só esse texto, não o diálogo dos assets cozidos ao lado. Paks soltos comprimidos com Oodle sem um equivalente IoStore não são suportados. Paks com assinatura exigida não podem ser sobrepostos, embora sejam raros na prática. E como o formato varia tanto entre versões de motor e estúdios, trate a primeira exportação como um teste, e não como a entrega.
O que você acaba tendo é uma build traduzida e jogável que fica na sua máquina: o jogo original intocado, mais um arquivo pequeno que você pode apagar para desfazer tudo. Se você está comparando motores ou checando se o seu jogo é coberto, a página do motor Unreal tem o detalhe técnico e todos os motores lista os dezoito formatos suportados, incluindo Unity e RPG Maker. Se você é novo em todo esse processo, comece com o guia geral e volte aqui para as partes específicas do Unreal.
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
