Проблемы с импортом

Симптом: При попытке импорта файл игры неактивен (серый) или не виден.

Причина: Фильтр расширений файлов 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 или по электронной почте

Симптом: Импорт завершается ошибкой «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 от размера архива (сам архив плюс извлечённые файлы).

Решение: Освободите место на устройстве и попробуйте снова. Используйте Storage Manager для определения игр или резервных копий, которые можно удалить.

Симптом: Импорт завершается ошибкой «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 в приложении «Файлы», а затем импортируйте оттуда.

Симптом: Индикатор прогресса зависает или во время импорта появляется неизвестная ошибка.

Решения:

• Убедитесь, что у вас достаточно свободного места (не менее 2x от размера архива)
• Для очень больших архивов (2 ГБ+) импорт может занять несколько минут — будьте терпеливы
• Некоторые форматы архивов, такие как 7z, могут быть крайне медленными с тысячами разрозненных файлов
• Если ошибка повторяется, сообщите об этом команде поддержки с указанием сообщения об ошибке и названия игры

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

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

Решение: Нажмите и удерживайте игру в библиотеке и переименуйте её вручную.