Konado Scripts
Konado Scripts 是一种专为视觉小说游戏设计的 领域特定语言(Domain Specific Language) ,文件扩展名为.ks。它采用纯文本格式(UTF-8编码),允许开发者通过简洁的指令集描述视觉小说的所有元素,包括剧情流程、角色表现、场景转换、分支选择等。
每个Konado Scripts脚本都会被转换为一个KND_Shot镜头对象
设计理念
Konado Script 的核心设计理念是将故事内容与程序逻辑分离:
- 编剧专注于叙事内容,无需编程知识
- 程序员专注于引擎开发,无需介入故事创作
- 资源管理(图片、音频)通过标识符引用,与脚本解耦
- 模块化指令集,易于扩展新功能
- 兼容版本控制系统(Git等)
- 文本格式天生跨平台
- 资源引用与平台无关
常见问题
1. 解析失败后保存无法触发重新解析
控制台会提示错误信息,但保存后不会自动重新解析,这个是由于未成功触发重新导入导致的。
text
第5行内容:a1ctor show 可娜 正常 at 2 5 scale 0.3
ERROR: core/variant/variant_utility.cpp:1024 - 错误:res://sample/demo/demo_01.ks [行:5] 解析失败:无法识别的语法,终止解析: a1ctor show 可娜 正常 at 2 5 scale 0.3
ERROR: Failed to process scripts
ERROR: Error importing 'res://sample/demo/demo_01.ks'.
ERROR: Failed loading resource: res://sample/demo/demo_01.ks.找到对应的脚本文件,右键选择重新导入即可。

2. 脚本文件编码问题
确保脚本文件编码为UTF-8,否则可能出现乱码,默认情况下创建的脚本文件编码为UTF-8。