Como traduzir um jogo TyranoBuilder / TyranoScript para o português

O TyranoBuilder e o motor TyranoScript subjacente movem um grande catálogo de visual novels indie japonesas — a alternativa em tecnologia web (HTML5 / JavaScript) ao Kirikiri e ao Ren'Py, distribuída ou como pastas HTML5 independentes ou como executáveis embrulhados em Electron. Seus cenários usam a mesma sintaxe .ks no estilo KAG que o Kirikiri, então o texto é fácil de alcançar quando você sabe onde ele mora. Este guia percorre a tradução de um jogo TyranoBuilder de ponta a ponta com o RuneTranslate, incluindo a parte que a maioria das ferramentas erra: os nomes de exibição de personagens.

O que você precisa

• RuneTranslate para Windows — gratuito, todos os motores e provedores desbloqueados.
• Um jogo TyranoBuilder: uma pasta HTML5 independente (diretórios data/ e tyrano/ soltos) ou uma build Electron (um resources/app.asar contendo tyrano/tyrano.js e data/scenario/*.ks). O RuneTranslate detecta ambos.
• Um idioma de destino — português, inglês, espanhol, francês, alemão, chinês, e mais de 30 outros.
• Um provedor. As visual novels têm muitos diálogos, então um LLM (OpenAI / Anthropic) ou o DeepL lê melhor; o Google Translate gratuito funciona de imediato.

Passo 1: Abra a pasta do jogo

Inicie o RuneTranslate, clique em Novo projeto e aponte-o para o diretório do jogo (ou a pasta que contém o .exe para builds Electron). A detecção reconhece o TyranoBuilder por seu runtime tyrano/ mais os scripts data/scenario/; para builds Electron ele lê o app.asar diretamente, então você nunca descompacta nada. Seu jogo original nunca é modificado.

Passo 2: Como as strings são extraídas

O RuneTranslate extrai texto traduzível de todo lugar em que o TyranoBuilder o armazena:

• Scripts de cenário — cada arquivo data/scenario/**/*.ks, incluindo _preview.ks e os espelhos system/_*.ks dos quais builds criptografadas dependem.
• Interface e config — tyrano/lang.js e data/system/Config.tjs.
• Nomes de exibição de personagens — os rótulos de falante mostrados acima dos diálogos (próxima seção).

As tags inline do KAG — quebras de linha [r], click-waits [p], quebras de página [改ページ], [font color=...] e tags com nome em japonês — são mascaradas atrás de placeholders numéricos [[U#]] antes de qualquer coisa chegar ao provedor, e então restauradas na exportação, para que a formatação sobreviva intacta. Arquivos .ks binários ou criptografados são detectados por uma checagem de UTF-8 e nunca sobrescritos.

Passo 3: Nomes de personagens — a parte específica do Tyrano

Os cenários frequentemente se dirigem a um falante com uma abreviação inline como [yuki] — um ID de personagem, não texto de exibição. O RuneTranslate nunca reescreve essas referências (isso quebraria a busca de personagem do motor e travaria a cena). Em vez disso, ele traduz o nome de exibição e injeta uma entrada [chara_new name=... jname=...] apropriada em data/system/chara_define.ks na exportação. O nome mostrado na tela é traduzido; o ID que o script usa permanece intocado.

Passo 4: Traduza e revise

Escolha um provedor e rode. Um LLM (OpenAI / Anthropic) lê melhor para voz de personagem; 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 os nomes sejam renderizados de forma idêntica em cada rota — veja o Glossário 101. 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 segunda passagem com reconhecimento de contexto. O tier gratuito é levemente limitado na velocidade — cerca de metade do throughput pago nos provedores de IA — com qualidade de saída idêntica.

Passo 5: Exporte uma build jogável

Clique em Exportar. Para jogos HTML5 independentes, o RuneTranslate escreve os scripts .ks traduzidos, o lang.js, a config e o chara_define.ks injetado em uma cópia do jogo. Para builds Electron ele reempacota um app.asar modificado. De qualquer forma, você recebe uma cópia completa e executável no local que você escolher — inicie-o e ele joga no seu idioma de destino.

Limitações conhecidas

• Arquivos .ks criptografados (detectados como não-UTF-8) são deixados intocados, então cenários em uma build criptografada não vão traduzir.
• Texto em imagem (logos, interface desenhada à mão, legendas de CG) está fora do escopo da tradução automática.
• Plugins personalizados que constroem diálogos em tempo de execução podem precisar de uma correção manual rápida no editor.

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

A rota manual significava descompactar o app.asar, encontrar cada arquivo .ks (incluindo os espelhos de sistema fáceis de perder), traduzir em torno das tags KAG à mão, descobrir a injeção de nome de personagem, e então reempacotar o asar sem corrompê-lo. O RuneTranslate dobra toda a cadeia em alguns cliques, com o editor aberto para você controlar as palavras.

Veja a página do motor TyranoBuilder para a lista completa de recursos, leia o guia de Kirikiri para o motor KAG relacionado, ou baixe o RuneTranslate e experimente em um jogo real.