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.