Konado 2.4 Cannoli 发布!
GodotHub
2026年05月21日 20:19
收录于文集
共2篇

Konado 2.4.0 Cannoli 是一个 LTS(长期支持)版本,将为开发者提供长达18个月的稳定更新。相较 2.3,新版本将重点放在核心对话流程、变量与存档能力、可复用插件生态、模板资源和文档体系上,实现了功能性和稳定性的同步飞跃。

亮点

  • 新增完整变量系统,支持持久变量、临时变量、变量插值和条件判断。

  • 新增完整存档/读档系统,可保存对话状态、变量、音频、演员和背景状态。

  • 新增淡入式打字机文本组件,支持 BBCode 富文本和 GPU 加速逐字符淡入。

  • 新增 Konado Achievement、Konado Settings、Konado WebTool 三个独立插件。

  • 文档站重构为中文、英文、繁体中文多语言结构,补齐 2.4 相关教程文档。

  • 新增节点图编辑器(Beta),用可视化节点图组织对话流程、分支和跳转。

更新内容

对话系统与脚本能力

  • 新增 addons/konado/graph_editor 节点图编辑器模块:

    • knd_graph_edit.gd:可视化节点图编辑器。

    • knd_graph_node_factory.gd:对话节点工厂。

    • knd_graph_converter.gd:KS 脚本与节点图结构转换。

  • 新增 %变量名 持久变量和 $变量名 临时变量。

  • 新增变量操作语句:set、add、sub、mul、div。

  • 新增对话文本变量插值,可在台词中直接显示 %love、$score 等变量值。

  • 新增 if / else / endif 条件分支,支持 ==、!=、>、<、>=、<=。

  • 新增选项与分支跳转改进,优化 choice、branch、jump_branch 的解析和执行。

  • 新增自定义信号指令 signal <name>,可由对话脚本触发外部游戏逻辑。

  • 新增成就脚本指令示例,包括直接解锁、计数器进度和 flag 条件。

  • 新增背景清空功能。

  • 新增对话可见性检查能力。

存档系统

  • 新增 KND_SaveSystem,提供 save_game()、load_game()、delete_save()、get_save_info() 等接口。

  • 新增 KND_SaveData,统一序列化对话、变量、音频、演员、背景和存档元数据。

  • 新增自动存档开关和自动存档间隔配置。

  • 新增存档策略配置,可选择是否保存对话状态、变量、音频、演员和背景。

  • 更新存档 UI 组件,支持存档槽位、保存、读取、删除和预览信息。

文本显示与音效

  • 新增 KND_TypewriterText 淡入式打字机文本组件。

  • 新增 typewriter_fade.gdshader,使用 CanvasItem shader 实现逐字符淡入。

  • 新增 BBCode 解析支持,包含粗体、斜体、下划线、删除线、颜色和字号。

  • 新增多行文本淡入支持。

  • 新增打字机音效相关文档。

插件

  • 新增成就系统插件(addons/konado_achievement):

    • JSON 配置成就数据。

    • 支持直接解锁、计数器、flag 条件和隐藏成就。

    • 提供成就弹窗、成就面板、进度统计和重置接口。

    • 支持自定义保存/加载后端以及外部平台 SDK 同步回调。

  • 新增设置系统插件(addons/konado_settings):

    • 通过 JSON 配置动态生成设置面板。

    • 内置音频、文本播放、显示等设置分类。

    • 支持滑块、开关、选项等 UI 项。

    • 支持按平台和构建类型过滤设置项。

  • 新增WebTool插件(addons/konado_webtool):

    • Web 导出环境下放行常用浏览器快捷键。

    • 支持 F12、F5、F11、Ctrl/Cmd 组合快捷键等配置。

模板、示例与资源

  • 新增左侧、中间布局的对话框与对话场景模板。

  • 新增 left_theme.tres、middle_theme.tres 主题资源。

  • 新增变量系统完整示例 sample/demo/demo_03_variable.ks。

  • 新增 Konado 2.4 启动横幅。

  • 新增 Kona 表情 GIF 资源。

  • 新增新版角色立绘资源与立绘导入/裁切指导素材。

  • 新增中文字体资源 NotoSansSC-VF.otf 和 ResourceHanRoundedCN-Medium.ttf。

文档

  • 重构 VitePress 文档配置,引入侧边栏生成脚本 genSidebar.ts。

  • 新增中文、英文、繁体中文多语言文档结构。

  • 新增成就系统、设置系统、WebTool、Konado .NET API 文档。

  • 新增变量系统、条件分支、自定义信号、打字机效果、打字机音效教程。

  • 新增存档系统、背景转场、脚本高亮、日志、镜头与对话等核心教程。

  • 新增社区贡献、文档贡献、反馈、资源和加入社区页面。

  • 更新版本规划,2.4 代号为 Macaron,并标记为 LTS。

改进

  • 将 Konado 主插件版本更新至 2.4.0。

  • 重构 KND_DialogueManager 和 KS 解释器,支持变量、条件、分支和存档状态管理。

  • 优化演员管理与存档系统的集成。

  • 优化角色布局逻辑,角色图片以底部为基点显示在网格位置。

  • 优化高亮逻辑,补充 BBCode 语法定义。

  • 优化移动指令与示例资源。

  • 优化 Konado Settings 设置面板 UI,并清理冗余配置。

  • 更新插件作者列表。

  • 更新 README 多语言链接和项目描述。

  • 更新 LICENSE copyright 信息。

修复

  • 修复角色模板纹理展开和拉伸模式配置。

  • 修复部分文档路径、图片导入路径和侧边栏生成配置。

移除

  • 移除旧版 Inspector 中不再使用的 shots 编辑器插件文件。

  • 移除演员缩放、镜像和纵向位置相关旧参数,角色显示与移动改为基于横向网格位置。

  • 移除已过时的 docs/about、旧 docs/script、旧 docs/tutorial 等文档目录。

  • 移除西班牙语和法语 README 链接及对应 README 文件。

  • 移除旧版 assets/kona/1.0 立绘资源。

兼容性

  • 2.4.0 调整了演员定位模型,旧脚本中依赖 actor show ... at <x> <y> scale <value> [mirror] 的写法需要迁移到新的网格定位方式。

  • 变量系统分为持久变量 % 和临时变量 $:持久变量会进入存档,临时变量只在当前流程中使用。

  • WebTool 仅在 Web 平台启用,其他平台不会注入浏览器快捷键处理逻辑。

结束语

作为首个LTS版本,Konado 团队将持续优化框架的使用体验、不断完善细节,以负责任的态度为Godot开源生态做出自己的贡献。此外,Konado 的视频教程正在更新中,视觉小说创意周Konado 3.0版本功能征集等活动也很快都要开始了,欢迎大家持续关注!