探索Godot Tours：交互式教程框架的革命性创新

探索Godot Tours：交互式教程框架的革命性创新

godot-toursA framework for interactive step-by-step tutorials in the Godot editor项目地址:https://gitcode.com/gh_mirrors/go/godot-tours

Godot Tours 是一个专为Godot编辑器设计的框架，旨在创建互动性强、逐步指导的教程。由GDQuest团队开发并开源，这个工具使您能够创建引人入胜的交互式学习体验，以教育和引导用户熟悉Godot引擎。

最低需求：Godot 4.2 标准版（非.NET版）

请注意，由于Godot Tours是实验性的项目，我们仍在对其API进行打磨和完善，可能会在新版本中引入破坏性的变更以优化用户体验。

支持与贡献

考虑到我们的资源有限，该项目目前主要提供“按现状”使用，不包括直接的技术支持或社区支持。但欢迎所有对项目感兴趣的人进行贡献。如希望提交代码，建议先联系我们确认其是否符合项目目标，同时也需要注意我们可能无法立即审阅或合并您的工作。

创建教程

教程是一个基于GDScript的文件，扩展自res://addons/godot_tours/tour.gd。要了解如何构建教程，请参考开源示例101 - The Godot Editor，它可作为创建自己教程的起点。此外，查看res://addons/godot_tours/tour.gd文件，可以了解更多关于系统工作原理的信息和提供的函数。

注册教程

要将教程添加到打开Godot项目时显示的菜单，您需要在项目的根目录下创建一个名为godot_tours.tres的资源文件，该文件应扩展res://addons/godot_tours/godot_tour_list.gd。

功能亮点概览

• 默认UI气泡 提供了分步说明，可以包括：
  • 可选的标题
  • 多个文本描述、媒体（图片、视频）、代码列表和(可验证)任务
  • 可选的脚注
  • Godot机器人动画化身
• 自定义气泡 功能，允许替换默认界面
• 调试停靠区 ，通过按下CTRLF10即可开启，用于帮助开发者准备和导航教程
• 鼠标预览 功能，用于模拟拖放、点击、按压和释放等操作
• 覆盖层管理器 阻止学生与编辑器界面的UI元素交互，但可通过高亮显示来暂时恢复功能
• 翻译系统 包括字符串提取和*.mo、.po文件加载，适应不同语言设置

在其他项目中使用Godot Tours

将Godot Tours集成进自己的项目非常简单。您可以克隆或下载项目文件，并将其复制粘贴到您的项目中的addons文件夹。或者，可以使用gd-plug这个插件管理器保持Godot Tours的更新：

1. 通过Godot Asset Library安装gd-plug。
2. 在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"]}
       )
   

3. 如果您在Linux上，确保res://plug.gd可执行（chmod +x plug.gd）。
4. 运行./plug.gd install 或者 godot --headless --script plug.gd install 安装Godot Tours。

结论

Godot Tours 的出现打破了传统的教学方式，为Godot用户提供了更直观的学习路径。无论您是一位教师、游戏开发者，还是想要创建互动学习内容，此项目都值得尝试。利用其强大的功能，您将能构建出引人入胜的交互式教程，使学习过程更加有趣且富有成效。现在就加入Godot Tours的大家庭，探索无限的教学可能性吧！

godot-toursA framework for interactive step-by-step tutorials in the Godot editor项目地址:https://gitcode.com/gh_mirrors/go/godot-tours