百科全书

ZScripter 4.2.0 参考资料

support@zscripter.com

联系支持时,请提供应用版本、iOS 或 iPadOS 版本、设备型号、游戏名称和问题复现步骤。

导入

选择游戏文件夹、压缩包或可执行文件,应用会自动识别格式。

轻点“+”可选择“从文件导入”“网页导入器”或“导入帮助”。导入 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 App 结构会被自动识别。

常见结构
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

支持未压缩 TAR,包括 v7、ustar、pax 和 GNU 变体。

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 分支配置文件

原版 / 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
CLANNAD原版PC版
Kanon标准版 · 全年龄
Little Busters!リトルバスターズ! · 原版PC版
星之梦planetarian ~ちいさなほしのゆめ~ · 盒装版

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
At Summer’s Endなつのおわりに
Ballad of an Evening Butterfly
Bluebird’s Illusion
Eternity永遠
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
My Black Cat私の黒猫
Narcissu
Night of the Forget-Me-Nots
OMGWTFOTL
Plain Song
Plumerai
Pray [Apocripha/0 温泉物]Pray [Apocripha/0 溫泉物]
Red Shift常世の星空
SALAMANDER
Shooting Star Hill
The Boy I Like? 2すきなおとこのこ?
The Caged Vagrant
The Letter
The Little Prince
The Moon to the East, the Sun to the West ~Operation Sanctuary~月は東に日は西に ~Operation Sanctuary~
The noose
The world to reverse.
Wanderers in the Sky空の迷い人
~Plain Song~ Christmas Special
人数え
可怜的小鸟かわいそうな小鳥
向日之梦向日の夢
在意的男孩子?きになるおとこのこ?
天使的工作 -their wishes afterward-天使のお仕事 -their wishes afterward-
寒蝉鸣泣之时ひぐらしのなく頃に
月姬月姫
海猫鸣泣之时うみねこのなく頃に
海猫鸣泣之时散うみねこのなく頃に散
阿卡迪亚Arcadia -阿卡迪亞-
黑血
返回章节
存档快照

存档快照是某个游戏全部存档的副本,也包含持久数据。快照记录的是游戏已经保存的进度。

创建快照

从游戏库工具栏打开存储,选择一个游戏。点击立即快照存档可创建手动快照,也可通过存储菜单一次快照所有游戏。创建或恢复快照前,请先在游戏内存档并关闭游戏。

查看存档时间线示例
存档时间线中的快照操作菜单。 打开完整尺寸图片

自动快照

自动快照默认开启,在游戏启动前创建,每个游戏保留10份。另一种触发方式会在打开或返回应用时检查,每个游戏每24小时最多检查一次。没有存档或存档未变化时会跳过。

在存储菜单的存档快照默认设置中,可选择触发方式,将每个游戏的自动快照上限设为1至100份,也可关闭自动快照。单个游戏的存档快照设置可覆盖默认值。超出上限时会删除最旧的自动快照。手动快照和恢复用快照会一直保留,直到手动删除。

恢复存档

在游戏的存档时间线中打开某个快照的菜单,选择恢复此快照。这会替换全部当前存档,快照创建后新增的存档文件也会被移除。应用会先将当前存档保存在恢复前快照中,可用它撤销本次恢复。

管理快照

时间线显示每份快照的日期、创建原因、文件数和大小,可按日期或大小排序。快照菜单可将其导出为ZIP,也可删除快照。删除快照不影响当前存档。

快照保存在本机上。若要在其他位置保留副本,请先导出。删除游戏后,快照仍会保留在存储菜单的所有快照与归档中。

返回章节
存档编辑器

存档编辑器可修改Ren'Py的存档槽位和持久数据,例如不同周目共用的鉴赏解锁记录。

选择文件

关闭游戏后,从游戏选项进入存储,再从右上角菜单选择存档编辑器。选择一个.save存档或persistent文件。若列表为空,请先在游戏内保存一次,或导入存档。

查看存档编辑器示例
存档字段及其类型和值。 打开完整尺寸图片

查找值

可按字段名、值、类型或路径搜索,也可按类型筛选或隐藏内部字段。打开列表或字典可查看其中的条目,点击路径按钮可返回上层。字段菜单可复制值或路径。

完整Pickle图可查看回滚历史等更多数据。文档详情会显示签名状态。这两项均在右上角菜单中。

编辑值

可直接编辑数值或文本,也可切换真/假值。字段菜单可更改类型。字典键可重命名,条目可删除。添加值可插入条目或空容器,也可引用已有对象。

撤销和重做可逐步调整尚未保存的编辑。放弃所有编辑会清除这些更改。

应用更改

打开检查更改,然后选择保存更改。应用会先创建编辑存档前快照。若要撤销已保存的编辑,可从存档时间线恢复这份快照。

读取存档或使用游戏内回滚后,游戏可能重新写入已编辑的值。无效值可能导致存档无法读取。部分文件和字段仅供查看。

返回章节
手柄

ZScripter可使用iOS或iPadOS识别的手柄。可用按钮和操作取决于手柄及游戏引擎。

支持的手柄

系列型号
PlayStationDualShock 4
DualSense
DualSense Edge
Xbox无线手柄(蓝牙版,型号1708)
Series X|S无线手柄
Elite无线手柄第2代
自适应手柄
Nintendo SwitchPro手柄
Joy-Con(左/右)
MFi及移动设备Backbone One(适配iPhone的型号)
其他MFi手柄

其他手柄只要能被iOS或iPadOS识别为游戏手柄,也可能使用。兼容性及可用按键取决于系统和手柄固件版本。

连接手柄

通过蓝牙配对手柄,或用线缆连接。在应用设置中打开控制,选择引擎,再打开实体手柄。连接手柄后,示意图会以绿色显示当前输入,不可用的控件会变暗。未连接手柄时,也可通过预览布局配置。

查看手柄设置示例
手柄示意图及所选按钮的操作绑定。 打开完整尺寸图片

分配按钮操作

在自定义绑定中,点击示意图中的按钮,再点击所选控件下的操作。所有控件列出可用的绑定。按下按钮以选择可通过手柄上的实际输入选中控件。

更改会自动保存,并应用于使用该引擎的所有游戏。触控布局有独立的设置。

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 — 别名到目标的映射
返回章节