Вибір версії

Spark включає кілька версій рушія Ren’Py і дозволяє вам обирати, яку використовувати для кожної гри.

Spark містить наступні версії рушія Ren’Py:

Коли ви імпортуєте гру, Spark визначає версію Ren’Py, яка була запакована з архівом гри (з файлів версії рушія, таких як vc_version.py, __init__.py або їх скомпільовані еквіваленти) та використовує її для рекомендації сумісного рушія.

Файл script_version.txt гри — це окремий файл, який використовується внутрішньо Ren’Py для встановлення прапорців сумісності для скриптового шару — це не те ж саме, що версія рушія.

Spark пропонує дві стратегії рекомендації рушія (налаштовуються в Settings):

• 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 із сеансу гри. Коли увімкнено:

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

Коли використовувати: Гра конфліктує з функціями часу виконання Spark, і Safe Mode сам по собі не вирішив проблему. Це забезпечує максимальну сумісність та ізоляцію ціною втрати всієї функціональності оверлея Spark.