百科事典

ZScripter 4.2.0 リファレンス

support@zscripter.com

お問い合わせの際は、アプリのバージョン、iOS または iPadOS のバージョン、機種、ゲーム名、問題の再現手順をお知らせください。

インポート

ゲームフォルダ、アーカイブ、実行ファイルを選択してください。形式は自動で判別されます。

「+」をタップすると、「ファイルから」「Webインポータ」「インポートヘルプ」を選べます。分割RAR・7zはすべてのパートを同じフォルダに置き、そのフォルダを選択してください。

フォルダのインポート

NScripter系

認識されるルートマーカー

0.txt
00.txt
0.u
00.u
0.utf
0.utf.txt
00.utf
00.utf.txt
nscr_sec.dat
nscript.___
nscript.dat
pscript.dat

認識可能なスクリプトマーカーをゲームルートに置きます。個別のリソースやNSA/SARリソースアーカイブは同じ階層に配置できます。

標準的な構成
Game/
├── 0.txt
├── arc.nsa
├── arc1.nsa
└── default.ttf
別の構成
Game/
├── 0.utf
├── pscript.dat
└── arc.sar

RealLive

認識されるルートマーカー

Gameexe.ini + Seen.txt
KINETICDATA/
REALLIVEDATA/

ルート直下、または直下のKINETICDATA/REALLIVEDATA内にGameexe.iniとSeen.txtが必要です。大文字・小文字は区別しません。参照リソースと相対パスを保持してください。AVG32、Siglus、.ezk/.ezsのみのパッケージは非対応です。

標準的な構成
Game/
├── Gameexe.ini
├── Seen.txt
├── G00/
├── BGM/
├── WAV/
└── KOE/
別の構成
Game/
└── KINETICDATA/ (or REALLIVEDATA/)
    ├── Gameexe.ini
    ├── Seen.txt
    └── … resources

Ren’Py

認識されるルートマーカー

game/ → *.rpy
game/ → *.rpyc
game/ → *.rpa
game/ → RPA data.bin
data/ + renpy/__init__.py

スクリプトまたはRPAデータを含むgameディレクトリを使用します。従来のdataディレクトリには同階層のRen’Pyエンジンマーカーが必要です。パッケージ化されたMacアプリ構成は自動検出されます。

標準的な構成
Game/
├── game/
│   ├── script.rpyc
│   └── archive.rpa
└── renpy/
パッケージ化されたMac構成
Game.app/
└── Contents/Resources/autorun/
    ├── game/
    └── renpy/

エンジンパッケージのインポート

ベータ版エンジンの参考資料です。App Store 配布版では KiriKiri をインポートできません。

KiriKiri

startup.tjs
System/Initialize.tjs
XP3 ベースのルート
実行ファイル末尾の XP3
ZIP ベースのルート
TAR ベースのルート
7-Zip ベースのルート

展開済みルート、XP3 ベースのルート、実行ファイル末尾の XP3、および埋め込み起動ルートが一意に確定できる検証済み汎用コンテナに対応します。

アーカイブファイルのインポート

ZIP

.aab
.apk
.apkm
.apks
.ipa
.xapk
.zip

ZIP・ZIP64に加え、APK、AAB、APKS、XAPK、APKM、IPAのゲームパッケージに対応しています。無圧縮、Deflate、対応するLZMAエントリを読み込めます。暗号化エントリには対応していません。

RAR

.rar

RAR 4・RAR 5に対応しています。対応する自己解凍形式、.partNN.rar形式、旧形式の.rar + .r00の分割アーカイブも読み込めます。

7-Zip

.7z

LZMAまたはLZMA2データの7zアーカイブに対応します。生分割された.7z.001マルチパートセットも含みます。

LHA/LZH

.lha
.lzh

LHA/LZHのヘッダレベル0~3、LH0~LH7・LHD・LZS・LZ4・LZ5方式、日本語CP932ファイル名に対応しています。自己解凍形式はヘッダレベル0・1に対応しています。

TAR

.tar

v7、ustar、pax、GNUバリアントを含む無圧縮TARに対応します。

TAR.XZ

.tar.xz
.txz
.xz

XZでフィルターされたTARストリームです。

TAR.GZ

.gz
.tar.gz
.tgz

GZip/DEFLATEでフィルターされたTARストリームです。

TAR.BZ2

.bz2
.tar.bz2
.tbz
.tbz2

BZip2でフィルターされたTARストリームです。

実行ファイルのインポート

自己解凍ゲームアーカイブ

ZIP
RAR
LHA/LZH

対応するZIP・RAR・LHA/LZHの自己解凍パッケージを直接選択できます。実行ファイルを起動せずにゲームデータを取り出します。

Inno Setup

5.1.2
5.3.9
5.3.10
5.4.2
5.5.0
5.5.6
6.0.0
6.1.0
6.7.0

ANSI形式は5.5.6まで、Unicode形式は5.3.9以降に対応します。無圧縮、zlib、bzip2、LZMA1、LZMA2ペイロードを処理できます。

NSIS

NSIS 2.x形式のヘッダーレイアウト

ANSI・Unicodeのファイル名と、非ソリッド・ソリッドのDeflate/LZMAデータに対応しています。ソリッドbzip2とBCJフィルタ付きLZMAには対応していません。

Enigma Virtual Box

埋め込みVFS
無圧縮ペイロード

ファイルが圧縮されずに格納された埋め込みファイルシステムに対応します。

セクションに戻る
対応エンジン

NScripter / ONScripter / PONScripter

ランタイム方言

NScripter
ONScripter
PONScripter

ONScripterの派生版

ONScripter
ONScripter-EN

PONScripterフォークプロファイル

Original / Mion(2011)
Sekai Project Steam
Witch Hunt(1x)
Witch Hunt(2x)
07th-Mod v3
07th-Mod v4

既定では自動検出されます。フォークの動作を確実に推測できない場合は、ゲームごとにプロファイルを選択できます。

スクリプト形式

0.txt
00.txt
0.utf
00.utf
nscript.dat
nscript.___
nscr_sec.dat
pscript.dat

KiriKiri

ベータ版エンジンの参考資料です。App Store 配布版では KiriKiri をインポートできません。

ランタイムファミリー

KiriKiri 2
KiriKiri Z
混合/不明の互換性プロファイル

RealLive

ゲームファイル

Gameexe.ini + Seen.txt
Seen.txt: 10002 · 110002 · 1110002
CP932 · CP936 · Windows-1252 · CP949

リソース形式

G00 · PDT · ANM · GAN · HIK
WAV · NWA · Ogg Vorbis
KOE · NWK · OVK

セーブの形式

saveNNN.sav.gz
global.sav.gz
セーブフォルダ
ZIPアーカイブ(.zip)
ZScripterセーブバンドル(.json)

Ren’Py

Ren’Py 6.15

2個の完全一致リリース

6.15.4
6.15.7

Ren’Py 6.17

4個の完全一致リリース

6.17.3
6.17.4
6.17.6
6.17.7

Ren’Py 6.18

1個の完全一致リリース

6.18.3

Ren’Py 6.99

19個の完全一致リリース

6.99.1
6.99.3
6.99.4
6.99.5
6.99.6
6.99.7
6.99.8
6.99.9
6.99.10
6.99.11
6.99.12
6.99.12.2
6.99.12.3
6.99.12.4
6.99.13
6.99.14
6.99.14.1
6.99.14.2
6.99.14.3

Ren’Py 7.0

1個の完全一致リリース

7.0.0

Ren’Py 7.1

3個の完全一致リリース

7.1.0
7.1.1
7.1.3

Ren’Py 7.2

3個の完全一致リリース

7.2.0
7.2.1
7.2.2

Ren’Py 7.3

5個の完全一致リリース

7.3.0
7.3.2
7.3.3
7.3.4
7.3.5

Ren’Py 7.4

12個の完全一致リリース

7.4.0
7.4.1
7.4.2
7.4.3
7.4.4
7.4.5
7.4.6
7.4.7
7.4.8
7.4.9
7.4.10.2178
7.4.11.2266

Ren’Py 7.5

5個の完全一致リリース

7.5.0.22043001
7.5.0.22051201
7.5.0.22062402
7.5.1.22070801
7.5.3.22090809

Ren’Py 7.6

3個の完全一致リリース

7.6.0.23051307
7.6.1.23060707
7.6.3.23091805

Ren’Py 7.7

2個の完全一致リリース

7.7.0.24012702
7.7.1.24030407

Ren’Py 7.8

2個の完全一致リリース

7.8.2.24090902
7.8.4.24120703

Ren’Py 8.0

7個の完全一致リリース

8.0.0.22052902
8.0.0.22062402
8.0.1.22070801
8.0.2.22081402
8.0.3.22083102
8.0.3.22090405
8.0.3.22090809

Ren’Py 8.1

8個の完全一致リリース

8.1.0.23042213
8.1.0.23050201
8.1.0.23051307
8.1.1.23060707
8.1.2.23072301
8.1.2.23081503
8.1.2.23090503
8.1.3.23091805

Ren’Py 8.2

7個の完全一致リリース

8.2.0.23100201
8.2.0.23121803
8.2.0.24012702
8.2.1.24030407
8.2.2.24060703
8.2.2.24061201
8.2.3.24061702

Ren’Py 8.3

10個の完全一致リリース

8.3.0.24071306
8.3.0.24082114
8.3.1.24090601
8.3.2.24090902
8.3.3.24111502
8.3.4.24120703
8.3.6.25022803
8.3.7.25031702
8.3.8.25042301
8.3.8.25051901

Ren’Py 8.4

8個の完全一致リリース

8.4.0.25052403
8.4.0.25071206
8.4.1.25071908
8.4.1.25072401
8.4.2.25073104
8.4.2.25082401
8.4.2.25111201
8.4.2.25111701

Ren’Py 8.5

12個の完全一致リリース

8.5.0.25110801
8.5.0.25111603
8.5.1.25122301
8.5.1.25123106
8.5.2.26010301
8.5.3.26012801
8.5.3.26021801
8.5.3.26031801
8.5.3.26032401
8.5.3.26043002
8.5.3.26051504
8.5.4.26061901

Ren’Py 8.6

1個の完全一致リリース

8.6.0.25112601
セクションに戻る
互換性

RealLive

互換性あり

AIRスタンダードエディション · +Voice1.02
CLANNADPCオリジナル版
Kanonスタンダードエディション · 全年齢対象版
planetarian ~ちいさなほしのゆめ~パッケージ版
リトルバスターズ!PCオリジナル版

NScripter系

互換性あり

40 Days and 40 Nights of Rain
A Dream of Summer
A Happy Valentine
A Midsummer Day’s Resonance
A Winter’s Tale
Agnus Dei
Arcadia -阿卡迪亞-
Ballad of an Evening Butterfly
Bluebird’s Illusion
Exile Gear Raynar
FLOOD OF TEARS
From the Bottom of the Heart
Instant Death! Panda Samurai
Its your last chance in new school
Kagetsu Tohya
Kira ~snowdrop~
LEAVEs
May Sky
Moonshine
Narcissu
Night of the Forget-Me-Nots
OMGWTFOTL
Plain Song
Plumerai
Pray [Apocripha/0 温泉物]Pray [Apocripha/0 溫泉物]
SALAMANDER
Shooting Star Hill
The Caged Vagrant
The Letter
The Little Prince
The noose
The world to reverse.
~Plain Song~ Christmas Special
うみねこのなく頃に
うみねこのなく頃に散
かわいそうな小鳥
きになるおとこのこ?
すきなおとこのこ?
なつのおわりに
ひぐらしのなく頃に
人数え
向日の夢
天使のお仕事 -their wishes afterward-
常世の星空
月は東に日は西に ~Operation Sanctuary~
月姫
永遠
私の黒猫
空の迷い人
黑血
セクションに戻る
セーブスナップショット

セーブスナップショットは、永続データを含む、そのゲームの全セーブデータのコピーです。ゲーム内で保存済みの進行状況を記録します。

スナップショットの作成

ライブラリのツールバーからストレージを開き、ゲームを選びます。「今すぐセーブをスナップショット」で手動スナップショットを作成できます。ストレージのメニューから全ゲームをまとめてスナップショットすることもできます。スナップショットの作成や復元の前に、ゲーム内でセーブしてゲームを終了してください。

セーブ履歴の例を見る
セーブ履歴にあるスナップショットの操作メニュー。 元のサイズで画像を開く

自動スナップショット

自動スナップショットは初期設定で有効です。ゲームの起動前に作成し、ゲームごとに10件を保持します。もう一つのタイミング設定では、アプリを開いたときや戻ったときに、ゲームごとに24時間に1回まで確認します。セーブがない場合や内容が変わっていない場合は作成しません。

ストレージのメニューにある「セーブスナップショットの既定設定」で、作成タイミングとゲームごとの保持数を1〜100件に設定できます。自動スナップショットを無効にすることもできます。ゲームごとの「セーブスナップショット設定」で既定値を変更できます。上限を超えると古い自動スナップショットから削除されます。手動と復旧用のスナップショットは、自分で削除するまで残ります。

セーブの復元

ゲームの「セーブ履歴」でスナップショットのメニューを開き、「このスナップショットを復元」を選びます。現在のセーブデータ全体が置き換わり、スナップショット作成後に追加されたファイルも削除されます。先に現在のセーブが「復元前」スナップショットとして保存されるので、それを復元すれば元に戻せます。

スナップショットの管理

履歴には各スナップショットの日時、作成理由、ファイル数、サイズが表示されます。日時やサイズで並べ替えられます。スナップショットのメニューからZIPの書き出しや削除ができます。スナップショットを削除しても、現在のセーブは残ります。

スナップショットはこのデバイス内に保存されます。別の場所に保管するには書き出してください。ゲームを削除した後も、ストレージのメニューにある「すべてのスナップショットとアーカイブ」から確認できます。

セクションに戻る
セーブエディター

セーブエディターでは、Ren'Pyのセーブスロットや、周回をまたいで共有するCG鑑賞の解放状況などの永続データを編集できます。

ファイルの選択

ゲームを終了し、ゲームのオプションからストレージを開いて、右上のメニューで「セーブエディター」を選びます。拡張子が.saveのスロットかpersistentファイルを選択します。一覧が空なら、ゲーム内で一度セーブするか、セーブをインポートします。

セーブエディターの例を見る
セーブ内のフィールドと、その型や値。 元のサイズで画像を開く

値の検索

フィールド名、値、型、パスで検索できます。フィルターで型を絞り込んだり、内部フィールドを非表示にしたりできます。リストや辞書を開くと中の項目を確認でき、パスのボタンで前の階層に戻れます。フィールドのメニューから値やパスをコピーできます。

「Pickleグラフ全体」では、ロールバック履歴などの追加データを確認できます。「ドキュメントの詳細」には署名の状態が表示されます。どちらも右上のメニューにあります。

値の編集

数値やテキストを直接編集したり、真偽値を切り替えたりできます。フィールドのメニューで型を変更できます。辞書のキーは名前を変更でき、項目は削除できます。「値を追加」で項目や空のコンテナーを挿入でき、既存のオブジェクトへの参照も追加できます。

「取り消す」と「やり直す」で、保存前の編集を一つずつ戻したり進めたりできます。「すべての編集を破棄」で、保存前の変更を消去します。

変更の保存

「変更を確認」を開き、「変更を保存」を選びます。先に「セーブ編集前」スナップショットが作成されます。保存済みの編集を取り消すには、「セーブ履歴」からそのスナップショットを復元します。

ロード後やゲーム内のロールバックで、編集した値が上書きされることがあります。不正な値を設定すると、セーブを読み込めなくなる場合があります。一部のファイルやフィールドは閲覧のみ可能です。

セクションに戻る
コントローラー

ZScripterでは、iOSやiPadOSが認識するコントローラーを使えます。使えるボタンや操作は、コントローラーとゲームエンジンによって異なります。

対応コントローラー

シリーズモデル
PlayStationDualShock 4
DualSense
DualSense Edge
Xboxワイヤレスコントローラー(Bluetooth対応・モデル1708)
Series X|Sワイヤレスコントローラー
EliteワイヤレスコントローラーSeries 2
Adaptive Controller
Nintendo SwitchProコントローラー
Joy-Con(L/R)
MFi・モバイルBackbone One(iPhone対応モデル)
その他のMFiゲームパッド

iOSまたはiPadOSがゲームパッドとして認識するコントローラーなら、ほかのモデルも使用できます。対応状況と使えるボタンは、OSとコントローラーのファームウェアのバージョンによって異なります。

コントローラーの接続

Bluetoothでペアリングするか、ケーブルで接続します。アプリの設定で「操作」を開き、エンジンを選んで「外部コントローラー」を開きます。接続中は、入力した箇所が図の上で緑色になり、使えない操作は薄く表示されます。未接続でもプレビューで設定できます。

コントローラー設定の例を見る
コントローラーの図と、選択したボタンへの割り当て。 元のサイズで画像を開く

ボタンの割り当て

「カスタム割り当て」で図のボタンをタップし、「選択した操作」の下にある動作をタップします。「すべての操作」で割り当てを一覧できます。「ボタンを押して選択」では、実際のコントローラーを操作して選べます。

変更は自動で保存され、同じエンジンを使う全ゲームに適用されます。タッチ操作のレイアウトは別に設定します。

Ren'Pyの入力モード

「ネイティブゲームパッド」では、対応するRen'Pyゲーム側の割り当てを使います。古いランタイムでは、保存済みのカスタム割り当てを使います。ゲームの操作を割り当てたり、スティックでマウスを動かしたりするには、「カスタム割り当て」に切り替えます。

スティックとトリガーの調整

「スティックと感度」で、各スティックを方向ボタン、マウスカーソル、スクロールに設定できます。オフにもできます。ドリフトが起きる場合はデッドゾーンを広げます。速度や応答曲線で動き方を調整でき、横方向と縦方向の反転も可能です。

「トリガーの作動点」で、反応する押し込み量を設定します。方向ボタンは押し続けている間にリピートでき、開始までの時間と間隔を調整できます。「コントローラーの初期設定に戻す」で、選択中のエンジンの割り当てとスティック設定をリセットします。

セクションに戻る
翻訳

翻訳はRen'Pyゲーム向けのベータ機能です。会話やメニューのテキストを翻訳します。画像に描かれた文字は変わりません。

翻訳を有効にする

Ren'Pyゲームの詳細から「翻訳」を開き、原文と訳文の言語を設定して「ゲームのテキストを翻訳」を有効にします。「アプリの設定を使用」では、アプリの設定の「翻訳」で選んだプロバイダーを使います。オフにするとゲームごとに選べます。プレイ中は「ゲーム設定」の「翻訳」でも変更できます。

プロバイダー設定の例を見る
クラウドプロバイダーのAPIキーとモデルの設定。 元のサイズで画像を開く

プロバイダーの選択

Appleは端末内で翻訳し、iOS 18以降を搭載した実機のiPhoneまたはiPadが必要です。ゲーム内の「言語モデルをダウンロード」で両方の言語を準備します。インストール後は、対応する言語の組み合わせをオフラインで翻訳できます。

Gemini、OpenAI、DeepSeek、OpenRouterには、インターネット接続と自分のAPIキーが必要です。キーはアプリの設定の「翻訳」で登録します。クラウド翻訳を許可すると、プロバイダーにゲームのテキストと会話の文脈が送られ、利用料金が発生します。ゲーム内のパネルで文体を選び、独自の指示を追加できます。許可は翻訳設定で取り消せます。

原文との比較

「原文」は元のテキストを、「翻訳文」はゲーム内に訳文を表示します。「比較」では両方を表示するパネルが追加されます。上部をドラッグして移動し、下端をドラッグしてサイズを変えられます。

「先読み翻訳」は先の会話を準備して待ち時間を減らします。クラウド翻訳ではそのテキストも送信されるため、使用量が増える場合があります。翻訳に失敗した場合は原文が残ります。「翻訳を再試行」でやり直せます。

保存済みの翻訳を消去

「翻訳キャッシュを消去」で、このゲームの保存済みの訳文を削除します。訳文はプレイ中に再生成されます。言語設定とAppleのダウンロード済みモデルは残ります。

セクションに戻る
パッチ

KiriKiri

ベータ版エンジンの参考資料です。App Store 配布版では KiriKiri をインポートできません。

パッチバンドルファイル

.tjs — 起動、フィルター、ブートストラップ、オーバーライド用スクリプト
.xp3 — パッチアーカイブ
.cf / .key / .cfg / .ksc — フィルターおよび補助データ
.zip / .7z — カタログバンドル内の補助アーカイブ

プラグイン要求ファイル

*.dll — 要求エイリアスのみ
plugin-catalog/catalog.json — エイリアスからターゲットへのマップ
セクションに戻る