Importing Games

Sakura imports NScripter and ONScripter games (including ONScripter-RU games like Umineko) directly on your device — no computer required. This covers the full in-app import flow. If you’d rather import from a browser on your computer, see Web Transfer instead.

• From the Library, tap the Import Games card (.zip, .7z, .rar, .tar, .gz, .bz2, .exe).
• If your library is empty, the No Games Found screen has its own Import button.

This opens the ONScripter Game Import popup, which lists the supported file types and explains that the ONScripter game root folder will be detected automatically. Tap Select Archive to open the system file picker and choose a single archive.

• zip — extracted with ZIPFoundation (or SSZipArchive if password-protected)
• 7z — extracted with PLzmaSDK
• rar — extracted with UnrarKit
• tar / gz / bz2 / tgz — a built-in streaming tar/gzip/bzip2 reader
• lzh / lha — a native LHA extractor
• exe (installers/self-extractors only) — detected in order: NSIS installer, Inno Setup installer, then a scan of the first 16 MB for an embedded 7z/zip self-extracting payload, then LHA-SFX

1. Staging. If the archive lives in iCloud Drive, Sakura downloads it locally first. It then checks free space — needing roughly 3× the archive size if it has to stage a copy, or 2× if the file is already local. If there isn’t enough room, you’ll see “Insufficient Disk Space”: “Not enough free space to extract this archive. Please free up storage and try again.”

2. Password check. If the archive is encrypted (zip/rar/7z only), you’re prompted: “This archive is password-protected. Please enter the password to continue.” An incorrect password shows “Incorrect password. Please try again.”

3. Prescan. Before extracting, Sakura scans entry names for recognizable NScripter/ONScripter markers — boot scripts like 0.txt, 00.txt, nscript.dat, nscr_sec.dat, nscript.___, 0.utf, 00.utf, pscript.dat, or script.file (the packed script format used by ONScripter-RU games such as Umineko), plus packed archives like arc*.nsa, *.ns2, or *.sar. Tar and other formats that can’t be prescanned are checked right after extraction instead.

   If nothing matches, you’ll see: “This archive doesn’t look like an ONScripter game. Look for archives containing 0.txt, nscript.dat, or an arc.nsa pack.”

4. Extraction. A short countdown (“Starting…”) runs before extraction begins, with a live percentage afterward and a Cancel option. A few format-specific details:

   • Zip filenames are decoded as UTF-8 first, falling back to Shift-JIS — this fixes mojibake in Japanese archives.
   • RAR extractions get a post-extraction integrity check of boot-critical files; if any are missing or truncated, you’ll see: “RAR extraction incomplete: N essential files missing or truncated (e.g. {sample}). Re-pack the game as ZIP or 7z and import that.”
   • __MACOSX folders are deleted automatically.

5. Game-root detection. Sakura performs a bounded search (up to 6 folders deep) for the shallowest folder containing one of the NScripter markers above — so an archive nested like Title 1.0/Title 1.0/game files… still resolves correctly.

6. Installation. The game is installed to its own folder in your library, along with an empty Patches folder for mods or translation patches. If an archive of the same name was already imported, a numeric suffix is added.

If extraction is cancelled, you’ll see Cancelled with Close / Restart. If something goes wrong, a Fatal Error popup offers Close or Import Another?.

After a successful import, the Customize step lets you set the Game Name (pre-filled from the detected name) and pick an Icon — see Game Icons for how icon candidates are found. Tap Save to keep your choices, or Skip to leave the defaults.

The final screen confirms “Imported ONScripter Game” with the game’s name, and offers Close or Jump to Game? to open it right away.

• Seeing “Unsupported Format” or “Unsupported archive format”? See the format notes above — CAB .exe installers in particular need to be extracted and repacked on a computer first.
• Seeing “This archive doesn’t look like an ONScripter game”? Double check the archive actually contains the game’s script files (not just an installer wrapper or a folder of unrelated files).
• For more general import issues, see Import Problems.