gdUnit4 Test Runner

Execute GDUnit4 tests and generate JSON reports for Godot projects.

11|Updated Nov 29, 2025
One-click install
npx skills add https://github.com/minami110/claude-godot-tools --skill gdunit4-test-runner
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gdUnit4 Test Runner
Source: https://github.com/minami110/claude-godot-tools/tree/main/gdunit4-toolkit/skills/gdunit4-test-runner
Command: npx skills add https://github.com/minami110/claude-godot-tools --skill gdunit4-test-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires godot, gdUnit4, and includes scripts (resource) components.

What problem does it solve?

This Skill provides a wrapper to run gdUnit4 tests and outputs JSON for AI analysis and CI pipelines.

Core Features & Use Cases

  • Run all tests or targeted tests via a simple wrapper script
  • JSON-formatted test reports for easy parsing and integration
  • CI-friendly exit codes and crash detection to indicate status

Quick Start

Run: scripts/run_test.sh to execute tests, or specify targets like:

  • tests/test_foo.gd
  • tests/application/
  • Pass -v for verbose output

Frequently Asked Questions about gdUnit4 Test Runner

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

FAQPage Schema
How do I run gdUnit4 tests for my Godot project?▼

Run gdUnit4 tests using the wrapper script scripts/run_test.sh, which executes all tests in your Godot project and outputs JSON-formatted results. Specify targets like test files or directories, or pass -v for verbose output to see detailed test execution details.

Can I integrate gdUnit4 test results into my CI/CD pipeline?▼

Yes. The gdUnit4 test runner produces JSON-formatted reports and CI-friendly exit codes that CI/CD systems can parse and act on. This structured output enables automated testing, crash detection, and pipeline status reporting.

What do I need to set up before running gdUnit4 tests?▼

Install the gdUnit4 addon under your addons directory and configure the Godot executable path. The wrapper script then orchestrates test runs using these prerequisites to produce structured test results.

Can I run specific test files or directories instead of all tests?▼

Yes. Pass target paths like tests/test_foo.gd or tests/application/ to scripts/run_test.sh to run only those tests. This lets you verify specific features without running the entire test suite.

How does gdUnit4 testing help verify Godot project correctness?▼

gdUnit4 tests execute automatically after feature work to catch regressions and bugs early. The JSON output and exit codes enable both local debugging and automated verification in CI pipelines.