rpg-maker · tutorial

Tradução RPG Maker MV vs MZ: o que muda para tradutores

Os dois motores compartilham a maior parte da superfície de tradução, mas os parâmetros de plugin, os códigos de controle e o layout da pasta de dados mudam no MZ. Notas práticas para tradutores que alternam entre projetos RPG Maker MV e MZ.

5 min de leitura

Para a tradução RPG Maker MV vs MZ, os dois motores são 90% iguais. Ambos armazenam diálogos, escolhas, itens, habilidades e termos como JSON, usam os mesmos códigos de comando de evento e honram os mesmos códigos de controle (\C[1], \N[2], \V[3], etc.). Os 10% restantes — layout de pasta e formato de parâmetro de plugin — são o que confunde os tradutores quando eles alternam entre os dois. Este post é uma referência rápida.

Layout de pasta: a diferença mais visível

  • MV armazena dados em www/data/*.json, com assets, plugins e o runtime empacotado ao lado.
  • MZ descarta o invólucro www/ e armazena dados em data/*.json diretamente.

Para o RuneTranslate isso é invisível — a detecção checa ambos os caminhos e escolhe o que existir. Só importa se você inspecionar um arquivo à mão: lembre do prefixo.

Diálogos, escolhas e códigos de evento

A estrutura de comandos de evento é a mesma nos dois motores, então a superfície de tradução é idêntica. O RuneTranslate lê:

  • 401 — uma linha de Mostrar Texto. Cada linha visível é seu próprio 401.
  • 405 — uma linha de Mostrar Texto Rolante (créditos, longos rolar de monólogos).
  • 102 — texto de opção de escolha (e 402, o rótulo do ramo de cada escolha).
  • 320, 324, 325 — Alterar Nome, Apelido e Perfil do Ator (usados para renomeações e biografias de personagens).
  • 108 / 408 — comentários. A maioria não é voltada ao jogador, então são excluídos por padrão (você pode incluir uma linha); a exceção é o texto de comentário que os plugins VisuStella mostram como rótulos de evento e pop-ups, que é traduzido como qualquer outra linha.

O RuneTranslate analisa todos esses de forma idêntica entre MV e MZ. No MZ, o 101 também carrega o nome do falante mostrado acima da caixa de mensagem, que também é capturado.

Quebra de linha para a caixa de mensagem

Tanto MV quanto MZ quebram os diálogos na borda da janela de mensagem — a caixa padrão comporta cerca de 46 caracteres de byte único por linha. O RuneTranslate quebra os diálogos automaticamente na exportação (aplicado às linhas 401 / 405) para que o texto traduzido não estoure a caixa de fala.

A largura de quebra é configurável em Configurações > Engines — aumente-a para uma janela mais larga, ou desative a quebra inteiramente para um jogo que lida com suas próprias quebras de linha. O RuneTranslate também acrescenta uma opção de ajuste automático na exportação (MV e MZ) que reduz um pouco a fonte da janela, para que um texto de menu e de interface um pouco longo caiba na caixa em vez de ser cortado.

Strings de parâmetro de plugin

Ambos os motores armazenam a configuração de plugin em js/plugins.js (sob www/ no MV) como um bloco PluginManager.parameters por plugin, com strings visíveis inline.

O RuneTranslate traduz os valores de parâmetro cujas chaves se leem como texto de exibição (text, message, label, caption, title, description, tooltip, button, menu e similares, incluindo chaves que terminam em Text ou Label), e abre estruturas de parâmetro aninhadas codificadas em JSON para que cada linha dentro delas seja uma linha própria. Valores que são código, nomes de arquivo, escolhas fixas ou configurações de plugins desligados ficam intactos, e o texto de interface que os plugins do próprio jogo desenham direto do código também é listado. Qualquer coisa que ele não traduz automaticamente continua sendo uma linha excluída que você pode incluir, então nada é perdido silenciosamente.

Códigos de controle: idênticos, nunca os deixe se perder

Ambos os motores suportam a mesma família de códigos de controle:

  • \C[n] — troca a cor do texto para o índice de paleta n.
  • \N[n] — imprime o nome do ator n.
  • \V[n] — imprime o valor da variável de jogo n.
  • \., \|, \^ — modificadores de pausa / espera.

Estes precisam sobreviver à tradução literalmente. Se um provedor descarta ou corrompe \N[1], o jogo imprime lixo de barra invertida bruta em vez do nome do jogador. O RuneTranslate mascara cada código de controle com um placeholder opaco antes de enviar ao provedor, e então os restaura exatamente — e se algum placeholder falhar no round-trip, a unidade é marcada como falha para que o texto original permaneça.

Exes empacotados (Enigma Virtual Box)

Alguns jogos MV/MZ vêm com a pasta data/ empacotada dentro do .exe via Enigma Virtual Box, então não há arquivos JSON soltos para apontar uma ferramenta. O RuneTranslate os detecta, descompacta os dados embutidos com um sidecar embutido e os traduz normalmente — a exportação escreve uma cópia completa, descompactada e executável com a data/ traduzida aplicada.

Dicas práticas de fluxo de trabalho

  • Não edite os arquivos JSON à mão. Use o editor integrado para correções manuais — ele rastreia quais unidades você editou para que rodar o tradutor de novo preserve seu trabalho.
  • Traduza os parâmetros de plugin por último. A maioria é texto de config / interface; rode os diálogos primeiro, e então os plugins em uma passagem separada com um provedor barato.
  • Mantenha os saves entre retraduções. O RPG Maker carrega saves por índice de linha de dados, não por string, então desde que você não reordene eventos, os jogadores mantêm seus saves em uma retradução.

Para o tutorial completo de RPG Maker, veja a página do motor RPG Maker, ou baixe o RuneTranslate (gratuito — todos os motores e todos os provedores, exceto o RuneLingua, incluídos) e experimente no seu jogo. Para comparar provedores para RPG Maker, veja Os melhores provedores para traduzir jogos japoneses.

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