GDQuest / GDTour

A framework for interactive step-by-step tutorials in the Godot editor
MIT License
127 stars 7 forks source link

Godot Tours

Godot Tours is a framework to create interactive, step-by-step tutorials in the Godot editor.

Screenshot of the Godot editor, showing the blue welcome window of a GOdot interactive tour

It is a technology we use at GDQuest to create guided tours. This technology is free and open-source so you are welcome to study and use it.

Minimum required Godot version: Godot 4.2 standard (not the .NET edition)

Warning: Godot Tours is an experimental project. While it appears to work fairly reliably in Godot 4.2 stable, we are still refining the API as we're producing interactive tours. Please note that we may make breaking changes to the tour API with new releases to polish it.

Support and contributions

Given our limited resources, and the amount of work that this project represents, it is currently provided as-is: we do not offer individual or community support on this.

If you wish to contribute, please get in touch first to ensure that your contribution aligns with the project goals, and please note that our availability to review contributions is limited.

If it's something we also need or plan to work on, we'll likely be able to review reasonably fast. Otherwise, we can't promise that we'll have time to review or that we'll merge your work.

Creating tours

A tour is a GDScript file that extends res://addons/godot_tours/tour.gd.

To learn how to use the framework and create a tour, we invite you to check out the open-source tour 101 - The Godot Editor. You can use it as a reference to build your own tours.

Also, we invite you to open the file res://addons/godot_tours/tour.gd to learn more about how the system works and see all of the functions provided to build tours.

Registering tours

To register a tour in the menu that appears upon opening the Godot project, you need to create a resource file named godot_tours.tres at the root of the Godot project. It should extend the file res://addons/godot_tours/godot_tour_list.gd.

Translating tours

Godot Tours supports translations in the Portable Object (PO) format. To learn how to translate tours, please refer to the documentation on translating Godot tours.

Features overview

Godot Tours comes with these features, in the core folder of the addon:

Using Godot Tours in Other Projects

Godot Tours works like any other Godot addon. You can clone or download the repository files and copy and paste the addons folder to your project.

The easiest way to keep this addon up to date is to use the addon manager gd-plug:

  1. Install gd-plug using the Godot Asset Library.

  2. Save the following code into the file res://plug.gd (create the file if necessary):

    #!/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. On Linux, make the res://plug.gd script executable with chmod +x plug.gd.

  4. Using the command line, run ./plug.gd install or godot --headless --script plug.gd install.