点击 data.xp3 后游戏没反应或闪退

排查清单（按顺序检查）

1. 确认文件本身没损坏

传输过程中如果数据线不稳定或 WiFi 断开，文件可能传了一半。最简单的检查方法：

• 对照电脑上的源文件，看 XP3Player 里的文件大小是否一致
• 如果用压缩包传的，确认解压完全（没有残留的临时文件或 .part 文件）

大小不一致 = 重传。

2. 确认路径中没有特殊字符

GalGame 文件夹名如果包含某些特殊字符（# @ ~ | \ / : * ? " < >），KiriKiri 引擎可能解析路径失败。建议：

• 文件夹名用纯中文或英文+数字
• 不要加表情符号、全角标点等

3. 确认 XP3 文件真的是 XP3 格式

有些游戏的资源包虽然后缀是 .xp3，但实际上被改过或损坏了。在电脑上用十六进制查看器打开，XP3 文件的开头应该有特定的文件头标识。

或者试试在电脑上用 KiriKiri 官方模拟器打开同一个游戏——如果电脑上都跑不起来，XP3Player 肯定也不行。

4. 检查游戏是否需要先解密

部分 GalGame 的 XP3 资源包有加壳保护。参见 转换与解密 XP3 封包。

5. iOS 16+ 弹窗闪退提前触发

有些游戏启动流程本身就包含弹窗（比如"选择存档位"），iOS 16+ 上可能在启动阶段就触发闪退。这种情况和保存闪退是同一个问题，参见 iOS 16+ 闪退现状。

6. 兼容性——确认引擎版本

KiriKiri 引擎有多个版本：

• KiriKiri 2 → XP3Player 完美支持 ✓
• KiriKiri 3 → XP3Player 可能支持也可能不支持 ✗
• KiriKiri Z → KiriKiri 2 的增强版，大部分兼容 ✓
• TyranoScript → 虽然脚本后缀也是 .tjs，但不是 KiriKiri 引擎，大概率不支持 ✗

进阶排查

看控制台日志（开发者模式）

如果你的设备开启了开发者模式，可以用 Mac 连接设备后通过 Xcode Console 查看崩溃日志。搜索关键词：XP3Player 或 kiriKiri，看崩溃前最后一条日志是什么。

换一个游戏试试

如果同时装了多个 GalGame，用另一个已知能跑的游戏测试 XP3Player 本身是否正常。如果另一个能跑，说明问题在当前游戏本身；如果都不能跑，说明 XP3Player 安装可能有问题（试试卸载重装）。

一键判断

电脑上 Kirikiri 模拟器能跑 + iOS 上文件结构正确 + iOS 版本 ≤ 15 = 基本没问题。只要满足这三个条件，data.xp3 一定能启动。