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.
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
.exedo jogo e um ou mais arquivos.xp3(comumentedata.xp3,scenario.xp3, etc.). Builds KirikiriZ assinadas com arquivos.exe.emb/.xp3.sigtambé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
addAutoPathdo 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.tjsexAfterInit.tjs— para que qualquer um que o jogo chame o capture. - patch.xp3 — o Kirikiri monta automaticamente
patch.xp3/patch2.xp3com 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 umpatch.xp3extra, 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
.scnfora do padrão / comprimidos com MDF são pulados; apenas PSB padrão (versões 1–4) é suportado. - Bytecode KAG
.kscompilado ou tokenizado (binário / magicjkque 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.
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
