Godot Tours is a framework to create interactive, step-by-step tutorials in the Godot editor.
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.
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.
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.
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
.
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.
Godot Tours comes with these features, in the core
folder of the addon:
gtr()
, gtr_n()
and ptr()
function calls.*.[mo,po]
files loader and mapper depending on the Editor language setting.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:
Install gd-plug using the Godot Asset Library.
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"]}
)
On Linux, make the res://plug.gd
script executable with chmod +x plug.gd
.
Using the command line, run ./plug.gd install
or godot --headless --script plug.gd install
.