Проблеми з імпортом

Симптом: При спробі імпорту файл гри сірий або невидимий.

Причина: Фільтр розширень файлів Spark за замовчуванням показує лише розпізнані формати.

Рішення:

1. Перейдіть до Settings > Game Library
2. Вимкніть File Extension Filter
3. Спробуйте імпортувати знову

Це особливо часто трапляється з файлами APK.

Симптом: Імпорт, здається, завершується, але жодна гра не з’являється в бібліотеці.

Можливі причини:

1. Невірна структура гри — Архів не містить дійсної гри Ren’Py

   • Рішення: Переконайтеся, що архів містить папку game/ з файлами .rpy або .rpa

2. Вкладені каталоги — Гра занадто глибоко захована в архіві

   • Рішення: Спочатку розпакуйте архів на ПК, потім перенесіть лише папку гри

3. Пошкоджений архів — Файл пошкоджений

   • Рішення: Завантажте архів повторно

Симптом: Імпорт не вдається з помилкою “Unable to find the ‘game’ folder. Is this a Ren’Py title? It is possible that the game was packaged in an unknown way.”

Причина: Spark сканує розпакований архів на наявність папки game/, яка є стандартною структурою для ігор Ren’Py. Якщо вона не знайдена, імпорт не може продовжитися. Це може статися, коли:

• Архів не є грою Ren’Py
• Гра була запакована нестандартним способом (неофіційна перепаковка, власна структура папок)
• Архів подвійно запакований і автоматичне виявлення Spark не знайшло внутрішню гру

Рішення:

1. Переконайтеся, що архів дійсно є грою Ren’Py з папкою game/
2. Спробуйте використати офіційний архів гри від оригінального розробника замість перепакованої версії
3. Якщо архів містить дійсну гру Ren’Py, але Spark не може її виявити, повідомте про це команді підтримки на Discord або через email

Симптом: Імпорт не вдається з помилкою “Legacy Method — Unable to find game folder.”

Причина: Після невдачі основного виявлення папки гри Spark намагається виконати резервне застаріле сканування, яке рекурсивно шукає папку game/ у всьому розпакованому архіві. Ця помилка означає, що навіть застаріле виявлення не змогло знайти дійсну гру.

Рішення:

• Структура архіву, ймовірно, несумісна. Спробуйте іншу версію або архів іншої платформи гри
• Розпакуйте архів на ПК, перевірте структуру папок і перепакуйте його як стандартний ZIP з папкою game/ на очікуваному рівні
• Повідомте про проблему команді підтримки з назвою гри

Симптом: Гра не запускається з повідомленням “Unable to determine Ren’Py Version. Aborting Launch.” або з’являється запит на вказання версії рушія.

Причина: Spark не зміг автоматично визначити, яка версія Ren’Py потрібна грі.

Рішення: Відкрийте Game Settings (довге натискання на гру), натисніть Modify поруч з версією Ren’Py та вручну виберіть правильну версію рушія. Якщо ви не впевнені, спробуйте останню версію 7.x для старіших ігор або останню версію 8.x для новіших ігор.

Симптом: Запуск не вдається з помилкою “The requested engine version was not found.”

Причина: Версія рушія, обрана для гри, недоступна на пристрої.

Рішення: Відкрийте Game Settings та виберіть іншу доступну версію рушія.

Симптом: Імпорт не вдається з помилкою, що показує розрахований нестиснутий розмір та доступний простір.

Причина: На вашому пристрої недостатньо вільного місця для розпакування архіву. Зазвичай вам потрібно щонайменше 2x розміру архіву (сам архів плюс розпаковані файли).

Рішення: Звільніть місце на пристрої та спробуйте знову. Використайте Менеджер сховища, щоб визначити ігри або резервні копії, які можна видалити.

Симптом: Імпорт не вдається з повідомленням “Unable to determine the uncompressed archive size. Is the archive corrupt?”

Причина: Spark не зміг прочитати метадані архіву для розрахунку нестиснутого розміру. Файл може бути пошкоджений або мати непідтримуваний варіант формату.

Рішення: Завантажте архів повторно та спробуйте знову. Якщо проблема не зникає, архів може використовувати нестандартний формат — повідомте про це команді підтримки.

Симптом: Імпорт не вдається з повідомленням “Unable to obtain file permission from the operating system.”

Причина: iOS не надала Spark дозвіл на доступ до обраного файлу. Це може статися з файлами з певних хмарних сховищ або зовнішніх джерел.

Рішення: Спробуйте спочатку скопіювати архів у розділ On My iPhone/iPad в додатку Files, а потім імпортувати звідти.

Симптом: Індикатор прогресу зависає або з’являється невідома помилка під час імпорту.

Рішення:

• Переконайтеся, що у вас достатньо вільного місця (щонайменше 2x розміру архіву)
• Для дуже великих архівів (2 ГБ+) імпорт може зайняти кілька хвилин — будьте терплячі
• Деякі формати архівів, такі як 7z, можуть бути надзвичайно повільними з тисячами окремих файлів
• Якщо помилка не зникає, повідомте про неї команді підтримки з текстом помилки та назвою гри

Симптом: Після імпорту APK гра має неправильну або загальну назву.

Причина: Назву гри не вдалося визначити з метаданих APK.

Рішення: Довге натискання на гру в бібліотеці та перейменуйте її вручну.