Godot Kit

Godot Kit

AI-powered Godot 4.x development toolkit

9 Skills 4 MCP Servers Godot 4.x MIT License

A comprehensive AI skill bundle for Godot 4.x game development. Gives your AI coding assistant expert knowledge of GDScript patterns, debugging, UI systems, roguelike blueprints, GPU particles, and more. Includes 4 MCP servers for runtime Godot interaction — asset search, knowledge lookup, log tailing, and full editor control via Gopeak.

Works with any AI coding tool. Built-in support for Claude Code, VSCode/GitHub Copilot, Antigravity, and Open Claw. Adaptable to any platform that supports skills or MCP.

One-Prompt Install

Copy the prompt for your platform into your AI assistant and it will handle everything — cloning, copying skills, setting up MCP servers, and configuring your environment.

Install the Godot Kit bundle from https://github.com/SufficientDaikon/godot-kit into my project: 1. Clone the repo to a temp directory 2. Copy each subdirectory from skills/ to ~/.claude/skills/{name}/ 3. Copy agents/AGENTS.md to my project root 4. Create ~/.claude/agents/ if needed, copy agents/*.agent.md there 5. Create .vscode/mcp-servers/ in my project, copy mcp-servers/*.py there 6. Create a Python venv at .venv/ and pip install fastmcp httpx 7. Copy platforms/claude-code/.mcp.json to my project root as .mcp.json 8. In .mcp.json, set GODOT_PATH to my Godot executable (ask me if you can't find it) 9. Update Python server paths in .mcp.json to use .venv/Scripts/python.exe (Windows) or .venv/bin/python (macOS/Linux) 10. Create .claude/prompts/ if needed, copy prompts/ contents there 11. Copy mcp-knowledge/ to my project root 12. Delete the temp clone 13. Verify: skills exist in ~/.claude/skills/, .mcp.json is valid JSON, and the venv can import fastmcp
Install the Godot Kit bundle from https://github.com/SufficientDaikon/godot-kit into my workspace: 1. Clone the repo to a temp directory 2. Copy each subdirectory from skills/ to ~/.copilot/skills/{name}/ 3. Copy agents/AGENTS.md to my project root 4. Create ~/.copilot/agents/ if needed, copy agents/*.agent.md there 5. Create .vscode/mcp-servers/ in my project, copy mcp-servers/*.py there 6. Create a Python venv at .venv/ and pip install fastmcp httpx 7. Copy platforms/vscode/mcp.json to .vscode/mcp.json 8. In .vscode/mcp.json, set GODOT_PATH to my Godot executable (ask me if unsure) 9. On macOS/Linux, change .venv/Scripts/python.exe to .venv/bin/python in the Python server commands 10. Copy docs/copilot-instructions.md to .github/copilot-instructions.md 11. Create .github/prompts/ if needed, copy prompts/ contents there 12. Copy mcp-knowledge/ to my project root 13. Delete the temp clone 14. Verify: ~/.copilot/skills/ has 9 subdirectories, .vscode/mcp.json is valid JSON, .venv has fastmcp
Install the Godot Kit bundle from https://github.com/SufficientDaikon/godot-kit into this project: 1. Clone the repo to a temp directory 2. Create .antigravity/skills/ if needed 3. For each subdirectory in skills/, copy its SKILL.md to .antigravity/skills/{name}.md 4. Copy agents/AGENTS.md to project root 5. Create .antigravity/mcp-servers/, copy mcp-servers/*.py there 6. Create a Python venv at .venv/ and pip install fastmcp httpx 7. Add MCP server entries to my Antigravity config (gopeak via npx -y gopeak with GODOT_PATH, plus the 3 Python servers) 8. Create .antigravity/prompts/ if needed, copy prompts/ contents there 9. Copy mcp-knowledge/ to project root 10. Delete the temp clone
Install the Godot Kit bundle from https://github.com/SufficientDaikon/godot-kit: 1. Clone the repo to a temp directory 2. Copy skills/ directory contents to wherever your tool stores skill/instruction files 3. Copy agents/AGENTS.md to project root as agent instructions 4. Copy mcp-servers/*.py to your project, create a Python venv, pip install fastmcp httpx 5. Configure your tool's MCP settings to run the Python servers and use npx -y gopeak with GODOT_PATH set to your Godot executable and GOPEAK_TOOL_PROFILE set to "compact" 6. Copy prompts/ and mcp-knowledge/ to appropriate locations 7. Delete the temp clone

Skills

Nine specialized skill packs, coordinated by the Omega meta-skill. Skills activate automatically based on your question.

omega-gdscript-expert

Meta-coordinator that routes requests to the right specialized skill. Enforces MCP routing and self-evaluation.

P1meta-skill

godot-best-practices

Scene organization, signals, resources, state machines, object pooling, save/load systems, naming conventions.

P2architecture

godot-gdscript-mastery

Static typing, signal architecture (signal up, call down), unique nodes, @onready, code quality patterns.

P2code-quality

godot-gdscript-patterns

Production patterns: state machines, inventory systems, component architecture, scene management, singletons.

P2patterns

godot-debugging

Error interpretation, common bugs, troubleshooting techniques, Godot 3-to-4 migration issues.

P2debugging

godot-particles

GPU particle systems using GPUParticles2D/3D, ParticleProcessMaterial, sub-emitters, custom shaders.

P2vfx

godot-genre-roguelike

Procedural generation (Walker, BSP), permadeath, meta-progression, seeded RNG, loot/relic systems.

P2roguelike

godot-ui-system

Design system for Godot UI: global themes, color palettes, HUD bars, tween animations, button styling.

P2ui

mcp-server-index

Registry of all configured MCP servers with dispatch rules and tool routing.

P3mcp

MCP Servers

Model Context Protocol servers give your AI assistant runtime access to Godot tools.

ServerRuntimeDescription
Gopeak npx 110+ tools for Godot editor control — LSP, DAP, screenshots, runtime inspection, scene management. Compact profile: 33 core + 22 dynamic tool groups.
Context7 npx Up-to-date library documentation lookup. Query any library's docs from within your AI assistant.
Asset Library Python Search and browse the Godot Asset Library. Find plugins, assets, and templates by keyword.
Knowledge Server Python RAG-like local knowledge index of Godot/GDScript patterns and best practices.
Editor Logs Python Tail and search the Godot editor log file. Monitor errors and warnings in real time.

Agents

AgentDescription
Godot Helper Full Godot development agent with Omega workflow, MCP server routing, and team request intake. Your primary Godot development companion.
Plan Multi-phase planning agent that breaks down complex Godot tasks and delegates to the Godot Helper for implementation.
AGENTS.md Root agent instructions template for Godot 4.x projects with GDScript conventions. Drop into your project root.

Architecture

The Omega meta-skill sits at the top, routing requests to specialized skills based on task type. MCP servers provide runtime tools.

omega-gdscript-expert (Meta-Skill)
↓ routes to ↓
best-practices
gdscript-mastery
gdscript-patterns
debugging
particles
genre-roguelike
ui-system
mcp-server-index
↓ MCP Layer ↓
Gopeak
Context7
Asset Library
Knowledge
Editor Logs

Prerequisites

RequirementVersionPurpose
Godot4.xGame engine (path needed for MCP servers)
Node.js18+Runs Gopeak and Context7 via npx
Python3.10+Runs Asset Library, Knowledge, and Log MCP servers
GitanyClone the repository

Install Scripts

If you prefer a script over the one-prompt install:

Windows (PowerShell)

git clone https://github.com/SufficientDaikon/godot-kit.git
cd godot-kit
.\install\install.ps1 -Platform claude-code -GodotPath "C:\Godot\Godot_v4.3-stable_win64.exe"

macOS / Linux (Bash)

git clone https://github.com/SufficientDaikon/godot-kit.git
cd godot-kit
chmod +x install/install.sh
./install/install.sh --platform claude-code --godot-path /usr/local/bin/godot

Platform options: claude-code, vscode, antigravity

Configuration

GODOT_PATH

All MCP configs require GODOT_PATH to be set to your Godot executable. Update it in your MCP config file:

"env": {
  "GODOT_PATH": "/path/to/godot",
  "GOPEAK_TOOL_PROFILE": "compact"
}

Gopeak Profiles

ProfileToolsBest For
compact33 core + 22 dynamic groupsRecommended. Keeps tool count manageable.
full110+ individual toolsWhen you need direct access to every tool.

Optional Servers

context7 and ragx-aipm are not Godot-specific. Remove them from your MCP config if not needed.

Example Prompts

See the full Prompts Guide for 12+ prompts across three difficulty levels. Here are a few to get started:

Getting Started

Set up a new Godot 4.x project with proper folder structure following best practices. Create the directory layout (scenes/, scripts/, resources/, assets/), set up an autoload singleton for game state, and create a basic Main scene with a SceneTree structure that follows the signal-up-call-down pattern.

Common Workflow

Create a player character scene with a finite state machine. The player should have Idle, Run, Jump, and Fall states. Use static typing throughout, the signal-up-call-down pattern, and export variables for movement tuning. Include a GPUParticles2D node for dust effects when running.

Advanced

Design a complete roguelike dungeon generation system using the Walker method. Include room templates, corridor connections, spawn point placement for enemies and loot, a seeded RNG system for shareable runs, and a DungeonManager singleton that tracks floor progression. Use meta-progression to unlock new room types between runs.

Project Structure

godot-kit/ ├── README.md ├── LICENSE ├── skills/ -- 9 skill packs │ ├── godot-best-practices/ │ ├── godot-debugging/ │ ├── godot-gdscript-mastery/ │ ├── godot-gdscript-patterns/ │ ├── godot-genre-roguelike/ │ ├── godot-particles/ │ ├── godot-ui-system/ │ ├── mcp-server-index/ │ └── omega-gdscript-expert/ ├── agents/ -- AI agent definitions ├── mcp-servers/ -- MCP server source code │ ├── asset_library_server.py │ ├── knowledge_server.py │ ├── log_server.py │ ├── requirements.txt │ └── gopeak-godot-mcp/ -- git submodule ├── platforms/ -- platform-specific configs │ ├── claude-code/ │ ├── vscode/ │ ├── antigravity/ │ └── open-claw/ ├── install/ -- install scripts │ ├── install.ps1 │ └── install.sh ├── omniskill-bundle/ -- bundle manifest + meta-skill ├── prompts/ -- prompt templates ├── mcp-knowledge/ -- knowledge index ├── workflows/ -- CI/CD templates └── docs/ -- documentation

Troubleshooting

ProblemSolution
Skills not loading Check that skill directories are in the correct location for your platform (~/.claude/skills/, ~/.copilot/skills/, etc.)
MCP servers not starting Verify the Python venv exists and has fastmcp installed: .venv/bin/python -c "import fastmcp"
Gopeak connection failed Ensure GODOT_PATH points to a running Godot instance and Node.js 18+ is installed
Windows Python path wrong Use .venv/Scripts/python.exe instead of .venv/bin/python in your MCP config
Permission denied on install.sh Run chmod +x install/install.sh before executing
gopeak-godot-mcp/ is empty Run git submodule update --init to fetch the submodule content

License

MIT — see LICENSE for details.

Built with care for the Godot community. GitHub