{
  "markdown": "# Godot Development Plugin for Claude Code\n\nA comprehensive Claude Code plugin for Godot game development with namespaced commands, intelligent agents, and automated environment setup.\n\n## Features\n\n- **🎮 Namespaced Commands** - `/gd:setup`, `/gd:init-game`, `/gd:run`, `/gd:stop`\n- **🤖 Game Planning Agent** - Interactive AI-assisted game design\n- **🧠 Godot Expertise Skill** - Automatic activation for Godot-specific questions\n- **🔧 Environment Validation** - Automatic checks on session start\n- **📦 MCP Integration** - Seamless integration with Godot MCP server\n\n## Installation\n\n### Prerequisites\n\n1. **Godot Engine** (4.5.1+) - [Download](https://godotengine.org)\n2. **Node.js** (18+) - Required for Godot MCP server\n3. **Godot MCP Server** - Clone and build:\n   ```bash\n   git clone <godot-mcp-repo-url> ~/projects/godot-mcp\n   cd ~/projects/godot-mcp\n   npm install\n   npm run build\n   ```\n\n### Install the Plugin\n\n1. **Add the Godot Game Development marketplace**\n\n   From Claude Code in any directory:\n   ```\n   /plugin marketplace add https://github.com/your-username/godot-claude-plugin\n   ```\n\n   Or for local development:\n   ```\n   /plugin marketplace add /absolute/path/to/godot-claude-plugin\n   ```\n\n2. **Install the plugin**\n   ```\n   /plugin install gd@godot-gamedev\n   ```\n\n   The plugin will be available with the namespace `/gd:*`\n\n## Quick Start\n\n1. **Open your Godot project in Claude Code**\n   ```bash\n   cd my-godot-game\n   claude .\n   ```\n\n2. **Run setup to configure the environment**\n   ```\n   /gd:setup\n   ```\n   This will:\n   - Auto-detect Godot installation\n   - Verify Godot MCP server is built\n   - Create `.mcp.json` configuration in your project\n   - Validate everything is working\n\n3. **Restart Claude Code** (required for MCP changes to take effect)\n\n4. **Initialize a new game (optional)**\n   ```\n   /gd:init-game\n   ```\n   Launches an interactive planning agent that will:\n   - Ask about your game (2D/3D, genre, mechanics, etc.)\n   - Generate a comprehensive game design document\n   - Create project folder structure\n   - Set up initial scenes\n\n5. **Start developing!**\n   ```\n   /gd:run    # Test your game\n   /gd:stop   # Stop the game\n   ```\n\n## Available Commands\n\n| Command | Description |\n|---------|-------------|\n| `/gd:setup` | Configure Godot development environment and MCP server |\n| `/gd:init-game` | Interactive game planning and project initialization |\n| `/gd:run` | Launch the game for testing |\n| `/gd:stop` | Stop the running game instance |\n\n## Plugin Components\n\n### Commands (`commands/`)\nSlash commands for common Godot workflows with the `/gd:` namespace.\n\n### Agents (`agents/`)\n- **game-planner** - Interactive game design assistant that asks questions and creates comprehensive game plans\n\n### Skills (`skills/`)\n- **godot-dev** - Godot Engine expertise that automatically activates when you ask Godot-related questions\n\n### Hooks (`hooks/`)\n- **SessionStart** - Validates your environment configuration when you start a Claude Code session\n\n### Scripts (`scripts/`)\n- Helper bash scripts for environment validation and setup\n- Referenced by commands via `${CLAUDE_PLUGIN_ROOT}`\n\n## How It Works\n\n### Environment Setup\nThe `/gd:setup` command:\n1. Checks for Godot installation at common locations (macOS, Linux, Windows)\n2. Verifies the Godot MCP server is built at `~/projects/godot-mcp`\n3. Creates `.mcp.json` in your project with correct paths\n4. If `.mcp.json` exists, validates the paths instead of recreating\n\n### Game Planning\nThe `/gd:init-game` command launches the game-planner agent which:\n1. Asks about game type (2D/3D), genre, art style\n2. Gathers core mechanics and technical requirements\n3. Generates a detailed game design document\n4. Creates project structure (scenes/, scripts/, assets/, resources/)\n5. Sets up initial scenes based on your game type\n\n### Automatic Assistance\nThe godot-dev skill automatically activates when you:\n- Ask about Godot features (\"How do I add a sprite?\")\n- Need help with GDScript (\"How do I implement player movement?\")\n- Want project organization advice (\"What's the best folder structure?\")\n\n## Working with the Plugin\n\n### Creating Scenes\nJust ask Claude and it will use the Godot MCP tools:\n```\nCreate a player character scene with Sprite2D and CollisionShape2D\n```\n\n### Adding Features\n```\nAdd a jump mechanic to my player character\nImplement a health system with UI\nCreate an enemy AI that follows the player\n```\n\n### Getting Help\n```\nHow do I make my camera follow the player smoothly?\nWhat node types should I use for a 2D platformer?\nHow do I handle collision detection in Godot?\n```\n\n## Configuration\n\n### MCP Server\nThe plugin expects the Godot MCP server at:\n```\n~/projects/godot-mcp/build/index.js\n```\n\nThe `/gd:setup` command will create `.mcp.json` in your project:\n```json\n{\n  \"mcpServers\": {\n    \"godot\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/godot-mcp/build/index.js\"],\n      \"env\": {\n        \"GODOT_PATH\": \"/path/to/Godot\"\n      }\n    }\n  }\n}\n```\n\n### Customization\nYou can modify the plugin by editing files in the plugin directory and restarting Claude Code.\n\n## Troubleshooting\n\n### \"MCP server not configured\"\nRun `/gd:setup` to configure the environment. Make sure:\n- Godot is installed\n- MCP server is built at `~/projects/godot-mcp`\n\n### MCP tools not available\nRestart Claude Code after running `/gd:setup`\n\n### Commands not appearing\nMake sure the plugin is installed:\n```\n/plugin list\n```\n\n### Godot not detected\nInstall Godot at a standard location or set `GODOT_PATH` environment variable.\n\n## Development\n\n### Plugin Structure\n```\ngodot-claude-plugin/\n├── .claude-plugin/\n│   └── plugin.json          # Plugin metadata\n├── commands/                 # Slash commands\n│   ├── setup.md\n│   ├── init-game.md\n│   ├── run.md\n│   └── stop.md\n├── agents/                   # Custom agents\n│   └── game-planner.md\n├── skills/                   # Agent skills\n│   └── godot-dev/\n│       └── SKILL.md\n├── hooks/                    # Event hooks\n│   └── hooks.json\n├── scripts/                  # Helper scripts\n│   ├── validate-env.sh\n│   ├── setup-mcp.sh\n│   └── init-project.sh\n└── .mcp.json.template       # MCP configuration template\n```\n\n### Contributing\nContributions welcome! Please:\n1. Fork the repository\n2. Create a feature branch\n3. Test thoroughly in a real Godot project\n4. Submit a pull request\n\n## License\n\nMIT License - See LICENSE file for details\n\n## Links\n\n- [Godot Engine](https://godotengine.org)\n- [Claude Code Documentation](https://docs.claude.com/claude-code)\n- [Godot MCP Server](https://github.com/your-username/godot-mcp)\n\n---\n\n**Happy Game Development! 🎮**\n",
  "bytes": 6642,
  "sha": "2ea1b90b5384be91f997e8d6e2831fdfd17126b7900047bcfe1be7bb8789b5e7",
  "repo_slug": "zate/cc-godot",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_zate_cc_godot_godot_development_f114592f/readme"
}