gdunit-driver

Run gdUnit4 tests for Godot projects and parse output into structured results.

511|44|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/RandallLiuXin/GodotMaker --skill gdunit-driver
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gdunit-driver
Source: https://github.com/RandallLiuXin/GodotMaker/tree/main/skills/core/gdunit-driver
Command: npx skills add https://github.com/RandallLiuXin/GodotMaker --skill gdunit-driver

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the slow, error-prone process of manually checking whether Godot gameplay logic and utilities behave correctly by running gdUnit4 tests and converting results into actionable structured output.

Core Features & Use Cases

  • Run gdUnit4 unit tests reliably: Executes the gdUnit4 CLI runner in headless mode across supported Godot 4.x/v5.x/v6.x setups, targeting both GDScript and C# test files.
  • Diagnose failures with structured results: Parses stdout (with ANSI stripping) and can generate JUnit XML reports for CI workflows.
  • Support common test patterns: Handles single-file, multiple-file, and directory test discovery, plus guidance for timeouts, async/signal testing, scene-tree execution via SceneRunner, and C# build prerequisites.

Use cases: after writing or modifying gameplay code, investigate failing assertions quickly, ensure new tests follow gdUnit4 conventions, and produce machine-readable test reports for automation.

Quick Start

Run the gdUnit4 test driver from your Godot project to execute your test files headlessly and get pass/fail status plus failure details with file locations.

Frequently Asked Questions about gdunit-driver

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run gdUnit4 unit tests for Godot headlessly?

Run gdUnit4 tests headlessly by executing GdUnitCmdTool.gd with res:// paths via the Godot executable to output structured pass/fail results for your GDScript or C# code.

Does the gdUnit4 test runner support C# unit tests in Godot?

The gdUnit4 test runner supports C# unit tests in Godot 4.x/v5.x/v6.x setups, executing them headlessly alongside GDScript files while requiring standard C# build prerequisites.

Why are my unit tests not working in Godot CI pipelines?

Unit tests fail in Godot CI pipelines if parsing does not strip ANSI codes or handle exit codes correctly; this driver converts raw runner output into machine-readable JUnit XML reports.

What is the best way to debug failing Godot gameplay logic?

Debug failing Godot gameplay logic by running gdUnit4 tests to investigate failing assertions and receive structured results that include precise file:line context for the failures.

How does scene-tree execution and async signal testing work in gdUnit4?

Scene-tree execution and async signal testing in gdUnit4 work by using SceneRunner to validate gameplay logic, handling single-file, multiple-file, and directory test discovery with appropriate timeout guidance.