Encyclopedia

NScripter Family

NScripter / ONScripter / ONScripter-EN; legacy names also work with PONScripter. Keep scripts and resources together. nscript.___: companion executable key table or valid generated key sidecar required.

Game/
├── 0.txt
├── arc.nsa
├── arc1.nsa
└── default.ttf

Game/
├── 0.utf
├── pscript.dat
└── arc.sar

PONScripter

Same roots for Original / Mion (2011), Sekai Project Steam, Witch Hunt 1x/2x, and 07th-Mod v3/v4. UTF-8 scripts; legacy names also accepted. Preserve patch/ for profiles with patch-first lookup.

ONScripter-RU

Default: script.file. Selector: game-script / game_script in ons.cfg, otherwise default.cfg. Selected scripts: .file (validated RU header) or .txt. Preserve relative paths and matching script-name.cfg overlays.

Umineko Project

Put all 12 resource parts, the main scripts ZIP, and the resource update ZIP in one folder; the Witch Hunt scripts ZIP is optional. Select that folder in From Files and enter your archive password when asked. ZScripter assembles the game directly, without copying the download archives into its game library. Keep at least 13.5 GB free in app storage.

OnscripterYuri

Classic NScripter / ONScripter roots. Profiles: GBK, Shift-JIS, UTF-8. Decoder: onscript.nt2 / onscript.nt3. NT2/NT3 alone do not trigger automatic folder discovery. Preserve the distribution; select the matching profile.

NSA / NS2 / SAR

Resources inside a game root, not standalone imports. NSA: arc.nsa, arc1.nsa–arc99.nsa. NS2: 00.ns2–99.ns2. SAR: arc.sar. Key-table archives: arc.___, arc1.___–arc99.___. Preserve names and loose resources.

Artemis

Select the complete game root containing system.ini and its configured BOOT script. Keep scripts, images, audio and relative paths intact. A script or executable alone is insufficient; packed PFS roots are described under Engine Package Import.

Game/
├── system.ini
├── boot.iet
├── script/
├── image/
└── sound/

CatSystem2

Select the complete game folder containing scene.int (or a scene folder of .cst files) and config.int or startup.xml. Keep every .int archive, the game executable and loose folders together: ZScripter reads archive keys from the executable's resources but never runs it.

Game/
├── Game.exe
├── scene.int
├── config.int
├── image.int
├── bgm.int
├── voice.int
└── movie/

RealLive

Gameexe.ini + Seen.txt at the root or in an immediate KINETICDATA/REALLIVEDATA folder; names are case-insensitive. Keep all referenced resources and relative paths. Wrapper-only .ezk/.ezs packages are unsupported.

Game/
├── Gameexe.ini
├── Seen.txt
├── G00/
├── BGM/
├── WAV/
└── KOE/

Game/
└── KINETICDATA/ | REALLIVEDATA/
    ├── Gameexe.ini
    ├── Seen.txt
    └── …

SiglusEngine

Select the complete game root containing Scene.pck and Gameexe.dat (or Gameexe.ini); names are case-insensitive. Keep every resource folder and relative path intact.

Game/
├── Scene.pck
├── Gameexe.dat
├── g00/
├── bgm/
├── koe/
├── mov/
└── wav/

AVG32

Gameexe.ini plus a PACL SEEN.TXT archive or loose SEENnnn.TXT scenarios, at the root, in DAT/ or in the #FOLDNAME.TXT folder. Keep the original AVG32 executable: its file identifies the save format revision.

Game/
├── Gameexe.ini
├── AVG3217M.EXE
├── SEEN.TXT
├── PDT/
├── KOE/
└── WAV/

UK2

AyPio PC-98 releases: UK2.CFG with UK2 TEXT .MES scripts, or Half-Pipe’s HP.EXE, NA.COM and AYPIO.CFG. Keep the original UK2.EXE or HP.EXE and every DLB, PDT, MAP and music file.

Game/
├── UK2.EXE
├── UK2.CFG
├── *.MES
├── *.DLB
├── *.PDT
└── *.MAP

Ren’Py

Import the parent of game/. Scripts: .rpy / .rpyc; modules: .rpym / .rpymc; archives: .rpa / signature-verified .bin. Modules or options/gui/screens alone are insufficient. Legacy data/ requires sibling renpy/__init__.py identifying Ren’Py. Mac root: .app/Contents/Resources/autorun/. RPA alone is not a standalone import.

Game/
├── game/
│   ├── script.rpyc
│   └── archive.rpa
└── renpy/

Game.app/
└── Contents/Resources/autorun/
    ├── game/
    └── renpy/

RPG Maker XP / VX / VX Ace

Select the complete game root containing Game.ini or the game's own mkxp.json configuration and its referenced Scripts data, loose or in an RGSS game archive. Keep original paths and all companion resources. Game.exe and Windows DLLs are not required to run the game. Detection identifies the RGSS profile; it does not guarantee every script works.

Game/
├── Game.ini
├── Game.rgss3a
├── Audio/
├── Fonts/
└── Movies/

Game/
├── Game.ini
├── Data/ (Scripts.rxdata …)
├── Graphics/
└── Audio/

Keep the complete original game, including its Data, Graphics, Audio, Fonts and Movies folders when present. A script, project file or archive without the other required resources is insufficient.

If the game requires an RTP, import a matching RTP folder, archive or official RTP installer through Settings → RPG Maker Runtime Resources, then select it in the game's details. If the game package includes its RTP, use Import Included RTP in the game's details. A game and an RTP pack are separate imports. Missing RTP resources may prevent the game from running correctly.

RPG Maker MV / MZ

Select the complete deployment, or its www/ web root. Requires an HTML entry, matching js/rpg_*.js (MV) or js/rmmz_*.js (MZ), js/main.js, js/plugins.js and data/System.json. Keep data/, js/, img/, audio/, movies/ and fonts/ together; a project file or plug-in alone is insufficient.

Game/www/
├── index.html
├── js/ (rpg_*.js / rmmz_*.js, main.js, plugins.js, plugins/)
├── data/System.json
└── img/ · audio/ · movies/ · fonts/

TyranoScript / TyranoBuilder

Select the complete export containing index.html, tyrano/ and data/. Keep tyrano/plugins/kag/kag.js, data/system/Config.tjs and data/scenario/first.ks; a scenario or plug-in alone is insufficient. Packed desktop exports are described under Engine Package Import.

Game/
├── index.html
├── tyrano/
└── data/
    ├── scenario/first.ks
    ├── system/Config.tjs
    └── bgimage/ · fgimage/ · bgm/ · sound/ · video/ · others/

KiriKiri

Select the complete game root: loose startup.tjs or System/Initialize.tjs, or a verified archive containing the startup scripts. XP3, executable-appended XP3 and ZIP/TAR/7z-backed roots are recognized. Keep archive names, subfolders, fonts and companion files intact. Many protected XP3 releases are decoded by built-in compatibility; others may need the matching xp3filter.tjs/.cf or title patch. An arbitrary XP3 or Windows executable is not enough.

Artemis

PF2/PF6/PF8 archives are read directly, including PF8 encryption. Import the complete game folder or an archive containing it. Keep PFS patches, split volumes (.pfs.NNN / .NNN) and loose resources together; the mounted set must contain system.ini and its BOOT script.

Game/
├── root.pfs
├── root.pfs.000
├── root.pfs.001
├── root.040
└── patch.pfs

TyranoScript / TyranoBuilder

NW.js and Electron exports are recognized in package.nw, app.nw, app/, www/, resources/ and assets/, Electron resources/app.asar, and NW.js data appended to a Windows executable. Import the original executable or archive when the game is packed.

Game/
├── Game.exe
└── package.nw/
    ├── index.html
    ├── tyrano/
    └── data/

Game/
├── Game.exe
└── resources/
    └── app.asar

ISO

ISO 9660 disc images, including Joliet and Rock Ridge filenames, and UDF images, including UDF-only and ISO/UDF bridge discs. Imports the game files without mounting the disc or running its Windows installer. Engine compatibility is checked after extraction. Audio CD tracks are not supported.

ZIP

ZIP and ZIP64, including APK, AAB, APKS, XAPK, APKM, and IPA game packages. Supports stored, Deflate, Deflate64, BZip2, LZMA and PPMd entries, plus password-protected ZipCrypto and AES archives. Split ZIP sets are not supported.

RAR

RAR 4 and RAR 5, including encrypted data and filenames, supported self-extracting archives, .partNN.rar sets, legacy .rar + .r00 sets, and raw split .rar.001 sets. Keep all volumes together and import their folder.

7-Zip

7z archives with LZMA, LZMA2, PPMd, BZip2 or Deflate data and BCJ filters, including AES password protection, encrypted filenames, raw split .7z.001 multipart sets, and supported self-extracting archives.

LHA/LZH

LHA/LZH header levels 0–3; LH0–LH7, LHD, LZS, LZ4, and LZ5 methods; Japanese CP932 filenames. Supported self-extracting packages use level 0 or 1 headers.

TAR

Uncompressed TAR, including v7, ustar, pax, and GNU variants.

TAR.XZ

TAR streams filtered with XZ.

TAR.GZ

TAR streams filtered with GZip/DEFLATE.

TAR.BZ2

TAR streams filtered with BZip2.

FreeArc

FreeArc archives from tested game installers, including .bin data files and archives inside RAR or ISO images. Unsupported compression methods are rejected.

CAB

Import a complete single CAB archive containing the game files; multi-cabinet sets are not supported. Legacy filenames are decoded with the code page the game's data confirms: CP932, GB18030, CP949, Big5 or Windows-1252.

DMG

Import a macOS disk image containing an RPG Maker XP, VX or VX Ace game. Single-file UDIF images with one HFS+, HFSX or APFS partition are supported; segmented images are not. Only the detected game root is extracted, without mounting the image or running macOS code.

Self-extracting game archives

Supported RAR, 7z, and LHA/LZH packages can be selected directly. A self-extracting ZIP is accepted when it holds a KiriKiri XP3 or an NW.js RPG Maker MV/MZ game. Game data is extracted without running the executable.

RPG Maker Compress Game Data

Select a supported RPG Maker XP, VX or VX Ace self-extracting game package created with Compress Game Data. ZScripter extracts its embedded CAB without running Windows code, then detects the game. An arbitrary Windows executable is not a game package; keep companion files when supplied.

Inno Setup

Setup data 1.2.10 through 6.7.0, ANSI and Unicode, read with innoextract. Codecs: stored, zlib, bzip2, LZMA1/2. Password-protected setups ask for the password; encrypted 6.5+ setups are not supported. External setup-*.bin: keep beside EXE; import the folder, including every disc image of a multi-disc set. Multi-language setups extract the default language. GOG Galaxy file parts are reassembled.

NSIS

NSIS 2 and 3, read with 7-Zip. ANSI and Unicode filenames; solid and non-solid zlib, bzip2 or LZMA payloads, including LZMA with a BCJ filter. Uninstallers and files installed outside the install folder are skipped.

Enigma Virtual Box

64-byte EVB pack header. Stored files or framed aPLib chunks. Structural detection; no product-version range implied.

Clickteam Install Creator

File-list layouts: v20/v24/v30/v35/v40 (internal versions). Codecs: stored, zlib, bzip2.

Smart Install Maker

5.04-style overlay/footer. Stored payloads only; install-root files only. Other versions require the same structure. Compressed payloads unsupported.

Actual Installer

Free edition installers in ZIP mode. Stored or Deflate data; only files bound for the install folder are extracted. Select the executable directly.

Linked data installers

Installers that keep their data in a .bin named after the executable. Stored or Snappy records. Keep both files together and import their folder.

iOS 15

Copy Launch Link from the game's Shortcuts & Home Screen page. In Shortcuts, add URL, paste the link, then add Open URLs.

Tap Share, then Add to Home Screen.

Tap the icon → Choose File. Select your saved icon, set the name, and tap Add.

Runtime Dialects

ONScripter Forks

PONScripter Fork Profiles

Automatic detection is the default. A profile can be selected per game when a fork’s behavior cannot be inferred reliably.

Script Formats

Save formats

Runtime

Runs the game’s TJS2 and KAG scripts; KiriKiri 2, Z and hybrid releases are detected. Compatibility depends on the title’s scripts, filters and plug-ins.

Scripts & resources

Save formats

Complete savedata/ · save/ · saves/ folders; ZScripter managed-state bundles, including legacy write-domain exports. Keep the game’s own state files together.

Compatibility

Windows .dll/.tpm names resolve only to implemented static plug-in aliases; Windows binaries are not executed. Some proprietary filters, plug-in APIs and advanced effects remain title-dependent. See Patches for importing title-specific overrides.

Runtime

Runs Artemis ASB/AST/IET scripts. Optional MetalFX scaling on supported devices; otherwise Native rendering.

Automatic tries IOS, ANDROID, then WINDOWS configurations with a valid BOOT script; encoding follows CHARSET. Override Game Platform Configuration or Text Encoding in game settings. Changes apply at the next launch.

Scripts & resources

Save formats

Import ZScripter JSON saves (.dat/.sav/.json), save folders or ZIPs. ZScripter bundles preserve all managed save state. Keep save files and thumbnails together; the save folder follows system.ini SAVEPATH.

Original Artemis binary saves are incompatible. Import saves only into the same game and edition.

Compatibility

Compatibility depends on the game’s scripts, E-mote models and shaders. Windows executables, DLLs and arbitrary native calls are not run. Translation is unavailable.

Runtime

Runs CatSystem2 KCS system scripts, FES menus and CST scenes with the Enginehost CatSystem2 interpreter, including E-mote characters and movies. View Mode, Screen Filter and the performance overlay apply while playing.

Bonus files the game exports are saved to Files, and links it opens go to the browser, each after you confirm.

Scripts & resources

Save formats

Import CS2SAVE files written by ZScripter or Enginehost, save folders or ZIPs. ZScripter bundles preserve all managed save state. Slots 160–167 are quick saves and 168–175 automatic saves.

Original Windows CatSystem2 saves use a different format and cannot be imported. Import saves only into the same game and edition.

Compatibility

Compatibility depends on the game's scripts, FES layouts and E-mote modules; an unknown particle module stops the game with an error. Windows executables and DLLs are read for archive keys only and never run. Keyboard input covers navigation keys; text entry is unavailable. Translation is unavailable.

Runtime

Runs the game’s own JavaScript core and plug-ins. MV legacy/1.3–1.5/1.6.x and MZ profiles; modified/community cores are detected separately. The game’s core is never replaced.

Scripts & resources

Standard MV/MZ encrypted images and audio use the game’s own key/runtime. MZ KNS decoding requires matching configuration. Preserve filenames and directory structure.

Save formats

Compatibility

This section covers MV/MZ; XP/VX/VX Ace are described separately below. RPG Maker 2000/2003 are unsupported. Plug-ins that need desktop Node/NW.js APIs or native code may not work; detection does not guarantee every plug-in works.

Runtime

Runs the Ruby scripts and RGSS1, RGSS2 or RGSS3 data of RPG Maker XP, VX or VX Ace games on the Ruby each was made for: 1.8.7 for XP and VX, 1.9.2 for VX Ace, and 3.1.3 for mkxp-z and modernized games. Windows executables and DLLs are not run; common Win32API calls for INI files, folders and key state are emulated. Closing a game returns to the library. Before launching another RPG Maker XP, VX or VX Ace game, restart ZScripter when prompted.

Game settings: RGSS Profile (Automatic, XP, VX, VX Ace), Ruby Version (Automatic, Ruby 1.8.7, Ruby 1.9.2, Ruby 3.1.3) and Renderer (Automatic, ANGLE, CPU).

Scripts & resources

WMA, WMV and MPG media are unsupported; the game shows a notice instead. Japanese, Chinese and Korean text uses iOS system fonts when the game's Windows font is absent.

Keep the complete original game, including its Data, Graphics, Audio, Fonts and Movies folders when present. A script, project file or archive without the other required resources is insufficient.

RTP & SoundFonts

Import your own XP, VX or VX Ace RTP packs (folders, archives or official RTP installers) and SF2 or SF3 SoundFonts through Settings → RPG Maker Runtime Resources, also reachable from a game's details and the Storage screen. A game's details show required RTP names and allow per-game choices, including Continue Without Pack. Packs are shared across games and are not bundled with ZScripter. When a game package includes its RTP, Import Included RTP installs it; otherwise importing the game does not supply packs, and missing packs may leave graphics or audio unavailable.

MIDI uses a bundled SoundFont unless an imported default or per-game choice applies; a valid SoundFont chosen by the game's own configuration takes precedence. Imported SoundFonts may be SF2 or SF3 (compressed); DLS cannot be imported. MIDI is synthesized without reverb or chorus, so it can differ from the original game, and insufficient memory may leave MIDI silent.

Save formats

Save import accepts conventional save files, save folders and native ZIPs; ZScripter save bundles preserve the game, data and home write domains. Native ZIP exports place save files from the game write domain at the root and other domains in ZScripter-DataDirectory and ZScripter-Home. Custom or encrypted save formats may be unverified; keep a backup and use a matching game release.

Save snapshots also preserve internal overlay state for rollback. Portable save transfers exclude that internal state and game scripts/assets. Snapshots record progress already saved by the game; they are not suspended running sessions.

Compatibility

RGSS compatibility is experimental and remains title-dependent. Import detection or reaching a title screen does not verify a complete game. Windows native extensions, Ruby JIT, arbitrary DLL calls and process spawning are unavailable; some custom scripts and effects need adaptation. Large images or other allocations can fail with NoMemoryError. Keep the original game files and saves.

Runtime

Game Platform: Computer plays the game as released for computers; Phone or Tablet plays its mobile version, which a few games need. Turn off Known-Issue Fixes if a game behaves differently than on a computer. Changes apply at the next launch. View Mode, Text Size, Screen Filter and the performance overlay apply while playing.

Scripts & resources

Save formats

_tyrano_data holds every save slot, _tyrano_auto_save and _tyrano_quick_save the automatic and quick saves, and _sf progress shared across playthroughs. Import .sav files from a computer, JoiPlay saves, save folders or ZIPs. ZScripter bundles preserve all save state.

Compatibility

Compatibility depends on the game's plug-ins. Plug-ins that need Windows-only features may not work; Windows executables are never run. Translation and MTool dictionaries are unavailable.

Game files

Resource formats

Save containers

Scripts & resources

Save formats

Scripts & resources

Save formats

Scripts & resources

Save formats

Runtime

Runs the game’s scripts on the bundled Ren’Py runtime matching its release, listed below, or the nearest compatible release; the release can be changed per game. Closing a game returns to the library. Before launching another imported Ren’Py game, restart ZScripter when prompted.

Scripts & resources

Save formats

Ren’Py 6.15

2 exact releases

Ren’Py 6.17

4 exact releases

Ren’Py 6.18

1 exact releases

Ren’Py 6.99

19 exact releases

Ren’Py 7.0

1 exact releases

Ren’Py 7.1

3 exact releases

Ren’Py 7.2

3 exact releases

Ren’Py 7.3

5 exact releases

Ren’Py 7.4

12 exact releases

Ren’Py 7.5

5 exact releases

Ren’Py 7.6

3 exact releases

Ren’Py 7.7

2 exact releases

Ren’Py 7.8

5 exact releases

Ren’Py 8.0

7 exact releases

Ren’Py 8.1

8 exact releases

Ren’Py 8.2

7 exact releases

Ren’Py 8.3

10 exact releases

Ren’Py 8.4

8 exact releases

Ren’Py 8.5

21 exact releases

Ren’Py 8.6

20 exact releases

View the save editor

Save fields with their types and values.

Find a value

Search by field name, value, type, or path, and filter by type. View → Include Internal Fields shows engine fields. Open lists and dictionaries to browse their entries; use the path buttons to go back. A field's menu can copy its value, path, or object ID.

View → Complete Pickle Graph opens additional data, including rollback history. With no field selected, the status bar shows the signature status.

Edit values

Edit numbers or text directly, step whole numbers with + and −, or toggle true/false values. Change a field's type from its row or menu. Dictionary keys can be renamed, and entries can be removed. Add Value inserts entries or empty containers. It can also refer to an existing object.

Undo and Redo (⌘Z, ⇧⌘Z) step through pending edits. Discard All Edits clears them.

Apply changes

Open Review Changes, then choose Save Changes (⌘S). The app first creates a Save Edit Safety Snapshot. Restore it from the Save Timeline to undo a saved edit. If you leave with unsaved edits, the app asks whether to save them.

The game may overwrite edited values after loading or using rollback. Invalid values can prevent a save from loading. Some files and fields allow inspection only.

Provider & API key

Open Settings → Translation. Choose Apple for on-device translation, or Google Gemini, OpenAI, OpenRouter, DeepSeek, or Local LLM. Cloud providers need your API key. It saves when you finish editing and stays in this device's Keychain. Local LLM connects to LM Studio or another OpenAI-compatible server. Enter its Server URL using your computer's LAN address; the API key is optional. Use Discover models and Test connection.

Choose and test a model

Choose the model used for cloud translation. Check the model's capabilities and pricing. Find and add another model offered by the provider. Send a test request to check the key and model; provider charges may apply.

Enable translation

Open the game's details, then Translation under Game Settings. Turn translation on for this game. LLM translation asks permission once for all providers and games on this device; Revoke LLM Translation Permission withdraws it. Use the app's provider and model. Turn off to choose them for this game.

Languages & display

Choose the language the game is written in. Choose the language you want to read. Original keeps the source; Translated replaces it; Compare shows both.

Translate ahead

Prepare upcoming dialogue while you read; cloud usage can increase. For Apple translation, choose how many lines to prepare (1–50).

Provider & display while playing

Open Runtime Settings from the control strip, then Translation. Switch this game's provider, or return to Use App Settings. Switch between Original, Translated, and Compare without leaving the game. The Compare panel can be moved and resized.

API key, model & style

Expand to edit cloud credentials, model, and writing style. Save an edited key immediately; finishing editing also saves it. Faithful stays close to the source; Natural reads smoothly; Literary uses a more literary tone. Add preferred names, terminology, or tone for cloud translations. Apply the model and instructions to this game.

Cache & offline models

Remove this game's cached translations. Saves and language settings are kept. On a physical device with iOS 18 or later, Download Language Models prepares both languages for offline use. Refresh Model Status checks readiness.

1) Open Local Updates & Patches

In game details, open Local Updates & Patches. Tap Apply Local Update or Patch and choose a type, then select the patch folder or archive.

2) Enable and order patches

Use the switch to enable a patch. Use Edit or the patch menu to reorder; later patches win when files overlap. Changes rebuild the game. Rollback restores an earlier snapshot.

Import formats

Package contents

Keep game-relative paths:

Replacement game files: JSON data, JavaScript plug-ins, images and audio. For MTool dictionaries, choose MTool Translation (JSON).

Optional zs-content-layer.json or manifest.json: the deletes field lists relative file paths to remove.

MTool Translation (JSON)

Supports RPG Maker MV/MZ. Imported dictionaries translate dialogue, choices, names, menus and plug-in text offline on the next launch.

1) Import a patch

Open Patches → Import Patch and select a ZIP, folder, or TJS, CF, KSC, or XP3 files. Turn off Enable Patches to install patches for later.

2) Check Attached Patches

Enable Patches controls all patches. Choose individual files below; those choices are kept while patches are off. Changes apply on the next launch. Delete Patch removes only the imported copy; your game and saves are kept.

Import formats

Other files in a selected folder or ZIP are skipped.

Patch Bundle Files

Plug-in Request Files

1) Open Local Updates & Patches

In game details, open Local Updates & Patches. Tap Apply Local Update or Patch and choose a type, then select the patch folder or archive.

2) Enable and order patches

Use the switch to enable a patch. Use Edit or the patch menu to reorder; later patches win when files overlap. Changes rebuild the game. Rollback restores an earlier snapshot.

Import formats

Package contents

Keep game-relative paths:

Replacement game files: KAG scenarios, Config.tjs, plug-ins, images, audio and video.

Optional zs-content-layer.json or manifest.json: the deletes field lists relative file paths to remove.