吉里吉里2 SDK 获取与安装
官方下载渠道
吉里吉里2 SDK 托管在 SourceForge 和官方主页:
- 官方下载页:kikyou.info/tvp/(日语,主分发渠道)
- SourceForge 镜像:sourceforge.net/projects/kirikirikag/
- KrKr2 Next:krkr2next.com(跨平台模拟器,面向玩家)
- Kirikiri Z:krkrz.github.io(跨平台开发版)
SDK 包含什么
一个完整的吉里吉里2 SDK 解压后会有:
| 文件/目录 | 作用 |
|---|---|
krkr.eXe | 引擎本体,可执行文件 |
krdevui.dll | 开发调试界面 DLL(运行时必需) |
base/ | KAG 系统文件(TJS2 脚本,KAG 引擎源码就在这里) |
sample/ | 示例项目,推荐新手从这里开始 |
releaser/ | 打包工具(Releaser) |
plugins/ | 常用插件集合(Live2D 等) |
doc/ | 日语官方文档(中文文档社区另有翻译版) |
tlgcon/ | TLG 图片格式转换工具 |
xp3dump/ / xp3pack/ | XP3 打包/解包工具 |
版本号怎么看
吉里吉里2 的版本号格式是 krkr2.x.x,例如 krkr2.24、krkr2.30。重要节点:
- krkr2.19:加入 TLG6 图片格式
- krkr2.24:新增 TLG6 格式正式支持
- krkr2.30:最后一个主要更新版本,社区推荐使用这个版本
下载时选 krkr2.30 即可,不需要纠结小版本号。
安装步骤
吉里吉里2 是绿色软件,不需要安装程序:
- 下载 zip 包,解压到任意目录(路径不要有中文,避免某些插件路径解析出问题)
- 解压后目录里应该能看到
krkr.eXe和krdevui.dll - 确认 SDK 根目录有
base/文件夹(KAG 系统文件)
第一次运行
直接双击 krkr.eXe(不带任何参数)会启动文件检索界面:
- 列出同目录和上级目录下所有可用的项目
- 可以选择打开「控制器」——这是开发调试模式,能实时执行 TJS2 语句
- 也可以直接双击某个项目的
data.xp3或startup.tjs启动
把 krkr.eXe 和你的项目目录放在一起,或者把项目目录拖到 exe 图标上,就能直接运行了。
常见坑
- 路径含中文:某些老插件在中文路径下会报找不到文件,SDK 目录建议用英文路径
- krdevui.dll 丢失:单独分发运行时如果只拷了 krkr.eXe 没带 krdevui.dll,引擎会启动失败
- Windows 防病毒误报:因为 Releaser 会把资源打进 EXE 里,某些杀软会误报,需要加白名单
- 不要把 SDK 解压到 Program Files:没有写权限会导致存档失败
开发 vs 运行
SDK 可以同时用于开发和运行:
- 开发时用完整 SDK(带 base/ 和控制器)
- 分发时可以精简到
krkr.eXe+krdevui.dll+base/+ 你的项目资源