Engine suportado · YU-RIS
Tradutor do engine YU-RIS — traduza visual novels JP da raiL-soft de ponta a ponta
YU-RIS (por raiL-soft) é um engine de scripting Windows de longa data por trás de centenas de visual novels japonesas indie e comerciais. Seus recursos ficam em arquivos de pacote .ypf, e o cenário é compilado em scripts YSTB (os arquivos .ybn dentro de ysbin.ypf, em caminhos internos como ysbin/yst00000.ybn). O RuneTranslate lê os pacotes .ypf em Rust puro — sem ferramentas externas — descomprimindo entradas, e depois analisa os scripts YSTB compilados: ele divide as quatro seções (instruções, descritores de argumento, valores de string, números de linha) e os decodifica automaticamente, sem nada para configurar. A partir daí ele extrai o diálogo em japonês da tabela de strings e lista cada linha no editor, deixando os operandos de comando do engine, nomes de variáveis e caminhos de asset excluídos por padrão para que você nunca traduza algo que a lógica do script compara. Na exportação ele reconstrói a tabela de strings — corrigindo cada offset para que traduções mais longas ou mais curtas caibam — o codifica de novo da mesma forma e grava o .ybn traduzido solto no seu caminho de arquivo. Como o runtime do YU-RIS lê um arquivo solto no disco com preferência sobre o mesmo caminho empacotado em um .ypf, o jogo simplesmente carrega sua tradução — não há reempacotamento. Ele está confirmado dentro do jogo em um título real, mas o YU-RIS varia conforme o lançamento, então teste a build exportada antes de contar com ele.
Visual novels se apoiam em um elenco fixo e terminologia recorrente ao longo de milhares de linhas, e a tradução automática vai escrever o nome de uma heroína de três formas diferentes em três capítulos. Coloque seus personagens, nomes de lugares e termos recorrentes no glossário logo de início, para que cada linha de diálogo os renderize de forma idêntica.
Como traduzir YU-RIS
- PASSO 1
Abra a pasta do jogo YU-RIS
Aponte o RuneTranslate para o diretório do jogo — a pasta com o yu-ris.exe do jogo e seus pacotes .ypf (geralmente em uma subpasta pac/, com os scripts em ysbin.ypf). Se os scripts do jogo já estiverem desempacotados, uma pasta ysbin/ solta de scripts .ybn também é detectada. A detecção do engine reconhece o layout do YU-RIS automaticamente; sua pasta original nunca é modificada.
- PASSO 2
Leia os pacotes .ypf e decodifique os scripts YSTB
O RuneTranslate abre os pacotes .ypf em Rust puro, descomprime as entradas e analisa os scripts YSTB compilados lá dentro. Ele decodifica cada script automaticamente, sem nada para configurar, lê a tabela de strings Shift-JIS e lista cada linha em japonês no editor, agrupada por arquivo de script. Operandos de comando do engine, nomes de variáveis e caminhos de asset são exibidos mas excluídos por padrão para que a lógica da história fique intacta.
- PASSO 3
Traduza via seu provedor preferido
Esses jogos são cheios de diálogo e sensíveis ao tom, então um LLM (OpenAI GPT-4o / Anthropic Claude) ou o DeepL costuma ler melhor; o Google Translate grátis ou um modelo local (Ollama / LM Studio) cobre strings curtas de menu e escolhas, e você pode apontar o provedor compatível com OpenAI para o OpenRouter ou NanoGPT. Uma segunda passada opcional do AI-refiner aperta o fraseado literal.
- PASSO 4
Mantenha os códigos de controle inline intactos
O texto de mensagem do YU-RIS costura códigos de controle com barra invertida (nova linha, cor, ruby) e tags entre colchetes através do diálogo. O RuneTranslate congela cada um deles como placeholders numéricos durante a tradução e os restaura na saída, então a linha traduzida mantém a mesma formatação e o mesmo ritmo do original.
- PASSO 5
Exporte com override de arquivo solto (sem reempacotar)
Na exportação, o RuneTranslate copia o jogo e reconstrói cada script YSTB traduzido — corrigindo os offsets da tabela de strings para que a tradução de qualquer tamanho caiba e recodificando-o da mesma forma — e depois o grava solto no seu caminho original de arquivo (ex.: ysbin/yst00000.ybn). O runtime do YU-RIS prefere um arquivo solto ao mesmo caminho empacotado em um .ypf, então o jogo apenas lê sua tradução sem reempacotamento. Rode a cópia exportada e ela roda no seu idioma.
Suporta
- Leitor de pacote .ypf em Rust puro (com descompressão), sem ferramentas externas ou sidecars
- Scripts de cenário YSTB .ybn compilados analisados em Rust puro (instruções / descritores / tabela de strings / números de linha)
- Scripts YSTB compilados decodificados automaticamente, sem nada para configurar
- Diálogo em japonês extraído da tabela de strings; operandos de comando / nomes de variáveis / caminhos de asset excluídos por padrão
- Reconstrução da tabela de strings com correção completa de offsets, para que traduções mais longas ou mais curtas caibam
- Exportação por override de arquivo solto — .ybn traduzido colocado no seu caminho de arquivo, sem reempacotar
- Traduza para 30+ idiomas via DeepL, Google, OpenAI, Anthropic, compatível com OpenAI ou modelos locais
Limitações
- Confirmado dentro do jogo em um título real, mas os lançamentos variam, então teste a build exportada antes de contar com ela
- As strings do YU-RIS são Shift-JIS (cp932): inglês e outros alvos representáveis em cp932 funcionam; scripts não-cp932 (ex.: cirílico estendido, coreano, chinês tradicional) precisam de um ajuste de fonte/codificação do jogo que ainda não é automatizado
- Texto embutido em imagens (telas de título, menus, botões) não faz parte dos scripts; o fluxo de OCR de texto em imagem alcança apenas imagens que o jogo mantém como arquivos soltos, não as empacotadas em um .ypf
- A tagueação de mensagem por comando via a tabela de comandos YSCM é um refinamento planejado; por enquanto cada string em japonês em um script de cenário é oferecida, com strings não exibíveis excluídas por heurística

