Quickstart

Get from zero to a running agentic Godot workflow in five minutes.

Prerequisites

Requirement	Version
Godot	4.5 or later
Node.js	LTS (20+)
Cursor	Latest

---

Choose Your Path

Aesthetic Engine Builder

AEB includes GRB. Clone the full project template and you get both the wireframe game builder and the runtime bridge pre-configured.

1. Clone Aesthetic Engine Builder

   Terminal

   git clone -b v1.0.0 https://github.com/Aesthetic-Engine/Aesthetic-Engine-Builder.git
   cd Aesthetic-Engine-Builder/mcp
   npm install

2. Open the project in Godot 4.5+

   Open the cloned folder in Godot to import. Both addons (AEB and GRB) are pre-installed and pre-configured.

3. Open the project folder in Cursor

   File → Open Folder → select the Aesthetic-Engine-Builder folder.

4. Create the MCP config

   Create .cursor/mcp.json in the project root:

   .cursor/mcp.json

   {
     "mcpServers": {
       "godot-runtime-bridge": {
         "command": "node",
         "args": ["C:/path/to/Aesthetic-Engine-Builder/mcp/index.js"],
         "env": {
           "GODOT_PATH": "C:/path/to/Godot_v4.5-stable_win64.exe"
         }
       }
     }
   }

   Replace both paths with your actual locations.

5. Enable the MCP server in Cursor

   Go to Settings → Tools & MCP → find godot-runtime-bridge → toggle ON.

   You should see a green indicator next to the server name.

6. Test the connection

   In Cursor Agent chat, type:

   Launch my game and take a screenshot of the main scene.

   The agent will launch Godot, capture a screenshot, and display it in the chat.

   More example prompts:

   • “Click the Start button and describe what appears on screen.”
   • “Find the Health node and report its current value.”
   • “Take a screenshot, then change the player speed to 200 and take another screenshot.”

Godot Runtime Bridge only

Use this path if you want to add GRB to an existing Godot project without the AEB template.

1. Clone the MCP bridge

   Terminal

   git clone https://github.com/Aesthetic-Engine/godot-runtime-bridge.git
   cd godot-runtime-bridge/mcp
   npm install

2. Copy the addon into your Godot project

   Copy addons/godot-runtime-bridge/ from the cloned repo into your project’s addons/ folder.

   Then enable it: Project → Project Settings → Plugins → Godot Runtime Bridge → Enable.

3. Create the MCP config

   Create .cursor/mcp.json in your project root:

   .cursor/mcp.json

   {
     "mcpServers": {
       "godot-runtime-bridge": {
         "command": "node",
         "args": ["C:/path/to/godot-runtime-bridge/mcp/index.js"],
         "env": {
           "GODOT_PATH": "C:/path/to/Godot_v4.5-stable_win64.exe"
         }
       }
     }
   }

   Replace both paths with your actual locations.

4. Enable the MCP server in Cursor

   Go to Settings → Tools & MCP → find godot-runtime-bridge → toggle ON.

   You should see a green indicator next to the server name.

5. Test the connection

   In Cursor Agent chat, type:

   Launch my game and take a screenshot of the main scene.

   The agent will launch Godot, run your project, capture a screenshot, and display it in the chat.

   More example prompts:

   • “Click the Start button and describe what appears on screen.”
   • “Find the Health node and report its current value.”
   • “Take a screenshot, then change the player speed to 200 and take another screenshot.”

---

What’s Next

• Full installation guide — detailed setup including exported builds and troubleshooting
• API Reference — complete command and environment variable documentation
• Ecosystem overview — how GRB and AEB work together