nscripter · onscripter · engine

Как переводить визуальные новеллы на NScripter / ONScripter

RuneTranslate переводит визуальные новеллы NScripter и ONScripter на русский и 30+ языков — декодируя скрипт nscript.dat, обрабатывая Shift-JIS / CP932 и экспортируя готовую к запуску копию. Подтверждено в игре; сообщайте обо всём, что не загружается.

6 мин чтения

RuneTranslate читает одно из старейших семейств движков в японских визуальных новеллах: NScripter и его близнеца с открытым кодом ONScripter. Эти классические инди-ВН — те, что поставляются как папка загадочных файлов .dat и скриптов Shift-JIS — исторически были самыми болезненными для открытия вручную, и теми, что инструменты машинного перевода обычно пропускают. RuneTranslate определяет движок, читает текст скрипта и может даже перевести японский, вписанный в заставку и кнопки меню.

Поддержка этого движка подтверждена в игре на реальном тайтле, но у NScripter десятилетия вариантов, поэтому если вы указываете RuneTranslate на игру NScripter / ONScripter, а он не определяет или не загружает, пожалуйста, скажите нам (подробнее об этом в конце).

Что такое NScripter и ONScripter на самом деле

NScripter — Windows-скриптовый движок ВН с закрытым кодом от Наоки Такахаси, широко использовавшийся в Японии с начала 2000-х. Его лицензия без роялти для личного и коммерческого использования, встроенный упаковщик архивов и знаменито низкоуровневый скриптовый язык сделали его основой инди-сцены; студии вроде Nekonekosoft опирались на него почти исключительно.

ONScripter — отдельная реализация среды выполнения NScripter с открытым кодом (GPL) от программиста, известного как Ogapee. Построенная на SDL и совместимая на замену, она работает там, где NScripter не может — Linux, macOS, Android и другие — поэтому сообщество локализации приняло её (и форки вроде ONScripter-EN и Ponscripter для пропорциональных Unicode-шрифтов) как де-факто среду выполнения для выпуска переведённых сборок.

Короткая версия: NScripter — оригинальный закрытый Windows-движок, на котором были созданы игры; ONScripter — открытая кроссплатформенная среда выполнения, на которой фан-переводчики запускают свои сборки. RuneTranslate работает из скриптов и ресурсов игры, поэтому он покрывает тайтлы из любого лагеря.

Почему эти игры было так трудно переводить

По сравнению с современным движком вроде Ren’Py или Kirikiri, NScripter / ONScripter — минное поле причуд своей эпохи движков. Четыре в особенности сделали его стеной как для ручных переводчиков, так и для наивных MT-инструментов:

  • Кодировка Shift-JIS / CP932. Устаревшие скрипты — Shift-JIS (CP932). Декодируй её неверно — и получишь кракозябры; перекодируй небрежно — и некоторые старые среды выполнения портят память и падают. Современные нативные скрипты могут быть UTF-8, но бэк-каталог — CP932.
  • Закодированный `nscript.dat`. Скомпилированный скрипт обычно живёт в nscript.dat (или pscript.dat в Ponscripter), в закодированной форме, поэтому открыть его в текстовом редакторе нельзя. Игры с открытым текстом поставляют скрипт как 0.utf / 0.utf.txt (UTF-8) или 0.txt / 00.txt (Shift-JIS).
  • Текст, запечённый в графический арт. Заставки, меню и кнопки часто предварительно отрисованы как растр, поэтому японский на них — пиксели, а не строки — экстрактор строк их не тронет.
  • Тонкий момент: строки, начинающиеся с латиницы, переразбираются как команды. Парсер NScripter начинает каждую строку в командном режиме. Это было безопасно, когда движок принимал только двухбайтовый японский, но строка, начинающаяся с однобайтовой латинской буквы, выглядит ровно как команда, и движок пытается выполнить её. Фикс сообщества — зарезервированный текстовый маркер (обратный апостроф ` в устаревшем ONScripter; ^ в Ponscripter), который принудительно задаёт текстовый режим — который наивный поиск-и-замена не добавит.

Что RuneTranslate делает сейчас

RuneTranslate относится к NScripter / ONScripter как к полноценному движку и обрабатывает обе половины проблемы:

  • Текст скрипта. Он читает скрипт игры — россыпной текстовый файл или закодированный nscript.dat — декодирует диалоги Shift-JIS / CP932, перечисляет каждую переводимую строку в редакторе, а при экспорте записывает скрипт обратно в форме, которую ожидает движок, в той же кодировке, что использовал оригинал. Он также вставляет однобайтовый текстовый маркер автоматически, чтобы переведённый английский не был прочитан как команда. (Скрипт, который живёт только внутри архива .nsa / .sar, без россыпной копии, пока не читается — см. ограничения.)
  • Запечённый текст на изображениях. Японский на заставках и в меню обрабатывается переводом текста на изображениях: обведите слова, распознайте их, переведите своим провайдером и запеките результат обратно, чтобы игра загрузила ваш переведённый арт.

Японский → английский — золотая середина — это то, о чём фан-переводческая история этого движка — но вы можете нацелиться на 30+ языков. На устаревших Shift-JIS скриптах тайский поставляется с собственным шрифтом; другие не-латинские цели ограничены шрифтами, которые движок может отобразить.

Что вам нужно

  • RuneTranslate для Windows или Linux — бесплатно, разблокирован каждый движок и каждый провайдер, кроме RuneLingua.
  • Папка игры NScripter или ONScripter — каталог с .exe игры (или бинарником ONScripter), её скриптом (nscript.dat или россыпной 0.txt / 0.utf) и любыми архивами .nsa / .sar.
  • Целевой язык — английский, испанский, французский, немецкий, китайский и 30+ других.
  • Один провайдер. Бесплатный Google Translate работает из коробки; у DeepL есть бесплатный тариф; OpenAI, Anthropic, локальная модель и любой OpenAI-совместимый API — со своим ключом. Эти игры насыщены диалогами, поэтому LLM или DeepL читаются лучше всего.

Шаг 1: Откройте папку игры

Запустите RuneTranslate, нажмите New project и укажите его на каталог игры. Определение запускается автоматически: nscript.dat / pscript.dat или текстового 0.utf / 0.utf.txt достаточно самого по себе. Голый Shift-JIS 0.txt или одиночный архив .nsa распознаётся только наряду с подтверждающим сигналом — бинарником ONScripter, шрифтом игры или сопутствующим архивом — чтобы избежать ложных совпадений. Ваша оригинальная папка игры никогда не изменяется.

Шаг 2: Как читается скрипт

RuneTranslate читает скрипт, который игра поставляет россыпью в своём корне, и декодирует его за вас:

  • Закодированный `nscript.dat` — декодирован и прочитан как Shift-JIS, поэтому вы пропускаете отдельный шаг nsdec.
  • Текстовые скрипты — 0.utf / 0.utf.txt (UTF-8) или 0.txt / 00.txt (Shift-JIS), прочитаны напрямую.
  • Архивные изображения — вытянуты из архивов .nsa / .sar игры для шага текста на изображениях. (Сам скрипт читается из россыпных файлов корня; скрипт, упакованный только внутри архива, пока не читается.)

Диалоги и отображаемый текст перечислены в редакторе, сгруппированные по файлу. Разметка движка и командные токены маскируются за числовыми плейсхолдерами, прежде чем достичь провайдера, затем восстанавливаются на выходе — и однобайтовый текстовый маркер применяется, где нужно, чтобы движок не принял переведённую строку за команду.

Шаг 3: Переведите

Выберите провайдера и запустите. LLM (OpenAI / Anthropic) лучше всего для голоса персонажа, DeepL быстр и чист для повествования, а бесплатный Google Translate годится для коротких строк меню. Внесите ваш состав в глоссарий заранее, чтобы имена отображались одинаково — см. Глоссарий 101. Когда закончите, необязательный проход AI-доработчика перечитывает каждую строку в контексте и подтягивает жёсткие, буквальные формулировки, которые MT склонен оставлять.

Шаг 4: Переведите текст на изображениях

Поскольку так много интерфейса NScripter — предварительно отрисованный арт, этот шаг важнее здесь, чем на большинстве движков. Откройте изображение заставки или меню, обведите каждый фрагмент японского, распознайте его, переведите тем же провайдером, и при экспорте RuneTranslate запекает перевод обратно и записывает его россыпью в экспортированную копию, чтобы движок загрузил ваш переведённый арт поверх архивного оригинала. (Ваша оригинальная папка остаётся нетронутой; SPB-сжатый арт и несколько экзотических вариантов изображений всё ещё укрепляются.) Полный разбор: перевод текста на изображениях.

Шаг 5: Экспортируйте готовую к запуску копию

Нажмите Export. RuneTranslate записывает переведённую копию игры — скрипт перекодирован в Shift-JIS / CP932 в той же форме, что использовал оригинал, записан как россыпной скрипт, который движок загружает поверх любой архивной копии, плюс любые переведённые изображения рядом. Запустите её — и она играется на вашем целевом языке, на оригинальной среде выполнения NScripter или на ONScripter / ONScripter-EN.

Известные ограничения

  • Стандартная кодировка nscript.dat обрабатывается, но игра с кастомным нестандартным форматом скрипта может не открыться.
  • Скрипт, упакованный только внутри архива .nsa / .sar, без россыпного nscript.dat / 0.txt в корне, пока не извлекается — большинство игр поставляют его россыпью, но некоторые нет.
  • Перевод текста на изображениях достигает вписанных меню, заставок и кнопок, но SPB-сжатый арт и сильно стилизованные логотипы могут потребовать ручной доработки.
  • Точный движок может варьироваться по релизу — некоторые тайтлы, связанные с NScripter, были переинженерены для конкретных переизданий на Steam / консолях. Проверяйте на вашей копии.

Расскажите нам, что ломается

Этот движок подтверждён в игре на реальном тайтле, но он ещё не встречал все варианты. У NScripter / ONScripter десятилетия вариантов, форков и причуд от студии к студии, которые мы не все видели. Поэтому если вы указываете RuneTranslate на один из них, а он не определяет, не загружает или экспортирует то, что среда выполнения не открывает, пожалуйста, сообщите — название игры и то, как она упакована (россыпной 0.txt, nscript.dat, архивы .nsa), помогает нам укрепить это быстрее всего.

Скачайте RuneTranslate, укажите его на ту классическую ВН, которую вы собирались прочитать, и попробуйте. Про более современный движок ВН читайте разбор Ren’Py.

Готовы попробовать RuneTranslate?

Бесплатный тариф открывает все движки и всех провайдеров перевода, кроме RuneLingua. Supporter ($3.99/mo) открывает полную скорость.

Скачать для Windows, Mac и Linux