Поддерживаемый движок · RPG Maker XP / VX / VX Ace
Переводчик RPG Maker XP, VX и VX Ace — поколение Ruby / RGSS
RPG Maker XP, VX и VX Ace — это Ruby-поколение RPG Maker, то есть RGSS1, RGSS2 и RGSS3, — и они хранят игровые данные в совершенно ином формате, чем MV и MZ на JavaScript. Вместо читаемого JSON всё лежит в бинарниках Ruby Marshal внутри Data/: Map001.rxdata на XP, .rvdata на VX, .rvdata2 на VX Ace, рядом с файлами базы данных и System. В released-сборке эти файлы обычно упакованы в архив RGSSAD — Game.rgssad (XP), Game.rgss2a (VX) или Game.rgss3a (VX Ace), — лежащий рядом с исполняемым файлом. RuneTranslate работает с обоими слоями сам, на чистом Rust. Он читает архив напрямую — без установленного Ruby, без редактора RPG Maker и без отдельной утилиты распаковки — и разбирает данные Marshal 4.8 внутри собственными ридером и райтером, которые переписывают только строковые листья: числа с плавающей точкой, таблицы и тела всех остальных объектов переиздаются байт в байт, так что файл, который загружает игра, структурно тот же, с каким она вышла. Дальше он вытаскивает диалоги событий карт (код события 101 на XP, 401 и 405 на VX и VX Ace), списки Show Choices, имена событий и названия карт, базу данных — имена, прозвища, описания и заметки персонажей, предметов, навыков, оружия, брони, врагов и состояний — и словарь System вместе с названиями стихий. Управляющие коды вроде \C[1], \N[2] и \V[3] маскируются до того, как текст уйдёт провайдеру, а диалоги при экспорте переносятся по словам, чтобы помещаться в окно сообщения. Одна оговорка прямым текстом: VX Ace работает на Ruby 1.9 и помечает каждую строку её кодировкой, то есть он полностью в Unicode. XP и VX работают на Ruby 1.8 и хранят текст без тега кодировки, поэтому RuneTranslate определяет для каждой игры, Shift-JIS это или UTF-8. Игра в UTF-8 сохраняет каждую букву вашего перевода; в игре на Shift-JIS буквы, которые эта кодировка вместить не может (акценты, тайский, арабский и подобные), упрощаются или теряются, поэтому там безопаснее всего цели «английский» и ромадзи. Более новое поколение MV и MZ описано на странице RPG Maker MV / MZ.
Игры RPG Maker на Ruby длинные, и одни и те же существительные повторяются повсюду: название навыка, написанное в одном событии, всплывает снова в базе данных, в боевом логе и в меню магазина. Внесите имена группы, названия городов, ключевые предметы и фирменные навыки в глоссарий один раз — и каждый провайдер передаст их одинаково по всей папке Data/. На XP и VX это важнее, чем на VX Ace: их текст в Shift-JIS оставляет меньше шансов заметить имя, которое поплыло на середине 40-часовой игры.
Как перевести RPG Maker XP / VX / VX Ace
- ШАГ 1
Определите, какое у вас поколение
Откройте папку игры и посмотрите на Data/. Файлы с расширением .rxdata означают RPG Maker XP, .rvdata — VX, а .rvdata2 — VX Ace. Если папки Data/ нет, поищите рядом с исполняемым файлом Game.rgssad (XP), Game.rgss2a (VX) или Game.rgss3a (VX Ace) — данные лежат внутри этого архива. Если же вы видите www/data/*.json или data/*.json, у вас MV или MZ; для них используйте страницу RPG Maker MV / MZ.
- ШАГ 2
Создайте проект на папке игры
Запустите RuneTranslate, нажмите New project и укажите его на папку с исполняемым файлом игры. Определение автоматическое: оно сообщает, какая из трёх версий найдена и лежат ли данные россыпью или в архиве. Архив RGSSAD читается напрямую, а его файлы Data распаковываются в рабочее пространство проекта — ни среда Ruby, ни внешний распаковщик не задействованы.
- ШАГ 3
Выберите целевой язык и провайдера
Выберите целевой язык, затем провайдера: Google и бесплатные варианты DeepL вообще не требуют API-ключа, API DeepL даёт сбалансированное качество, а OpenAI, Anthropic Claude, DeepSeek, любой OpenAI-совместимый эндпоинт или локальная модель через Ollama либо LM Studio справляются с длинными диалогами с учётом контекста. Исходный язык по умолчанию японский; для проекта можно задать любой поддерживаемый исходный язык.
- ШАГ 4
Переведите и проверьте в редакторе
RuneTranslate отправляет строки провайдеру пакетами и записывает их обратно в проект. Диалоги карт, варианты выбора, записи базы данных и термины System сгруппированы, поэтому можно проверять по одной карте или одной таблице базы данных за раз, править любую строку вручную и повторять неудавшиеся пакеты. Управляющие коды маскируются на всём пути, так что \C[1], \N[2] и \V[3] переживают круг целыми.
- ШАГ 5
Экспортируйте играбельную переведённую сборку
Экспорт записывает полную запускаемую копию игры с переведёнными данными Marshal на месте. Для игры в архиве архив распаковывается в россыпь файлов в Data/, а сам архив отбрасывается — именно так RGSS загружает игру, у которой архива нет. Диалоги на выходе переносятся по словам. Результат — играбельная переведённая сборка, которая остаётся у вас, при нетронутом оригинале.
Поддерживает
- RPG Maker XP (Data/*.rxdata), VX (.rvdata) и VX Ace (.rvdata2)
- Архивы RGSSAD — .rgssad, .rgss2a и .rgss3a — читаются напрямую на чистом Rust, без установки Ruby и без отдельного распаковщика
- Собственные ридер и райтер Ruby Marshal 4.8: меняются только строковые листья, тела всех остальных объектов переиздаются дословно
- Диалоги событий карт (код события 101 на XP; 401 и 405 на VX и VX Ace) и списки Show Choices (код 102)
- Текст базы данных: имена, прозвища, описания и заметки персонажей, предметов, навыков, оружия, брони, врагов и состояний, плюс сообщения состояний
- Общие события, текст боевых событий групп врагов, имена событий и названия карт из MapInfos
- Термины и словарь System (@terms на VX и VX Ace, @words на XP) и названия стихий
- Управляющие коды \C[n], \N[n], \V[n] маскируются на время перевода; диалоги переносятся по словам при экспорте
Ограничения
- XP и VX хранят текст без тега кодировки (Ruby 1.8), поэтому RuneTranslate определяет для каждой игры, Shift-JIS это или UTF-8. В игре на Shift-JIS буквы, которые эта кодировка вместить не может (акценты, тайский, арабский и подобные), упрощаются или теряются, поэтому там безопаснее всего цели «английский» и ромадзи. VX Ace полностью в Unicode.
- Ruby-скрипты (Scripts.rxdata / .rvdata / .rvdata2) не извлекаются — текст интерфейса, захардкоженный в собственных скриптах игры, остаётся на исходном языке. События карт, база данных и термины System покрыты.
- Архивы RGSSAD распаковываются, а не пересобираются: на выходе — полная запускаемая копия с россыпью файлов и удалённым архивом, а не перепакованный архив.
- Внутриигровое чит-меню — функция MV и MZ, к XP, VX и VX Ace она не применима. Редактор сохранений открывает их сохранения .rxdata / .rvdata / .rvdata2 (золото, переменные и переключатели).
- MV и MZ используют совсем другой формат (JSON в www/data или data) и описаны на странице RPG Maker MV / MZ.

