godot-debugging

• 🎮 Namespaced Commands - /gd:setup, /gd:init-game, /gd:run, /gd:stop
• 🤖 Game Planning Agent - Interactive AI-assisted game design
• 🧠 Godot Expertise Skill - Automatic activation for Godot-specific questions
• 🔧 Environment Validation - Automatic checks on session start
• 📦 MCP Integration - Seamless integration with Godot MCP server

Prerequisites

1. Godot Engine (4.5.1+) - [Download](https://godotengine.org)
2. Node.js (18+) - Required for Godot MCP server
3. Godot MCP Server - Clone and build:

```bash

git clone ~/projects/godot-mcp

cd ~/projects/godot-mcp

npm install

npm run build

```

Install the Plugin

1. Add the Godot Game Development marketplace

From Claude Code in any directory:

```

/plugin marketplace add https://github.com/your-username/godot-claude-plugin

```

Or for local development:

```

/plugin marketplace add /absolute/path/to/godot-claude-plugin

```

1. Install the plugin

```

/plugin install gd@godot-gamedev

```

The plugin will be available with the namespace /gd:*

1. Open your Godot project in Claude Code

```bash

cd my-godot-game

claude .

```

1. Run setup to configure the environment

```

/gd:setup

```

This will:

- Auto-detect Godot installation

- Verify Godot MCP server is built

- Create .mcp.json configuration in your project

- Validate everything is working

1. Restart Claude Code (required for MCP changes to take effect)

1. Initialize a new game (optional)

```

/gd:init-game

```

Launches an interactive planning agent that will:

- Ask about your game (2D/3D, genre, mechanics, etc.)

- Generate a comprehensive game design document

- Create project folder structure

- Set up initial scenes

1. Start developing!

```

/gd:run # Test your game

/gd:stop # Stop the game

```

| Command | Description |

|---------|-------------|

| /gd:setup | Configure Godot development environment and MCP server |

| /gd:init-game | Interactive game planning and project initialization |

| /gd:run | Launch the game for testing |

| /gd:stop | Stop the running game instance |

Commands (`commands/`)

Slash commands for common Godot workflows with the /gd: namespace.

Agents (`agents/`)

• game-planner - Interactive game design assistant that asks questions and creates comprehensive game plans

Skills (`skills/`)

• godot-dev - Godot Engine expertise that automatically activates when you ask Godot-related questions

Hooks (`hooks/`)

• SessionStart - Validates your environment configuration when you start a Claude Code session

Scripts (`scripts/`)

• Helper bash scripts for environment validation and setup
• Referenced by commands via ${CLAUDE_PLUGIN_ROOT}

Environment Setup

The /gd:setup command:

1. Checks for Godot installation at common locations (macOS, Linux, Windows)
2. Verifies the Godot MCP server is built at ~/projects/godot-mcp
3. Creates .mcp.json in your project with correct paths
4. If .mcp.json exists, validates the paths instead of recreating

Game Planning

The /gd:init-game command launches the game-planner agent which:

1. Asks about game type (2D/3D), genre, art style
2. Gathers core mechanics and technical requirements
3. Generates a detailed game design document
4. Creates project structure (scenes/, scripts/, assets/, resources/)
5. Sets up initial scenes based on your game type

Automatic Assistance

The godot-dev skill automatically activates when you:

• Ask about Godot features ("How do I add a sprite?")
• Need help with GDScript