社区资源与学习路径
官方文档
日语(最完整)
- krkrz.github.io:Kirikiri Z 官方文档站,包含 KAG 3 标签参考、TJS2 语言参考、类 API 文档
- kikyou.info/tvp/:原始官方主页(W.Dee 维护),有 krkr2 老版本文档
- sourceforge.net/projects/kirikirikag/:Kirikiri KAG 开源项目,包含 KAG TJS2 源码
中文(社区翻译)
- kimoritama.github.io/krkr2doc-cn/:中文翻译版 krkr2 文档,覆盖启动、存储、插件、类参考等核心章节
- keshe1.luckykeeper.site:中文社区展示站,介绍引擎特性、有 Live2D 模型
- NVL Maker 官方手册:NVL Maker 是基于 Kirikiri 的可视化工具,手册里包含了 KAG 标签参考(中译质量不错)
英语
- krkren.github.io:英语社区文档,多平台设计指南
- sourceforge.net/projects/kirikirikag/ 上的英文 README
SDK 自带的示例
下载 SDK 后,里面的 sample/ 目录包含一个完整的最小项目:
- 一个简单的 AVG 剧情
- 展示 KAG 核心标签
- 演示 TJS2 基础用法
- 自带背景图和立绘占位图(你可以替换自己的)
强烈建议:把 sample/ 复制一份作为项目模板开始你的第一个游戏,比从零搭目录轻松得多。
社区插件资源
去哪里找插件
| 来源 | 地址 | 特点 |
|---|---|---|
| GitHub | 搜索 kirikiri plugin | 最全,质量参差不齐 |
| SourceForge | kirikirikag 项目页 | 官方/半官方插件 |
| 日本 2ch | AVG 制作板 | 日本开发者聚集地 |
| 国内贴吧 | 吉里吉里吧 | 中文社区,资源质量尚可 |
| MDL(萌娘百科) | moegirl.org.cn | 有吉里吉里条目和相关链接 |
常用插件清单
| 插件 | 功能 | 状态 |
|---|---|---|
| Live2D Cubism | Live2D 角色动画 | Kirikiri Z 内置,原版需单独装 |
| PSB Plugin | Photoshop PSD/PSB 分层 | 第三方,GitHub 有 |
| WMV Video | WMV 视频播放 | SDK 自带 |
| OGG Decoder | OGG Vorbis 音频 | SDK 自带 |
| Susie Plugin | 图片扩展(Susie 格式) | SDK 自带,可扩展图片格式 |
社区工具
| 工具 | 用途 |
|---|---|
| tlgcon(SDK 自带) | TLG 图片格式批量转换 |
| releaser(SDK 自带) | XP3 / PEXP3 打包 |
| KrkrExtract | XP3 解包 + TJS2 反编译 |
| Loop Tuner(SDK 自带) | BGM 循环点标记 |
| GARbro | 多格式归档浏览(含 XP3) |
| ArcConvert | 归档格式转换 |
学习路径推荐
第一天:跑通 sample
1. 下载 krkr2.30 SDK
2. 解压
3. 直接双击 krkr.eXe
4. 在控制器里选 sample/ 目录运行
5. 看看 KAG 脚本跑起来什么感觉
6. 打开 sample/scenario/main.ks,对照着读
第一周:做一个最小 AVG
1. 复制 sample/ 作为新项目
2. 准备 1 张背景、1 张立绘(先用占位图也行)
3. 改 scenario 写一段自己的剧情(5 分钟剧本就行)
4. 用 bg、chara、msg、click 标签做一个能跑的 demo
5. 加一两个选项分支
6. 第一次用 [tjs] 标签写一个变量
第一个月:掌握 TJS2 和进阶功能
1. 读中文文档里的 TJS2 章节
2. 学会用 var / global / class
3. 试试直接操作 Layer 图层(不用 KAG 标签)
4. 接一个插件(比如 WMV 视频)
5. 用 Releaser 打包一次、在干净目录里验证
深入方向
- 想做 动态立绘 → 学 Live2D Cubism Editor 或 Photoshop + PSB
- 想做 移动端 → 学 Kirikiri Z 原生 Android 编译,或 KrKr2 Next
- 想做 复杂游戏系统(战斗、合成)→ 用类和状态机组织 TJS2 代码
- 想做 插件开发 → 读 SDK 的插件开发头文件
日本 vs 中文社区
| 方面 | 日本社区 | 中文社区 |
|---|---|---|
| 规模 | 大(同人圈主力) | 小一些,但活跃 |
| 文档 | 完整、最新 | 主要靠翻译 |
| 插件 | 多(商业驱动) | 少(翻译版居多) |
| 分发渠道 | Toranoana / Melonbooks / DMM | itch.io / GitHub / 网盘 |
| 语言壁垒 | 需日语(或机翻) | 无障碍 |
吉里吉里2 是日本同人圈的事实标准引擎,绝大多数商业 Galgame(包括很多被汉化引进的作品)都是用它做的。这也是它生态最成熟的原因——近 20 年的积累。
开源项目
GitHub 上的吉里吉里相关开源项目:
| 项目 | 说明 |
|---|---|
| kirikirikag | 官方 KAG TJS2 脚本源码(你可以改它!) |
| krkrz | Kirikiri Z 引擎源码(W.Dee 维护) |
| Kirikiroid2 | 安卓模拟器源码 |
| KrKr2 Next | 跨平台重写版 |
| KrkrExtract | XP3 解包工具 |
| NVL Maker | 可视化 VN 制作工具(基于 Kirikiri) |
避坑指南
| 坑 | 后果 | 建议 |
|---|---|---|
| 文件名用中文/特殊字符 | 打包后路径乱码、资源找不到 | 统一英文小写 |
| 不做版本号管理 | 玩家不知道当前玩的是哪个版本 | 每次发布更新版本号和日志 |
| 不测试模拟器兼容性 | Android 上崩溃或丢功能 | 提前在 Kirikiroid2 / KrKr2 Next 上测 |
| 硬编码窗口尺寸 | 不同分辨率屏幕显示异常 | 用自适应 |
| 忘了附 GPL 许可证 | 合规风险 | SDK 里有 GPL 文本,分发时附上 |
总结
吉里吉里2 的学习曲线很友好——第一天就能跑 demo,第一周能做小作品,一个月能掌握核心。最大的挑战不是引擎本身,而是内容创作(剧本、美术、配音)。
从 sample 开始,遇到问题查中文翻译文档,去贴吧或 MDL 社区问,一步步攒经验。当你用吉里吉里做出第一个完整作品时,你就理解了为什么这个引擎能火 20 年。