GdUnit

The GdUnit host is a .NET test executable that runs GDScript suites in a private copy of your game with embedded libgodot. It supports pure GDScript games and scenes that contain C# components.

To create the host, run this command from your Godot project directory:

dnx 2dog add --gdunit

You can also select GdUnit in the interactive host picker. The generated host includes a sample GDScript test and its MTP runner configuration. See the GdUnit configuration guide for customization. To run the tests, use this command from your Godot project directory:

dotnet test MyGame.gdunit

The root global.json that 2dog creates selects MTP for dotnet test. If your own root global.json does not select MTP, run the command from MyGame.gdunit/.

Use GdUnit's official documentation to write tests. Testing with GdUnit explains how 2dog changes the way GdUnit runs and reports tests.