Skip to content

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;能够针对性分析导出资源、客户端代码或运行时内存的攻击者仍可能恢复剧情内容。

Released under BSD3-Clause License.