启动方式与命令行参数

三种启动方式

方式一：双击 exe 打开控制器

直接双击 krkr.eXe（不带参数），引擎会启动控制器模式：

• 显示一个项目列表
• 可以实时输入 TJS2 语句测试
• 选择某个项目文件（通常是 data.xp3）来运行
• 开发调试时非常有用

方式二：拖拽文件/文件夹

把项目目录或 data.xp3 文件拖到 exe 图标上，引擎会立即用它作为项目目录运行。

这是最常用的开发调试方式——不需要记命令行，拖一下就行。

方式三：命令行参数

krkr.eXe "C:\projects\MyGame\data.xp3"
krkr.eXe "C:\projects\MyGame"

命令行参数可以指定目录或 XP3 包，效果等同于拖拽。

项目目录的确定优先级

引擎按以下顺序查找项目目录，找到第一个有效的就用它：

1. 命令行直接指定的目录或文件（包括拖拽）
2. 同目录下名为 data 的文件夹（内含 startup.tjs）
3. 同目录下名为 content-data 的文件夹（内含 startup.tjs）
4. 同目录下的 XP3 文件

所以最简单的分发方式是：把资源打成 data.xp3，和 krkr.eXe 放在一起，用户双击就能玩。

启动后的两种路径

引擎确定项目目录后，有两种执行模式：

• 有 startup.tjs：直接执行这个脚本。startup.tjs 里通常一行 KAG.manager.start("scenario/main.ks") 就搞定了。
• 只有 KAG scenario：引擎会尝试找 main.ks 或其他约定的入口 scenario 文件。

命令行参数详解

吉里吉里2 支持一些隐藏的命令行参数（以 / 或 - 开头）：

示例：

krkr.eXe "data.xp3" /W /DEV

用窗口模式 + 开发者模式启动 data.xp3，方便调试。

文件关联

安装 SDK 后，可以把 .xp3 文件关联到 krkr.eXe，这样用户双击 XP3 包就能直接玩：

1. 右键 .xp3 文件 → 打开方式 → 选择其他应用
2. 浏览到 krkr.eXe
3. 勾选「始终使用此应用打开 .xp3 文件」

为什么有时候双击没反应

• 缺少 startup.tjs：项目目录里必须有这个入口脚本，空文件都比没有好
• 路径包含特殊字符：空格、中文、# 号等可能导致路径解析失败
• 杀毒软件拦截：某些杀软会阻止 exe 加载 DLL，加白名单
• XP3 损坏：重打包试试

Kirikiroid2 的启动方式

Android 模拟器的启动方式不同：

1. 安装 Kirikiroid2 APK
2. 第一次启动会要求选择游戏目录
3. 在文件浏览器里找到游戏目录，选择 data.xp3 或 startup.tjs
4. 模拟器自动加载运行

手机上路径问题少，但插件不支持是主要限制。