godot-dev

Guides development of the AI Game Builder plugin, MCP server, and Godot editor plugin.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers working on the AI Game Builder itself need a single reference covering its three-layer architecture (Claude Code plugin, Node.js MCP server, Godot editor plugin) so they can safely add skills, MCP tools, hooks, and endpoints without breaking cross-component contracts. ## Core Features & Use Cases - Architecture Map: Documents the full file layout of skills, hooks, the MCP server (tools.js, godot-bridge.js, asset-generator.js), and the Godot editor plugin (http_bridge.gd, dock.gd, error_collector.gd). - Step-by-Step Dev Recipes: Provides procedures for adding MCP tools, new skills, hooks, asset generator entity types, and modifying the Director's 6-phase build protocol. - Conventions & Pitfalls: Enforces logging rules, error-gate behavior, checkpoint/build-state schema, commit style, and lessons learned such as project.godot fragility and SVG quality rules. - Use Case: When asked to "add a new MCP tool" or "fix the MCP server", load this skill to get the exact files to edit, dispatcher patterns, bridge endpoints, and documentation files to keep in sync. ## Quick Start Ask the AI to load the godot-dev skill and add a new MCP tool that reports the current Godot editor selection.

Frequently Asked Questions about godot-dev

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

FAQPage Schema
How do I add a new MCP tool to the Godot AI builder?

Add the tool schema to TOOL_DEFINITIONS in mcp-server/src/tools.js, add a dispatcher case in handleToolCall(), write the handler function, and add bridge endpoints in godot-bridge.js and http_bridge.gd if needed. Then document it in the godot-builder and godot-ops skills and the README.

How do I create a new skill for the Godot AI builder plugin?

Create a directory under skills/ containing a SKILL.md with YAML frontmatter (name, description) and markdown instructions. Then register it in godot-builder/SKILL.md routing tables and keyword routing, and update the README skill count.

How does the MCP server communicate with the Godot editor?

The MCP server talks to Claude over stdio using the MCP protocol, and to the Godot editor plugin over HTTP on port 6100. The godot-bridge.js module sends requests to endpoints like /status, /errors, /run, and /phase handled by http_bridge.gd.

Why can't a build phase be marked complete in the Director protocol?

The MCP server enforces hard error gates: toolUpdatePhase with status completed calls bridge.getErrors() first and rejects completion if any script errors exist. Fix all errors reported by the error collector before retrying.

What are the limitations of the stop-guard hook?

The Stop hook only checks for the .claude/.build_in_progress file created by the Director at Phase 0. If that file is missing or deleted early, the hook allows Claude to stop even mid-build, so the lock file lifecycle must be maintained.