bitwes/Gut

Godot Unit Test. Unit testing tool for Godot Game Engine.

GDScript

2,752

962 commits

updated Aug 18, 2026

See the code

README

gut logo

GUT

GUT (Godot Unit Test) is a unit testing framework for the Godot Engine. It allows you to write tests for your gdscript in gdscript.

GUT versions 9.x are for Godot 4.x.
GUT versions 7.x (currently 7.4.2) are for Godot 3.x.

Support

If you'd like to support GUT development you can buy me a coffee.

Wiki

Documentation is hosted at https://gut.readthedocs.io/, you can find release-specific links below.

Version Links

There are only two versions of GUT in the Asset Library (one for Godot 3 and one for Godot 4). GUT will not appear in the Asset Library if your current version of Godot is less than the required version of GUT in the Asset Library.

You can download/clone earlier versions of GUT using the links below.

To install from the zip link:

  • Download the zip and extract it
  • Put the addons/gut directory into your project.
  • Enable the GUT plugin.

You will need to relaunch Godot.

Features

Panel

Getting Started

VSCode Extension

Run your tests directly from the VSCode Editor. Search VSCode extensions for "gut-extension". The plugin has commands to run your entire test suite, a single test script or a single test.

Thanks for using GUT. If you'd like to support me you can buy me a coffee.

License

Gut is provided under the MIT license. License is in addons/gut/LICENSE.md.

godot
godot-engine
tool
unit-test

bitwes/Gut

Godot Unit Test. Unit testing tool for Godot Game Engine.

GDScript

2,752

962 commits

updated Aug 18, 2026

See the code

README

gut logo

GUT

GUT (Godot Unit Test) is a unit testing framework for the Godot Engine. It allows you to write tests for your gdscript in gdscript.

GUT versions 9.x are for Godot 4.x.
GUT versions 7.x (currently 7.4.2) are for Godot 3.x.

Support

If you'd like to support GUT development you can buy me a coffee.

Wiki

Documentation is hosted at https://gut.readthedocs.io/, you can find release-specific links below.

Version Links

There are only two versions of GUT in the Asset Library (one for Godot 3 and one for Godot 4). GUT will not appear in the Asset Library if your current version of Godot is less than the required version of GUT in the Asset Library.

You can download/clone earlier versions of GUT using the links below.

To install from the zip link:

  • Download the zip and extract it
  • Put the addons/gut directory into your project.
  • Enable the GUT plugin.

You will need to relaunch Godot.

Features

Panel

Getting Started

VSCode Extension

Run your tests directly from the VSCode Editor. Search VSCode extensions for "gut-extension". The plugin has commands to run your entire test suite, a single test script or a single test.

Thanks for using GUT. If you'd like to support me you can buy me a coffee.

License

Gut is provided under the MIT license. License is in addons/gut/LICENSE.md.

godot
godot-engine
tool
unit-test

Project health

Overall

2.9/10

Maintained

7/10

Code review

2/10
OpenSSF Scorecard

Significant stargazers

(top 24 of 62)

Lukas Wirth

678 followers · starred May 2023

Connor Shea

154 followers · starred Jul 2023

Seth Falco

336 followers · starred Feb 2026

Nathan GDQuest

966 followers · starred Jan 2020