当你打开一个复杂的软件工具时，是否曾希望有一位“向导”能手把手教你如何使用它？就像一个游戏中的教程关卡，逐步引导你掌握技能，而不是让你在一堆按钮和菜单中迷失方向。好消息是，对于 Godot 引擎用户来说，这样的“向导”已经诞生了——它的名字叫 Godot Tours。
🎭 什么是 Godot Tours？
Godot Tours 是一个为 Godot 游戏引擎量身打造的框架，它的使命是帮助用户通过交互式、逐步引导的教程，轻松掌握 Godot 的使用方法。想象一下，你在 Godot 编辑器中打开一个项目，屏幕上弹出一个友好的对话框，带着你一步步完成任务。这就是 Godot Tours 的魔力所在。
Godot Tours 截图
这个技术由 GDQuest 开发，是一个完全开源的项目。你可以自由地学习、使用，甚至贡献代码。它的目标不仅是为新手提供帮助，还能让开发者为自己的项目创建定制化的交互教程。
不过，值得注意的是，这个项目目前仍处于实验阶段。虽然在 Godot 4.2 标准版中运行得相当稳定，但开发团队仍在不断优化 API，因此未来的更新可能会带来一些重大变化。
🛠️ 如何创建属于你的交互式教程？
1. 基础：从 GDScript 开始
在 Godot Tours 中，每一个教程都是一个 GDScript 文件，它需要继承 res://addons/godot_tours/tour.gd。换句话说，你的教程脚本是基于这个核心脚本的扩展。
如果你是第一次接触，不妨参考开源教程项目 “101 – The Godot Editor”。这个项目不仅是一个很好的学习资源，还能为你提供创建自己教程的灵感。
此外，打开 res://addons/godot_tours/tour.gd 文件，深入研究其内部机制和提供的功能，是理解整个框架的关键。
2. 注册你的教程
为了让你的教程出现在 Godot 项目的菜单中，你需要创建一个资源文件，命名为 godot_tours.tres，并将其放置在项目的根目录下。这个文件需要继承 res://addons/godot_tours/godot_tour_list.gd。
这一步就像是在为你的教程“登记户口”，让 Godot 知道它的存在。
3. 多语言支持：让教程走向世界
Godot Tours 支持使用 Portable Object (PO) 格式进行翻译。如果你想让你的教程支持多种语言，可以参考 翻译文档。这为你的教程打开了通往全球用户的大门。
🌟 功能亮点：Godot Tours 的秘密武器
Godot Tours 的核心功能分布在其插件的 core 文件夹中。以下是一些让人眼前一亮的特性：
- 默认 UI 气泡：
这是教程的“主角”，它以对话框的形式展示分步指导内容。气泡中可以包含：
- 可选的标题。
- 多段描述文字、图片、视频、代码示例，甚至是可验证的任务。
- 可选的底部说明。
- 一个名为 Godot Bot 的动画化身，为教程增添趣味。
- 自定义气泡：
如果默认的 UI 不符合你的需求，你可以创建自己的定制气泡，完全替换默认样式。
- 调试工具：
按下 CTRL + F10，即可打开调试面板。这是为教程设计者准备的“秘密武器”，可以帮助你快速测试和调整教程内容。
- 鼠标动作预览：
想知道“拖放”或“点击”操作会如何呈现？鼠标预览功能可以模拟这些动作，帮助你更直观地设计交互。
- 覆盖管理器：
为了避免用户在教程过程中误操作，覆盖管理器会屏蔽编辑器界面的 UI 元素。你可以通过高亮特定区域，允许用户与其交互。
- 翻译系统：
内置的翻译系统支持提取和加载 PO 文件，确保教程语言与 Godot 编辑器的设置相匹配。
- 教程构建 API：
这是整个系统的核心，它整合了上述所有功能，帮助你轻松构建交互式教程。
🚀 如何将 Godot Tours 集成到你的项目中？
Godot Tours 的使用方式与其他 Godot 插件类似。你可以克隆或下载其代码库，将 addons 文件夹复制到你的项目中即可。
不过，如果你想更方便地保持插件的最新版本，可以使用 gd-plug 插件管理器。以下是具体步骤：
- 从 Godot 资产库安装 gd-plug。
- 创建一个名为
res://plug.gd 的文件，并将以下代码粘贴进去： #!/usr/bin/env -S godot --headless --script extends "res://addons/gd-plug/plug.gd" func _plugging() -> void: plug( "git@github.com:GDQuest/godot-tours.git", {include = ["addons/godot_tours"]} )
- 在 Linux 系统中，为脚本添加可执行权限：
chmod +x plug.gd。
- 使用命令行运行脚本：
./plug.gd install 或 godot --headless --script plug.gd install。
这样，你的项目就能轻松集成 Godot Tours，并随时更新到最新版本。
🔮 未来展望：Godot Tours 的潜力
虽然 Godot Tours 目前还在不断完善中，但它已经展示了强大的潜力。对于新手来说，它是学习 Godot 的绝佳工具；对于开发者来说，它是一个灵活的框架，可以用来创建任何形式的交互式教程。
正如 GDQuest 团队所言，由于资源有限，他们无法为每个用户提供个性化支持。但这并不妨碍社区的力量。如果你对这个项目感兴趣，欢迎贡献代码或提出建议。
📚 参考文献
- GDQuest. Godot Tours 官方文档
- GDQuest. 101 – The Godot Editor 教程项目
- Godot 官方文档. Godot 游戏引擎
- GDQuest. gd-plug 插件管理器
Godot Tours 是一场技术与创意的完美结合。它不仅为 Godot 用户提供了学习的捷径，还为开发者打开了创造的无限可能。如果你还没有尝试过，不妨现在就开启这场交互式的冒险吧！
