ROOTWIN PROJECT
AutoBuild
Видео-гайд на YouTube ↗
AutoBuild — основной инструмент ROOTWIN для сборки Ren’Py-игр и модов. Он создаётся вместе с командой TheOneTranslator и закрывает рутинные задачи сборщика: подготовку файлов, проверку структуры, обработку ассетов и повторную сборку после правок.
Проект развивается как практический инструмент для локализационных команд, которым важно быстро получать рабочую сборку без ручной проверки каждого шага.
Задача проекта
В локализации Ren’Py-модов сборка часто занимает больше времени, чем кажется со стороны. Нужно собрать структуру проекта, проверить ресурсы, убедиться, что файлы лежат в нужных местах, повторить процесс после правок переводчиков и не потерять мелкие изменения.
AutoBuild появился как ответ на эту рутину. Его цель — превратить сборку в повторяемый сценарий, где сборщик запускает инструмент и получает предсказуемый результат вместо длинной цепочки ручных действий.
Что умеет
AutoBuild построен вокруг четырёх независимых модулей автоматизации, которые можно включать и отключать под конкретную задачу:
- RPA Extract — вскрывает тяжёлые архивы мода, извлекает содержимое и превращает скомпилированные файлы в читаемый вид;
- Font Remap — сканирует весь код мода и переписывает ссылки на шрифты, подставляя кириллические из папки ресурсов, устраняя «кракозябры» и пустые текстовые блоки;
- Text Assets — сверяется со словарём перевода и локализует интерфейсные элементы: кнопки меню, названия персонажей и системные строки;
- Clean Up — убирает временные файлы, кэш и мусор, оставляя чистую рабочую папку после сборки.
Помимо самой сборки, программа готовит вспомогательные материалы для команды: список пропущенных при переводе строк с привязкой к исходному коду и карту сюжета мода — текстовую хронологию переходов между сценами и интерактивный граф с поиском и зумом, по которому удобно ориентироваться в структуре большого проекта.
Инструмент поддерживает и современные, и классические Ren’Py-моды: версия движка выбирается вручную или определяется автоматически по структуре файлов.
Пример интерактивного графа сюжета, который программа собирает по завершении сборки — по нему удобно ориентироваться в структуре большого мода.
Визуальные темы
Интерфейс AutoBuild переключается между четырьмя темами оформления, каждая из которых меняет не только цветовую палитру, но и статус в Discord Rich Presence — видно, под покровительством какой героини идёт перевод мода в данный момент:
- Sayori — небесно-голубые тона с коралловыми акцентами;
- Yuri — тёмно-фиолетовый с приглушёнными неоновыми акцентами;
- Natsuki — пастельно-розовый с яркими контрастными акцентами;
- Monika — изумрудно-зелёный, атмосфера контроля и порядка.
Контроль и безопасность процесса
Сборка — операция, затрагивающая системные файлы и запуск стороннего кода мода, поэтому AutoBuild построен с явным вниманием к прозрачности процесса:
- перед первым запуском программа показывает предупреждение о том, что работа с инструментами вроде распаковщика архивов и обработка сторонних ресурсов подразумевают выполнение чужого программного кода, и просит пользователя подтвердить, что он проверяет источники и берёт на себя ответственность за используемый контент;
- ход сборки виден в мини-консоли в реальном времени с понятными индикаторами этапов, а при сбоях на диске сохраняется подробный лог-файл сессии для передачи разработчику;
- пока конвейер работает, вмешиваться в файлы или запускать мод вручную нельзя — программа монопольно завершает все операции сама и, если для сборки требуется открыть окно игры, самостоятельно закрывает его по завершении, чтобы не повредить структуру файлов.
История разработки
Идея AutoBuild была предложена ROOTWIN после работы с локализационными процессами TheOneTranslator. 4 июня 2026 года началась совместная разработка инструмента, 17 июня вышла версия 1.1 BEST и первая подробная документация на Teletype, а к 4 июля завершился второй этап совместного тестирования. 4 сентября 2026 года состоялся релиз AutoBuild v1.2: исправления вылетов при сборке, оптимизация обработки ассетов и переработка внутренних пайплайнов сборки.
Позже проект перешёл в новую стадию: упор сместился на стабильность, ускорение пайплайна и более аккуратную работу с ассетами. AutoBuild стал частью общей линейки ROOTWIN для Ren’Py: R-Migrator отвечает за миграцию старых модов, RenDoki — за локализацию, AutoBuild — за сборку.
Статус
Проект остаётся в активной разработке. Основной фокус — сделать инструмент удобным для сборщиков, которые работают с модами регулярно и хотят получать воспроизводимый результат без постоянного ручного контроля.
Руководство пользователя
Подробное руководство по использованию AutoBuild описывает интерфейс, модули, порядок сборки и типичные ошибки — рекомендуется к прочтению перед первым запуском.