KonadoScript
KonadoScript 是一种为视觉小说量身定制的创作语言(文件后缀为 .ks)。
你可以把它想象成一种更强大、更结构化的“小说剧本”:开发者无需编写复杂代码,就能控制剧情对话、角色立绘、背景切换、音乐音效,以及故事分支和选项。
设计理念
KonadoScript 的核心设计理念是将故事内容与程序逻辑分离:
- 编剧专注于叙事内容,无需编程知识
- 程序员专注于引擎开发,无需介入故事创作
- 资源管理(图片、音频)通过标识符引用,与脚本解耦
- 模块化指令集,易于扩展新功能
- 兼容版本控制系统(Git等)
- 文本格式天生跨平台
- 资源引用与平台无关
常见问题
1. 解析错误如何处理
Godot 脚本编辑器会实时显示 KonadoScript 的语法和语义问题。无效内容仍可保存为 .ks 源文件,但不会刷新当前的运行时 KND_Shot;修复错误并再次保存后,资源加载器会自动重新编译,无需手动重新导入。
2. 脚本文件编码问题
确保脚本文件编码为UTF-8,否则可能出现乱码,默认情况下创建的脚本文件编码为UTF-8。
3. 导出后的剧本保护
导出项目时,Konado 会读取当前导出预设中 Konado -> Script Encryption Key 的值,并自动加密已编译的 .ks 剧情数据。如果密钥为空或格式错误,Konado 会生成一个随机的 256 位密钥并用于本次构建。之后的导出会复用该密钥,除非开发者手动修改。
发布补丁或热更新时,基础包与更新包必须使用相同的导出预设和密钥。密钥保存在 .godot/konado_export_credentials.cfg,如果需要长期使用请自行备份。
本地导出时,Godot 终端会打印本次构建的完整密钥,便于开发者记录和排查问题。本功能用于避免通用工具从 PCK 中直接读取剧情明文,不能替代专用 DRM;能够针对性分析导出资源、客户端代码或运行时内存的攻击者仍可能恢复剧情内容。