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.