Installation and Updates

Table of Contents

Requirements

This plugin requires Godot 4.0.3 or later. Earlier versions of Godot 4 may work but are not officially supported. The plugin will not work with Godot 3.x.

Installation with the Godot Asset Library

The easiest way to install the plugin is to use the Godot Asset Library. Search for “Godot State Charts” and install the plugin. You can exclude the godot_state_charts_examples folder if you don’t need the examples. Be sure to follow the important steps after installation.

Installation with Godot Goodie Grabber (GGG)

If you use Godot Goodie Grabber to manage your project’s dependencies, you can add Godot State Charts directly from the asset library using its asset ID 1778:

ggg add asset --id 1778 --name "godot_state_charts"
ggg sync

This installs the plugin - including the examples - into your project’s addons folder. If you don’t want the examples, edit the resulting entry in ggg.toml to add an exclude section:

[[dependency]]
name     = "godot_state_charts"
asset_id = 1778
exclude = ["godot_state_charts_examples"]

Run ggg sync again after editing ggg.toml to apply the change. Be sure to follow the important steps after installation.

Manual installation

You can also download a ZIP file of this repository and extract it, then copy the addons/godot_state_charts folder into your project’s addons folder.

Important steps after installation

After you installed it, make sure you enable the plugin in the project settings:

Enabling the plugin in the project settings

After that, please restart Godot, so Godot will fully load the plugin.

Installation with C#

If you want to use this library with C#, make sure you are using the .NET version of Godot 4. This can be downloaded from the Godot download page. The standard version of Godot 4 does not support C#. If you got Godot from Steam, you have the standard version and need to download the .NET version separately from the Godot website. There are additional installation steps for the Godot .NET version, so make sure you follow the instructions on the Godot documentation.

After you installed and activated the plugin as described above, you may need to initialize your C# project if you haven’t already done so. You can do this by going to the menu Project -> Tools -> C# -> Create C# solution.

Create C# solution

⚠️ Note: the C# API is currently experimental and may change in the future. Please give it a try and let me know if you encounter any issues.

Updating from an earlier version

Regardless of how you installed the plugin, do these steps before updating:

  • Be sure you have a backup of your project or have it under version control, so you can go back in case things don’t work out as intended.
  • Check the CHANGES.md for any breaking changes that might impact your project and any special update instructions.
  • Close Godot. It’s important to not have the project opened while running the update.

Updating with Godot Goodie Grabber (GGG)

Run the following commands in your project directory:

ggg update
ggg sync

ggg update fetches the latest version from the asset library then installs the updated files into your project removing any stale files. You can now open the project again in Godot and continue working on it.

Updating a manual / asset lib installation

The asset library currently has no support for plugin updates, therefore, to update the plugin, perform the following steps:

  • Download the version you want to install from the Release List (use the Source Code ZIP link).
  • In your project locate the godot_state_charts folder within the addons folder and delete the godot_state_charts folder with all of its contents.
  • Unpack your downloaded ZIP file somewhere. Inside of the unpacked ZIP file structure, locate the godot_state_charts folder within the addons folder.
  • Move godot_state_charts folder you located in the previous step into the addons folder of your project.
  • The plugin is now updated. You can now open the project again in Godot and continue working on it.