godot

Test, build, and deploy Godot 4.x games with GdUnit4 and PlayGodot.

Updated Aug 11, 2026
One-click install
npx skills add https://github.com/zerox-core/AI_Game --skill godot-zerox-core
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: godot
Source: https://github.com/zerox-core/AI_Game/tree/main/.continue/skills/godot
Command: npx skills add https://github.com/zerox-core/AI_Game --skill godot-zerox-core

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playgodot, pytest, pytest-asyncio, and includes scripts (resource) and references (resource) components.

What problem does it solve? Godot game projects often lack structured testing and repeatable build pipelines, making it hard to verify gameplay logic, run automated checks in CI, and ship web or desktop builds consistently. This Skill provides ready-to-use workflows for unit testing, E2E automation, exporting, and deploying Godot 4.x games. ## Core Features & Use Cases - GdUnit4 Unit Testing: Write and run GDScript unit and scene tests inside Godot, with input simulation, assertions, and JUnit XML reports for CI. - PlayGodot E2E Automation: Control a running game from Python via the RemoteDebugger protocol to click UI, simulate input, capture screenshots, and verify game state. - Build & Deploy Pipelines: Export web/desktop builds from the command line and deploy to Vercel, GitHub Pages, or itch.io using GitHub Actions workflows. - Use Case: You are building a card battle game in Godot 4.6 and want CI to run headless GdUnit4 tests on every push, then export a Web build and deploy a preview to Vercel for each pull request. ## Quick Start Ask the assistant to set up GdUnit4 tests for your Godot project and run them headless from the command line.

Frequently Asked Questions about godot

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

FAQPage Schema
How do I run GdUnit4 tests headless from the command line?

Run godot --headless --path . -s res://addons/gdUnit4/bin/GdUnitCmdTool.gd --run-tests to execute all tests. Add --report-directory ./reports to generate JUnit XML output for CI systems.

What is the difference between GdUnit4 and PlayGodot?

GdUnit4 is a GDScript unit testing framework that runs inside Godot and suits unit and component tests. PlayGodot is a Python automation framework that controls the game externally like Playwright, suited for E2E and integration tests.

Does PlayGodot work with the official Godot build?

No, PlayGodot requires a custom Godot fork from Randroids-Dojo with automation support. You can download pre-built binaries from its releases page or build the automation branch from source with scons.

How do I export a Godot web build in CI?

Install export templates, define a Web preset in export_presets.cfg, then run godot --headless --export-release "Web" ./build/index.html. The chickensoft-games/setup-godot GitHub Action automates Godot setup in workflows.

Why does my Godot web build show a black screen after deployment?

Web builds need Cross-Origin-Opener-Policy and Cross-Origin-Embedder-Policy headers for SharedArrayBuffer threading. Configure them in vercel.json, or disable threading in export settings on hosts like GitHub Pages that lack custom headers.

Why are my GdUnit4 tests not being discovered?

Test files must end with _test.gd, extend GdUnitTestSuite, and have methods starting with test_. Also confirm the GdUnit4 plugin is enabled in Project Settings and reimport the project if the plugin fails to load.