kirikiri · tutorial · engine

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

Traduza visual novels Kirikiri / KAG para o português com o RuneTranslate — lendo arquivos .xp3 empacotados automaticamente, traduzindo cenários KAG .ks e cenas PSB, e exportando um patch.xp3 que o jogo carrega automaticamente.

6 min de leitura

O Kirikiri (吉里吉里) e sua camada de cenário KAG movem uma enorme fatia das visual novels japonesas. O problema: o Kirikiri empacota seus scripts, arte e áudio em arquivos .xp3, e muitos estúdios usam por cima a sua própria variante de arquivo. É 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, traduzindo os cenários KAG .ks e exportando um patch que o jogo carrega automaticamente.

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 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.

Os arquivos empacotados são abertos automaticamente, incluindo, para os títulos que o RuneTranslate reconhece, o formato mais novo que alguns lançamentos recentes usam. Alguns formatos raros ainda não são reconhecidos.

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 padrão (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 provedores 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. O patch é gravado em uma forma que o jogo aceita. Algumas builds recusam 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

  • Um formato raro de arquivo empacotado que o app ainda não reconhece não é suportado. A maioria dos jogos comerciais abre, mas não todos os casos atípicos.
  • Cenários PSB .scn fora do padrão / comprimidos com MDF são pulados; apenas PSB padrão (versões 1–4) é suportado.
  • Bytecode KAG .ks compilado ou tokenizado (binário / magic jk que não se decodifica para texto) é pulado — apenas scripts KAG legíveis e cenários PSB padrão são analisados.
  • Texto em imagem (logos, interface desenhada à mão, legendas de CG) não faz parte dos scripts; traduza-o no Image Studio, que lê as imagens direto dos arquivos XP3 (TLG incluído) e entrega a arte traduzida da mesma forma que os scripts.

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

A rota manual significava identificar o formato do arquivo, extrair o XP3 com uma ferramenta de descompactação à parte, 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 — desempacotar, 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.

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