Выбор версии

Spark включает несколько версий движка Ren’Py и позволяет выбрать, какую из них использовать для каждой игры.

Spark поставляется со следующими версиями движка Ren’Py:

При импорте игры Spark определяет версию Ren’Py, упакованную с архивом игры (из файлов версии движка, таких как vc_version.py, __init__.py или их скомпилированных эквивалентов), и использует её для предложения совместимого движка.

Файл script_version.txt игры — это отдельный файл, используемый Ren’Py внутренне для установки флагов совместимости скриптового уровня — это не то же самое, что версия движка.

Spark предлагает две стратегии выбора движка (настраиваемые в настройках):

• Accurate (по умолчанию) — Рекомендует движок, совпадающий по минорной версии (например, игра 7.5.x получит движок 7.5.3)
• Latest — Рекомендует последний движок в пределах той же мажорной версии (например, игра 7.x получит последний движок 7.x, игра 8.x получит последний движок 8.x)

Версия среды выполнения движка отображается под кнопкой Launch Game на экране деталей игры. Есть две настройки версии, которые вы можете изменить:

Определяет, какой встроенный движок Ren’Py Spark использует для запуска игры.

1. Нажмите Modify рядом с версией движка на экране деталей игры
2. Выберите из списка версий
3. Нажмите Confirm

Если вы изменили движок и столкнулись с проблемами, вы можете вернуться:

• Оригинальная версия сохраняется автоматически
• Используйте кнопку Revert в выборе версии для возврата

Обновляет файл script_version.txt игры, который управляет логикой внутренней совместимости Ren’Py. Ren’Py использует это значение для включения или отключения обратно совместимого поведения для старых игр.

Изменение этого может решить проблемы, когда игра ожидает определённое устаревшее поведение, изменённое в более новых версиях движка. См. документацию несовместимых изменений Ren’Py для получения подробностей о том, что меняется между версиями.

• Игра вылетает при запуске — Попробуйте другую версию движка
• Отсутствуют функции — Некоторые игры требуют определённых версий Ren’Py
• Проблемы производительности — Более новые движки могут работать лучше
• Совместимость — Старые игры могут требовать более старых движков

Каждая игра в Spark имеет три необязательных режима запуска, которые определяют, насколько активны патчи движка Spark и его интеграция со средой выполнения. Они находятся в Game Settings (долгое нажатие на игру в библиотеке).

Safe Mode запускает игру с использованием ванильного, немодифицированного движка Ren’Py вместо пользовательской патченной сборки Spark. Модификации движка и инъекции скриптов Spark отключаются, но оверлей и функции среды выполнения остаются доступными.

Кнопка запуска становится зелёной с надписью “Safe Launch” при активации этого режима.

Когда использовать: Игра вылетает или работает некорректно, и вы подозреваете, что причина в патчах движка Spark.

Advanced Mode предназначен для игр, в которых разработчик внёс изменения непосредственно на уровне Python движка Ren’Py. Некоторые игры поставляются с модифицированным каталогом renpy/, содержащим пользовательский код движка — без этих модификаций игра может вылетать или работать некорректно. При включении:

• Spark ищет каталог advanced/renpy внутри папки игры
• Любые найденные файлы Python-исходников переопределяют встроенные исходники Ren’Py движка
• Появляется отдельный выбор версии движка, независимый от обычного выбора версии

Кнопка запуска становится розовой с надписью “Advanced Launch” при активации этого режима.

Когда использовать: Игра содержит пользовательские модификации исходного кода Python Ren’Py (модифицированный каталог renpy/). Это встречается нечасто, но некоторые игры полагаются на изменения на уровне движка для пользовательских функций, UI-фреймворков или обходных решений совместимости.

Этот режим полностью удаляет уровень среды выполнения Spark из игровой сессии. При включении:

• Интерфейс оверлея Spark (элементы управления игрой, быстрое меню, помощник клавиатуры, кнопка скрытия UI) не появляется
• Вся инъекция Python среды выполнения пропускается — отслеживание диалогов, разблокировка галереи, настройка жестов, синхронизация громкости, система перевода и переопределение раскладки клавиш — всё отключено
• Игра работает без каких-либо модификаций среды выполнения Spark
• Настройки на основе RPY (режим разработчика, консоль, прозрачный текстбокс) по-прежнему работают, так как Ren’Py загружает их сам, а не Spark инъектирует

Когда использовать: Игра конфликтует с функциями среды выполнения Spark и Safe Mode не решил проблему. Это обеспечивает максимальную совместимость и изоляцию за счёт всех функций оверлея Spark.