kirikiri · tutorial · engine
Как перевести визуальную новеллу Kirikiri / KAG на русский
Переводите визуальные новеллы Kirikiri / KAG на русский с RuneTranslate — читая упакованные архивы .xp3 автоматически, переводя сценарии KAG .ks и сцены PSB и экспортируя patch.xp3, который игра загружает автоматически.
Kirikiri (吉里吉里) и его сценарный слой KAG движут огромную долю японских визуальных новелл. Загвоздка: Kirikiri упаковывает свои скрипты, арт и звук в архивы .xp3, и многие студии используют поверх собственный вариант архива. Вот почему у Kirikiri репутация трудного для перевода. Это руководство проводит через это от начала до конца с RuneTranslate: чтение .xp3, перевод сценариев KAG .ks и экспорт патча, который игра загружает автоматически.
Что вам нужно
- RuneTranslate для Windows или Linux — бесплатно, разблокирован каждый движок и каждый провайдер, кроме RuneLingua.
- Папка игры Kirikiri — каталог с
.exeигры и одним или несколькими архивами.xp3(обычноdata.xp3,scenario.xp3и т. д.). Подписанные сборки KirikiriZ с файлами.exe.emb/.xp3.sigтоже распознаются. - Целевой язык — английский, испанский, французский, немецкий, португальский, русский, китайский, итальянский, турецкий, вьетнамский и 20+ других.
- Один провайдер перевода. Визуальные новеллы насыщены диалогами, поэтому LLM (OpenAI / Anthropic) или DeepL обычно читаются лучше всего; бесплатный Google Translate работает из коробки.
Шаг 1: Откройте игру и распакуйте XP3
Запустите RuneTranslate, нажмите New project и укажите его на каталог игры Kirikiri. Определение движка запускается автоматически. Встроенный ридер XP3 открывает индекс архива — включая 17-байтовый заголовок сжатого индекса, который используют большие архивы — и вытаскивает файлы сценариев. Ваши оригинальные архивы никогда не изменяются.
Упакованные архивы открываются автоматически, включая, для тайтлов, которые распознаёт RuneTranslate, новый формат, который используют некоторые недавние релизы. Несколько редких форматов пока не распознаются.
Шаг 2: Как извлекаются диалоги Kirikiri
Kirikiri хранит диалоги в сценарных скриптах KAG .ks. RuneTranslate парсит их и перечисляет переводимый текст в редакторе:
- Диалоги и повествование — сырые строки сценария.
- Умное извлечение атрибутов — читаемый текст внутри тегов вроде
[ruby/],[ch text="..."],[name text="..."]и[button text="..."]вытаскивается и переводится, тогда как сама структура тега сохраняется.
Инлайн-управляющие теги KAG маскируются за числовыми плейсхолдерами [[K#]], прежде чем что-либо достигнет провайдера, так что машина не может сломать форматирование движка. Некоторые игры KirikiriZ также поставляют свой сценарий как скомпилированный бинарник PSB .scn (формат PSB\0) — RuneTranslate парсит и переупаковывает стандартные сценарии PSB (версии формата с 1 по 4) тоже, поэтому такие игры переводятся точно как текстовые скрипты.
Шаг 3: Переведите и проверьте
Выберите провайдера и запустите. Для голоса персонажа и стилизованной речи LLM вроде OpenAI или Anthropic читается лучше всего; DeepL быстр и чист для повествования; бесплатный Google Translate покрывает меню. Внесите ваш состав и повторяющиеся термины в глоссарий сначала, чтобы каждая ветка отображала имена одинаково — см. Глоссарий 101. На бесплатном тарифе перевод умеренно ограничен по скорости — примерно в 2x медленнее на AI-провайдерах, меньше на бесплатных провайдерах — с идентичным качеством вывода; платные тарифы работают на полной скорости и добавляют память переводов.
Каждая строка попадает в редактор рядом с её источником. Редактируйте инлайн (сохраняется при потере фокуса или Ctrl+Enter), используйте поиск и замену или запустите необязательный AI-доработчик для контекстно-зависимой вычитки вторым проходом — ценно на длинных ветках ВН.
Шаг 4: Экспортируйте патч
Нажмите Export. RuneTranslate записывает переведённый сценарий как россыпные файлы плюс хук запуска и, где это помогает, плоский patch.xp3. Он использует два пути переопределения, потому что ни один не универсален:
- Россыпные файлы + хук запуска — вызов
addAutoPathхука поднимает россыпные файлы выше архивов игры. Поскольку разные сборки запускают разную точку входа инициализации, RuneTranslate записывает хук под всеми тремя именами, что используют игры —AfterInit2.tjs,xAfterInit2.tjsиxAfterInit.tjs— так что то, которое вызывает игра, его подхватывает. - patch.xp3 — Kirikiri автоматически монтирует
patch.xp3/patch2.xp3с более высоким приоритетом, чем собственные архивы игры («более поздние пути побеждают»), поэтому он переопределяет даже когда игра отключает хук запуска. Патч записывается в форме, которую принимает игра. Некоторые сборки отклоняют лишнийpatch.xp3, поэтому на таких россыпный хук — это путь, который несёт перевод.
Вывод — ваш перевод, положенный рядом с оригинальной игрой. Запустите .exe — и она играется на вашем целевом языке.
Известные ограничения
- Редкий формат упакованного архива, который приложение пока не распознаёт, не поддерживается. Большинство ритейл-игр открываются, но не каждое исключение.
- Нестандартные / MDF-сжатые сценарии PSB
.scnпропускаются; поддерживается только стандартный PSB (версии 1–4). - Скомпилированный или токенизированный байткод KAG
.ks(бинарник / магияjk, которая не декодируется в текст) пропускается — парсятся только читаемые KAG-скрипты и стандартные сценарии PSB. - Текст на изображениях (логотипы, нарисованный вручную интерфейс, подписи CG) не входит в сценарии; переводите его в Image Studio, который читает изображения прямо из архивов XP3 (включая TLG) и доставляет переведённую графику так же, как сценарии.
Почему это проще старого способа
Ручной путь означал определение формата архива, извлечение XP3 отдельным инструментом распаковки, ручной поиск читаемого текста внутри тегов KAG, перевод его без поломки разметки, затем переупаковку или правильную настройку пути переопределения. RuneTranslate складывает всю цепочку — распаковать, извлечь, замаскировать теги, перевести, собрать и россыпный хук, и patch.xp3 — в несколько кликов, с редактором открытым, чтобы вы контролировали формулировки.
Смотрите страницу движка Kirikiri для полного списка функций, читайте руководство по Ren’Py про другой движок визуальных новелл или скачайте RuneTranslate и попробуйте его на реальной игре.
Похожие материалы
Готовы попробовать RuneTranslate?
Бесплатный тариф открывает все движки и всех провайдеров перевода, кроме RuneLingua. Supporter ($3.99/mo) открывает полную скорость.
Скачать для Windows, Mac и Linux
