Konado 是什么与插件安装

如果你想用 Godot Engine（戈多引擎）制作视觉小说、Galgame，或者为 RPG 编写大量剧情对话，却不想从零实现对话框、打字机、选项与存档系统，Konado 正是为这类需求准备的工具。Konado（中文名”可娜多”）是基于 Godot Engine 的视觉小说（Visual Novel）框架与通用对话解决方案，官方 README 对它的定位是：一个为 Godot Engine 打造的对话创建工具包（dialogue creation toolkit），通过模板（templates）与对话管理器（dialogue manager）帮助你快速构建视觉小说、Galgame、RPG 以及其他故事驱动的项目。它把视觉小说需要的一整套”舞台设备”做成开箱即用的组件，让创作者专注于故事叙述本身，而不陷入程序细节。

Konado 的成熟度有据可查：它已被收录进 Godot 官方维护的 awesome-godot 资源列表，2025 年获得 AtomGit 百大开源项目荣誉。官方团队还用它制作了《福尔摩斯：斑点带子案》《逃离精神病院》等完整作品，在官方作品展示页中可以直接体验，用来判断它是否符合你的项目形态再合适不过。

本模块是面向零基础读者的完整深入教程，全部内容按 2.8 及以上版本的 API 编写。本站的 godot 模块中另有三篇 Konado 概览文档（160/170/180），可作为快速入门的补充阅读。

学习目标#

1. 能说出 Konado 在”自己造对话系统 / 用插件 / 换专用引擎”三条路线中的定位，并给自己的项目选一条。
2. 能完成插件安装四步，并用三个证据（模板场景、.ks 支持、示例剧本）确认安装成功。
3. 能按官方推荐配置好项目分辨率与拉伸模式，说出每项配置防的是什么问题。
4. 能识别 2.4 与 2.8 两代 API 的差异，看到 KND_ 前缀代码时知道该做什么。

项目信息速览#

动手之前，先把找资源的入口记全：

• 代码仓库：github.com/godothub/konado，项目创建于 2025 年 4 月 13 日。README、三份许可证文件、文档源码（docs/zh/latest/）、插件本体（addons/konado/）与官方示例项目（sample/demo/）都在仓库里。
• 大陆镜像：AtomGit 镜像仓库 atomgit.com/godothub/konado，下载 release 时速度通常更快，推荐大陆用户优先使用。
• 文档站：提供简体中文、繁体中文、英语、日语、韩语五种语言，版本切换器支持 2.4 与 latest 两条线。
• 社区：QQ 频道、Discord 与爱发电；联系邮箱 konado@godothub.com。
• 品牌形象：看板娘 IP “Kona”，2.0 主形象由画师 ioniccrystal 绘制。
• 官方作品展示页：godothub.com/game/visual-novel。

版本线：2.4 LTS 与 2.8 系列#

Konado 文档站提供两个版本入口：标签为”2.4 LTS”的长期支持版（LTS, Long Term Support）与 latest（最新线）。LTS 版本（2.4）提供 18 个月的维护支持，适合追求稳定、不想追新的项目；latest 则跟随最新特性演进。

最新的正式发布是 v2.8.0，发布于 2026 年 9 月 7 日，2.8 系列使用代号 Nanguoli（南果梨）；上一个系列 2.7.x 的代号是 Wontons（馄饨）。仓库 main 分支的 plugin.cfg 已更新为 2.8.1，说明 2.8 系列仍在持续推进。

需要特别注意：2.4 到 2.8 是一次破坏性大版本升级，两代 API 不兼容。最直观的变化是节点与类的命名前缀：2.4 使用 KND_ 前缀，2.8 统一改为 Konado 前缀。如果你在网上搜到旧教程，代码里 KND_DialogueManager 之类的写法多半来自 2.4 时代。下面是关键改名对照的节选：

本模块所有示例与类名均按 2.8+ 编写，不涉及 2.4 的写法。

三许可证模式：三选一#

Konado 采用多许可证（tri-license，三许可证）模式：你在 MIT、BSD 3-Clause 与木兰宽松许可证 2.0 三者中选择一个遵守即可，不必同时满足全部。三个许可证的侧重点不同：

• MIT（LICENSE 文件）：限制最少，保留版权与许可声明后即可自由使用、修改与分发。
• BSD 3-Clause（LICENSE-BSD 文件）：宽松度与 MIT 相近，额外禁止用版权方的名称为衍生产品背书。
• 木兰宽松许可证 2.0 / Mulan PSL v2（LICENSE-MULANPSL 文件）：中文生态常用的宽松许可证，包含明确的专利许可条款。

无论选哪一个，分发（发布游戏）时都应保留你所选许可证要求的版权声明、许可证正文和免责声明。对商业项目友好的是：Konado 不强制要求在游戏启动画面展示 Konado 标识。另外，插件内置字体（Noto Sans、资源圆体）附带独立的许可证文件，如果你的成品中使用了这些字体，分发时注意一并查看其条款。

系统要求与安装四步#

系统要求非常简单：Godot 4.7.1。这既是最低要求，也是官方开发者实际测试确认过的版本。安装前请确认你使用的是该版本的标准 Godot 编辑器。

下载渠道注意一点：Konado 不通过 Godot Asset Library（资产库）分发，正确做法是从 GitHub Releases 下载 ZIP 压缩包；大陆用户推荐走 AtomGit 镜像下载 release。生产环境建议选择稳定版，而非开发快照。

官方安装步骤共四步：

1. 在 Godot 工程目录新建插件文件夹 addons。
2. 下载 release 的插件 zip 包。
3. 解压到 addons 目录下。
4. 在 Godot 项目设置中启用插件，并重新加载当前项目。

解压后插件目录为 addons/konado/，入口脚本是 konado_editor_plugin.gd。第四步”启用插件”的位置在”项目设置 > 插件”列表中勾选即可。启用成功后，Godot 会获得 KonadoScript（.ks 剧本）的编辑器支持与全部对话模板。

推荐项目配置#

官方针对视觉小说类型给出一组推荐的项目设置，建议新建项目后一次性配好：

配置完成后，把对话模板场景拖进你自己的场景即可开始搭建对话：默认模板位于 res://addons/konado/templates/default/dialogue_runtime.tscn。下一篇将完整拆解这个场景的结构。

与 Ren’Py 的定位差异#

用一句话区分：Konado 是运行在 Godot 引擎内的插件，你的项目始终是一个标准 Godot 项目，可以自由组合 Godot 的全部能力（自定义玩法、物理、3D、插件生态）；Ren’Py 则是一个独立的视觉小说引擎，不依赖 Godot。如果你的目标是”用 Godot 做一个带视觉小说演出的游戏”，Konado 这条路线更合适；如果只想做纯视觉小说并对独立引擎生态感兴趣，可以另行了解 Ren’Py（本站 renpy 模块有对应教程）。

选型其实有三条路线，把第三条也摆出来，判断才完整：

一个实用的判断顺序：先问”我的项目除了对话还有没有玩法”。有玩法且想用 Godot——Konado；没有玩法、只想讲个好故事——Ren’Py 与 Konado 都能到终点，前者生态更专，后者让你顺便掌握 Godot。只有”学习引擎原理”或”对话不超过十句”时，自己造才是合理选项。

动手实践#

任务一：完成安装并留下三个证据。 按四步装好插件后，用三种方式验证安装成功：项目设置插件列表里 konado 已勾选；文件系统面板能看到 res://addons/konado/templates/default/dialogue_runtime.tscn；新建一个空 .ks 文件，编辑器不会把它当未知文件。提示：三个证据分别对应”插件启用、模板就位、语言支持”，缺任何一个都说明安装不完整。

任务二：跑通官方示例。 打开仓库 sample/demo/ 对应的示例工程（或把示例剧本复制进你的项目播放），按一次”下一句”、触发一次选项。提示：示例是最快确认”框架在你机器上能跑”的路径，比从零搭快得多。

任务三：配好项目设置。 按推荐配置表把 Stretch 四项与 HiDPI 配齐，然后把窗口拖成非 16:9 的形状，验证画面不拉伸变形。提示：配置完成后需要重新运行场景才看效果；“画面变形”就是 Aspect 没设 keep 的典型症状。

先自己操作，再对照验收清单：

坑点与自检#

• 从 Godot Asset Library 搜不到 Konado——它不走资产库分发，从 GitHub Releases 下载 ZIP；大陆用户优先走 AtomGit 镜像；
• 启用插件后没有 .ks 支持与模板——确认解压后目录是 addons/konado/（入口 konado_editor_plugin.gd），并按官方第四步重载项目；
• 网上抄的代码全是 KND_DialogueManager，一跑就报不存在——那是 2.4 时代教程，本模块按 2.8+ 的 Konado 前缀编写，对照升级表的改名映射逐个替换；
• 游戏窗口缩放后画面拉伸变形——按推荐配置把 Stretch Mode 设为 viewport、Aspect 设为 keep；
• 成品分发担心许可证问题——三许可证三选一遵守即可，注意内置字体（Noto Sans、资源圆体）有独立条款；
• 自检问题一：Konado 与 Ren’Py 怎么选？（要”用 Godot 做带剧情演出的游戏”选 Konado；纯视觉小说且想要独立引擎生态可看 Ren’Py）
• 自检问题二：2.4 到 2.8 能平滑升级吗？（不能，破坏性升级：类名前缀全改、存档不兼容、手写代码需手动替换）
• 自检问题三：最低且经测试的引擎版本？（Godot 4.7.1）

参考链接#

• Konado 官方文档站主页
• 安装教程
• 2.8 升级指南
• Konado GitHub 仓库
• AtomGit 镜像仓库
• 官方作品展示页