Імпорт ігор

Sakura імпортує ігри NScripter і ONScripter (включно з іграми ONScripter-RU на кшталт Umineko) прямо на вашому пристрої — комп’ютер не потрібен. Тут описано повний процес імпорту в застосунку. Якщо ви хочете імпортувати з браузера на комп’ютері, дивіться натомість Веб-передавання.

• З Бібліотеки торкніться картки Імпортувати ігри (.zip, .7z, .rar, .tar, .gz, .bz2, .exe).
• Якщо ваша бібліотека порожня, екран Ігор не знайдено має власну кнопку Імпорт.

Це відкриває спливне вікно Імпорт гри ONScripter, у якому перелічені підтримувані типи файлів і пояснюється, що коренева папка гри ONScripter буде виявлена автоматично. Торкніться Вибрати архів, щоб відкрити системний вибір файлів і обрати один архів.

• zip — розпаковується за допомогою ZIPFoundation (або SSZipArchive, якщо захищено паролем)
• 7z — розпаковується за допомогою PLzmaSDK
• rar — розпаковується за допомогою UnrarKit
• tar / gz / bz2 / tgz — вбудований потоковий зчитувач tar/gzip/bzip2
• lzh / lha — власний екстрактор LHA
• exe (лише інсталятори/самовидобувні архіви) — визначається в такому порядку: інсталятор NSIS, інсталятор Inno Setup, потім сканування перших 16 МБ на предмет вбудованого самовидобувного вмісту 7z/zip, а тоді LHA-SFX

1. Підготовка. Якщо архів знаходиться в iCloud Drive, Sakura спочатку завантажує його локально. Потім перевіряється вільний простір — потрібно приблизно втричі більше за розмір архіву, якщо потрібно підготувати копію, або вдвічі більше, якщо файл вже локальний. Якщо місця недостатньо, ви побачите «Insufficient Disk Space»: «Not enough free space to extract this archive. Please free up storage and try again.»

2. Перевірка пароля. Якщо архів зашифрований (лише zip/rar/7z), вам буде запропоновано: «This archive is password-protected. Please enter the password to continue.» Неправильний пароль показує «Incorrect password. Please try again.»

3. Попереднє сканування. Перед розпакуванням Sakura сканує назви записів на предмет розпізнаваних маркерів NScripter/ONScripter — завантажувальні скрипти на кшталт 0.txt, 00.txt, nscript.dat, nscr_sec.dat, nscript.___, 0.utf, 00.utf, pscript.dat або script.file (запакований формат скрипту, що використовується іграми ONScripter-RU, як-от Umineko), а також запаковані архіви на кшталт arc*.nsa, *.ns2 або *.sar. Tar та інші формати, які неможливо попередньо просканувати, перевіряються одразу після розпакування.

   Якщо нічого не збігається, ви побачите: «This archive doesn’t look like an ONScripter game. Look for archives containing 0.txt, nscript.dat, or an arc.nsa pack.»

4. Розпакування. Перед початком розпакування триває короткий відлік («Starting…»), потім триває живий відсоток виконання та є опція скасування. Кілька деталей, специфічних для формату:

   • Назви файлів у zip спочатку декодуються як UTF-8, а за потреби — як Shift-JIS — це виправляє «кракозябри» в японських архівах.
   • Розпакування RAR отримує перевірку цілісності завантажувально-критичних файлів після розпакування; якщо якісь відсутні чи обрізані, ви побачите: «RAR extraction incomplete: N essential files missing or truncated (e.g. {sample}). Re-pack the game as ZIP or 7z and import that.»
   • Папки __MACOSX видаляються автоматично.

5. Виявлення кореня гри. Sakura виконує обмежений пошук (до 6 рівнів папок вглиб) для найповерхневішої папки, що містить один із наведених вище маркерів NScripter — тож архів, вкладений на кшталт Title 1.0/Title 1.0/game files…, все одно розпізнається коректно.

6. Встановлення. Гра встановлюється у власну папку у вашій бібліотеці разом із порожньою папкою Patches для модів або патчів перекладу. Якщо архів із такою самою назвою вже було імпортовано, додається числовий суфікс.

Якщо розпакування скасовано, ви побачите Скасовано з кнопками Закрити / Перезапустити. Якщо щось піде не так, спливне вікно Критична помилка запропонує Закрити або Імпортувати ще?.

Після успішного імпорту крок Налаштувати дозволяє задати Назву гри (попередньо заповнену виявленою назвою) та обрати Іконку — дивіться Іконки ігор, щоб дізнатися, як знаходяться варіанти іконок. Торкніться Зберегти, щоб зберегти свій вибір, або Пропустити, щоб залишити значення за замовчуванням.

Останній екран підтверджує «Imported ONScripter Game» з назвою гри та пропонує Закрити або Перейти до гри?, щоб одразу її відкрити.

• Бачите «Unsupported Format» чи «Unsupported archive format»? Дивіться примітки щодо форматів вище — зокрема, інсталятори .exe формату CAB потрібно спочатку розпакувати й перепакувати на комп’ютері.
• Бачите «This archive doesn’t look like an ONScripter game»? Перевірте, чи архів справді містить файли скрипту гри (а не лише обгортку інсталятора чи папку непов’язаних файлів).
• Щодо більш загальних проблем з імпортом дивіться Проблеми з імпортом.