The Game Maker

AI-powered game development assistant for Godot 4. Chat with an LLM directly inside the Godot editor to create scenes, scripts, and resources.

What It Does

The Game Maker embeds an AI assistant into Godot's bottom panel. Type natural language instructions and the AI will:

• Create scenes — Generate .tscn files with node hierarchies
• Write scripts — Create GDScript files with proper typing
• Edit existing code — Surgical find-and-replace or full rewrites
• Manage settings — Read and modify project.godot
• Inspect projects — List scenes, scripts, parse scene trees
• Create resources — Themes, materials, shapes (.tres files)
• Run scenes — Launch for testing (headless or windowed)
• Validate code — Query Godot's built-in LSP for diagnostics
• Run tests — Execute GUT unit tests

Quick Start

Prerequisites

• Godot 4.6+ — Download
• Python 3.11+ — Download
• OpenRouter API key — Get one

Installation

# Clone the repository
git clone https://git.maestro.tech/maestro/the-game-maker.git
cd the-game-maker

# Run setup
python game_maker/scripts/setup.py

The setup script will:

1. Create a Python virtual environment
2. Install nanobot and dependencies
3. Link the Godot plugin and skills
4. Prompt for your OpenRouter API key

Start

# Start nanobot + Godot with a project
python game_maker/scripts/start.py /path/to/your/godot/project

# Or create a new project
python game_maker/scripts/start.py --new my_game

Then in Godot: Project → Project Settings → Plugins → Enable "The Game Maker"

Use the Game Maker bottom panel to chat with the AI.

Architecture

Godot Editor (plugin)
    ↕ WebSocket (ws://127.0.0.1:9500)
Nanobot (Python agent)
    ↕ Tool calls
Godot Tools (create scenes, scripts, resources)
    ↕ File system
Your Godot Project

The Godot plugin connects to a local nanobot process via WebSocket. Nanobot handles the LLM conversation and executes Godot-specific tools that create/modify project files.

Skill Levels

The Game Maker adapts to your experience:

• Beginner (ages 9-14) — Enthusiast mentor, hides complexity, auto-writes code
• Intermediate (ages 14-19) — Collaborative tutor, explains choices
• Expert (19+) — Technical co-pilot, no hand-holding

Set your level in game_maker_profile.json in your project root.

Configuration

Edit game_maker/config/nanobot_config.json:

{
  "agents": {
    "defaults": {
      "model": "anthropic/claude-sonnet-4"
    }
  },
  "channels": {
    "godot": {
      "enabled": true,
      "host": "127.0.0.1",
      "port": 9500
    }
  },
  "providers": {
    "openrouter": {
      "apiKey": "your-key-here"
    }
  }
}

Or use environment variables (via .env):

OPENROUTER_API_KEY=your-key-here
GAME_MAKER_WS_PORT=9500

Project Structure

game_maker/
├── config/                    # Configuration
│   ├── nanobot_config.json    # Main config
│   └── config_schema.py       # Validation
├── godot_plugin/              # Godot editor plugin
│   └── addons/game_maker/
│       ├── plugin.cfg
│       ├── game_maker_plugin.gd
│       ├── ui/chat_panel.*
│       └── network/ws_client.gd
├── nanobot_integration/       # Python backend
│   ├── channels/godot.py      # WebSocket channel
│   ├── tools/                 # Godot tools (8 tools)
│   └── skills/game-maker/     # AI knowledge base
├── scripts/
│   ├── setup.py               # Cross-platform setup
│   └── start.py               # Cross-platform launcher
├── tests/                     # Test suite
├── workspace/                 # Nanobot workspace
├── requirements.txt
├── pyproject.toml
└── README.md

License

MIT