Como traduzir uma visual novel Kirikiri / KAG para o português

O Kirikiri (吉里吉里) e sua camada de cenário KAG movem uma enorme fatia das visual novels japonesas — incluindo a maior parte do catálogo bishoujo comercial. O problema: o Kirikiri empacota seus scripts, arte e áudio em arquivos .xp3 criptografados, e muitos estúdios aplicam um esquema de criptografia por jogo por cima. É por isso que o Kirikiri tem fama de ser difícil de traduzir. Este guia percorre como fazê-lo de ponta a ponta com o RuneTranslate: lendo o .xp3, lidando com a criptografia, traduzindo os cenários KAG .ks e exportando um patch que o jogo carrega automaticamente.

O que você precisa

• RuneTranslate para Windows — gratuito, todos os motores e provedores desbloqueados.
• Uma pasta de jogo Kirikiri — o diretório com o .exe do jogo e um ou mais arquivos .xp3 (comumente data.xp3, scenario.xp3, etc.). Builds KirikiriZ assinadas com arquivos .exe.emb / .xp3.sig também são reconhecidas.
• 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. As visual novels têm muitos diálogos, então um LLM (OpenAI / Anthropic) ou o DeepL geralmente lê melhor; o Google Translate gratuito funciona de imediato.

Passo 1: Abra o jogo e descompacte o XP3

Inicie o RuneTranslate, clique em Novo projeto e aponte-o para o diretório do jogo Kirikiri. A detecção de motor roda automaticamente. O leitor XP3 integrado abre o índice do arquivo — incluindo o cabeçalho de índice comprimido de 17 bytes que arquivos grandes usam — e extrai os arquivos de cenário. Seus arquivos originais nunca são modificados.

Se o arquivo estiver criptografado, o RuneTranslate tenta descriptografá-lo com uma biblioteca de cerca de duas dúzias de esquemas de criptografia GARbro portados, mais um solver de força bruta genérico de XOR de byte único para embaralhamentos por arquivo mais simples. A maioria dos jogos comerciais se encaixa em um deles. Esquemas que precisam de estado de tempo de execução por arquivo ou de uma chave mantida pelo estúdio permanecem sem suporte — esses são os casos genuinamente trancados.

Passo 2: Como o diálogo do Kirikiri é extraído

O Kirikiri armazena o diálogo em scripts de cenário KAG .ks. O RuneTranslate os analisa e lista o texto traduzível no editor:

• Diálogo e narração — as linhas brutas do cenário.
• Extração inteligente de atributos — texto legível dentro de tags como [ruby/], [ch text="..."], [name text="..."] e [button text="..."] é extraído e traduzido, enquanto a própria estrutura da tag é preservada.

As tags de controle inline do KAG são mascaradas atrás de placeholders numéricos [[K#]] antes de qualquer coisa chegar ao provedor, para que a máquina não possa quebrar a formatação do motor. Alguns jogos KirikiriZ também distribuem seu cenário como um binário PSB .scn compilado (o formato PSB\0) — o RuneTranslate analisa e reempacota cenários PSB não criptografados (versões de formato 1 a 4) também, então esses jogos traduzem como scripts de texto.

Passo 3: Traduza e revise

Escolha um provedor e rode. Para voz de personagem e falas estilizadas, um LLM como o OpenAI ou o Anthropic lê melhor; o DeepL é rápido e limpo para narração; o Google Translate gratuito cobre menus. Coloque seu elenco e termos recorrentes no glossário primeiro para que cada rota renderize os nomes de forma idêntica — veja o Glossário 101. No tier gratuito a tradução é levemente limitada — cerca de 2x mais lenta nos provedores de IA, menos nos scrapers gratuitos — com qualidade de saída idêntica; os tiers pagos rodam em velocidade máxima e adicionam memória de tradução.

Cada linha chega ao editor ao lado de sua origem. Edite inline (salva ao desfocar ou com Ctrl+Enter), use localizar e substituir, ou rode o refinador por IA opcional para uma revisão de segunda passagem com reconhecimento de contexto — valioso em rotas longas de VN.

Passo 4: Exporte um patch

Clique em Exportar. O RuneTranslate escreve o cenário traduzido como arquivos soltos mais um hook de inicialização e, onde ajuda, um patch.xp3 plano. Ele usa dois caminhos de sobreposição porque nenhum sozinho é universal:

• Arquivos soltos + hook de inicialização — a chamada addAutoPath do hook eleva os arquivos soltos acima dos arquivos do jogo. Como builds diferentes rodam um ponto de entrada de init diferente, o RuneTranslate escreve o hook sob todos os três nomes que os jogos usam — AfterInit2.tjs, xAfterInit2.tjs e xAfterInit.tjs — para que qualquer um que o jogo chame o capture.
• patch.xp3 — o Kirikiri monta automaticamente patch.xp3 / patch2.xp3 com prioridade mais alta que os próprios arquivos do jogo ("caminhos posteriores vencem"), então ele sobrepõe até quando um jogo desativa o hook de inicialização. Em builds criptografadas suas entradas são pré-criptografadas com o próprio esquema do jogo. Note que builds que impõem assinaturas de arquivo rejeitam um patch.xp3 extra, então nelas o hook de arquivos soltos é o caminho que carrega a tradução.

A saída é a sua tradução colocada ao lado do jogo original. Inicie o .exe e ele joga no seu idioma de destino.

Limitações conhecidas

• XP3 criptografado com um esquema por jogo que precisa de estado de tempo de execução, tabelas de consulta ou uma chave mantida pelo estúdio não é suportado — cerca de duas dúzias de esquemas GARbro mais um solver de força bruta XOR estão integrados, o que cobre a maioria dos jogos comerciais mas não todos os casos.
• Cenários PSB .scn criptografados / comprimidos com MDF são pulados; apenas PSB não criptografado (versões 1–4) é suportado.
• Bytecode KAG .ks compilado ou tokenizado (binário / magic jk que não descrambleia para texto) é pulado — apenas scripts KAG legíveis e cenários PSB não criptografados são analisados.
• Texto em imagem (logos, interface desenhada à mão, legendas de CG) não é traduzido — fora do escopo da tradução automática.

Por que isto é mais fácil do que o jeito antigo

A rota manual significava identificar o esquema de criptografia, extrair o XP3 com o GARbro, encontrar à mão o texto legível dentro das tags KAG, traduzi-lo sem quebrar a marcação, e então reempacotar ou configurar um caminho de sobreposição corretamente. O RuneTranslate dobra toda a cadeia — descriptografar, extrair, mascarar tags, traduzir, construir tanto o hook de arquivos soltos quanto o patch.xp3 — em alguns cliques, com o editor aberto para você controlar as palavras.

Veja a página do motor Kirikiri para a lista completa de recursos, leia o guia de Ren'Py para outro motor de visual novel, ou baixe o RuneTranslate e experimente em um jogo real.