Engine suportado · RPG Maker XP / VX / VX Ace
Tradutor de RPG Maker XP, VX e VX Ace — a geração Ruby / RGSS
RPG Maker XP, VX e VX Ace são a geração Ruby do RPG Maker — RGSS1, RGSS2 e RGSS3 — e guardam os dados do jogo em um formato completamente diferente do MV e do MZ, que são baseados em JavaScript. Em vez de JSON legível, tudo mora em binários Ruby Marshal dentro de Data/: Map001.rxdata no XP, .rvdata no VX, .rvdata2 no VX Ace, ao lado dos arquivos de banco de dados e do System. Um jogo lançado normalmente traz esses arquivos dentro de um arquivo RGSSAD — Game.rgssad (XP), Game.rgss2a (VX) ou Game.rgss3a (VX Ace) — ao lado do executável. O RuneTranslate cuida das duas camadas sozinho, em Rust puro. Ele lê o arquivo diretamente, sem instalar Ruby, sem o editor do RPG Maker e sem nenhuma ferramenta de descompactação separada, e interpreta os dados Marshal 4.8 lá dentro com um leitor e um escritor próprios que reescrevem apenas as folhas de string — floats, tabelas e todo outro corpo de objeto são reemitidos byte a byte, então o arquivo que o jogo carrega é estruturalmente o mesmo que ele trouxe de fábrica. Daí em diante ele puxa os diálogos dos eventos de mapa (empacotados no código de evento 101 no XP, 401 e 405 no VX e no VX Ace), as listas de Mostrar escolhas, nomes de eventos e de mapas, o banco de dados — nomes, apelidos, descrições e anotações de atores, itens, habilidades, armas, armaduras, inimigos e estados — e o vocabulário do System, mais os nomes de elementos. Códigos de controle como \C[1], \N[2] e \V[3] são mascarados antes de o texto chegar a um provedor, e os diálogos recebem quebra de linha na exportação para caberem na janela de mensagem. Uma ressalva dita sem rodeios: o VX Ace roda Ruby 1.9 e marca cada string com a codificação dela, então é Unicode de ponta a ponta. XP e VX rodam Ruby 1.8 e guardam texto sem marcação de codificação, então o RuneTranslate descobre por jogo se é Shift-JIS ou UTF-8. Um jogo guardado como UTF-8 mantém todas as letras da sua tradução; em um jogo Shift-JIS, letras que essa codificação não comporta (acentos, tailandês, árabe e afins) são simplificadas ou perdidas, então destinos em inglês e romaji são a escolha mais segura ali. A geração mais nova, MV e MZ, está coberta na página do RPG Maker MV / MZ.
Os jogos RPG Maker da era Ruby são longos e repetem os mesmos substantivos em todo canto — um nome de habilidade escrito em um evento reaparece no banco de dados, no log de batalha e num menu de loja. Adicione os nomes do grupo, os nomes de cidades, os itens-chave e as habilidades marcantes ao glossário uma vez e todo provedor vai renderizá-los de forma idêntica em toda a pasta Data/. Isso pesa mais no XP e no VX do que no VX Ace, porque o texto Shift-JIS deles deixa menos margem para notar um nome que derivou na metade de um jogo de 40 horas.
Como traduzir RPG Maker XP / VX / VX Ace
- PASSO 1
Descubra qual geração você tem
Abra a pasta do jogo e olhe Data/. Arquivos terminados em .rxdata significam RPG Maker XP, .rvdata significam VX e .rvdata2 significam VX Ace. Se não houver Data/, procure ao lado do executável por Game.rgssad (XP), Game.rgss2a (VX) ou Game.rgss3a (VX Ace) — os dados estão dentro desse arquivo. Se em vez disso você vir www/data/*.json ou data/*.json, você tem MV ou MZ; use a página do RPG Maker MV / MZ para esses casos.
- PASSO 2
Crie um projeto na pasta do jogo
Inicie o RuneTranslate, clique em Novo projeto e aponte para a pasta que contém o executável do jogo. A detecção é automática e informa qual das três versões encontrou e se os dados estão soltos ou dentro do arquivo. Um arquivo RGSSAD é lido diretamente e seus arquivos de Data são desempacotados em um espaço de trabalho por projeto — nenhum runtime Ruby e nenhum descompactador externo entram na história.
- PASSO 3
Escolha um idioma de destino e um provedor
Escolha o idioma de destino e depois um provedor: o Google e as opções gratuitas do DeepL não precisam de chave de API nenhuma, a API do DeepL entrega qualidade equilibrada, e o OpenAI, o Anthropic Claude, o DeepSeek, qualquer endpoint compatível com OpenAI ou um modelo local via Ollama ou LM Studio lidam com diálogos longos usando contexto. O japonês é o idioma de origem padrão; qualquer origem suportada pode ser definida por projeto.
- PASSO 4
Traduza e revise no editor
O RuneTranslate manda as strings em lotes para o provedor e grava tudo de volta no projeto. Diálogos de mapa, escolhas, entradas do banco de dados e termos de System ficam agrupados para você revisar um mapa ou uma tabela do banco de dados por vez, editar qualquer linha à mão e repetir lotes que falharam. Os códigos de controle ficam mascarados o tempo todo, então \C[1], \N[2] e \V[3] sobrevivem intactos à ida e à volta.
- PASSO 5
Exporte uma build traduzida jogável
A exportação escreve uma cópia completa e executável do jogo com os dados Marshal traduzidos no lugar. Em um jogo empacotado, o arquivo RGSSAD é desempacotado em arquivos soltos em Data/ e o próprio arquivo compactado é descartado, que é como o RGSS carrega um jogo sem arquivo presente. Os diálogos recebem quebra de linha na saída. O resultado é uma build traduzida jogável que fica com você, com o original intocado.
Suporta
- RPG Maker XP (Data/*.rxdata), VX (.rvdata) e VX Ace (.rvdata2)
- Arquivos RGSSAD — .rgssad, .rgss2a e .rgss3a — lidos diretamente em Rust puro, sem instalar Ruby e sem descompactador separado
- Leitor e escritor próprios de Ruby Marshal 4.8: só as folhas de string mudam, todo outro corpo de objeto é reemitido literalmente
- Diálogos de eventos de mapa (código de evento 101 no XP; 401 e 405 no VX e no VX Ace) e listas de Mostrar escolhas (código 102)
- Texto do banco de dados: nomes, apelidos, descrições e anotações de atores, itens, habilidades, armas, armaduras, inimigos e estados, além das mensagens de estado
- Eventos comuns, texto de eventos de batalha de tropas, nomes de eventos e nomes de mapas do MapInfos
- Termos e vocabulário do System (@terms no VX e no VX Ace, @words no XP) e nomes de elementos
- Códigos de controle \C[n], \N[n], \V[n] mascarados durante a tradução; diálogos com quebra de linha na exportação
Limitações
- XP e VX guardam texto sem marcação de codificação (Ruby 1.8), então o RuneTranslate detecta por jogo se é Shift-JIS ou UTF-8. Em um jogo Shift-JIS, letras que essa codificação não comporta (acentos, tailandês, árabe e afins) são simplificadas ou perdidas, então destinos em inglês e romaji são a escolha mais segura ali. O VX Ace é Unicode de ponta a ponta.
- Os Ruby Scripts (Scripts.rxdata / .rvdata / .rvdata2) não são extraídos — texto de interface fixo nos scripts do próprio jogo continua no idioma de origem. Eventos de mapa, banco de dados e termos de System são cobertos.
- Os arquivos RGSSAD são desempacotados, não reconstruídos: a exportação é uma cópia completa e executável com arquivos soltos e sem o arquivo compactado, não um arquivo reempacotado.
- O menu de cheats dentro do jogo é um recurso de MV e MZ e não vale para XP, VX ou VX Ace. O editor de saves abre os saves .rxdata / .rvdata / .rvdata2 deles (ouro, variáveis e switches).
- MV e MZ usam um formato completamente diferente (JSON em www/data ou data) e estão cobertos na página do RPG Maker MV / MZ.

