File Formats

Sakura can import NScripter and ONScripter games from a wide range of archive and installer formats, and can look inside password-protected archives too.

Supported Archives

Format	Extension	Notes
ZIP	`.zip`	Extracted with ZIPFoundation (or SSZipArchive if password-protected).
7-Zip	`.7z`	Extracted with PLzmaSDK.
RAR	`.rar`	Extracted with UnrarKit, with a post-extraction integrity check.
TAR	`.tar`	Uncompressed archive format.
Gzip	`.gz`	Gzip-compressed TAR archives.
Bzip2	`.bz2`	Bzip2-compressed TAR archives.
LZH/LHA	`.lzh`, `.lha`	Extracted with a native LHA extractor.

Installer / Self-Extracting `.exe` Files

Sakura can also pull a game out of a Windows installer or self-extracting archive, without needing a computer:

NSIS installers
Inno Setup installers
Self-extracting zip or 7z archives (detected by scanning the first 16 MB for an embedded payload)
LHA self-extracting archives

What Counts as a Valid Game

Sakura looks for recognizable NScripter/ONScripter files to confirm an archive actually contains a game, and to figure out which engine it needs:

Loose boot scripts — 0.txt / 00.txt (classic Shift-JIS), or 0.utf / 00.utf (UTF-8)
Compiled/packed scripts — nscript.dat, nscr_sec.dat, nscript.___, or pscript.dat
ONScripter-RU games (like Umineko) — a script.file, or a fonts/ folder alongside 0.txt
Packed asset archives — arc*.nsa, *.ns2, or *.sar packs, even without a loose boot script alongside them

If none of these are found anywhere in the archive, Sakura reports that it doesn’t look like an ONScripter game rather than importing a folder of unrelated files. See Importing Games for the full import walkthrough, including what happens when detection fails, and Supported Engines for how Sakura tells NScripter, ONScripter, and ONScripter-RU games apart.

Troubleshooting

Archive not recognized, or “Unsupported Format”? — See Import Problems.
File doesn’t show up in the picker? — Disable File Ext. Filter in General settings to show all file types, not just recognized archive extensions.