Godot Editor Bridge

Live two-way communication between EngineForge and a running Godot Editor instance via HTTP REST. The bridge enables the AI Agent to create nodes, attach scripts, manage resources, and control the editor remotely.

How it works

1. When the IDE detects a Godot project (via project.godot), it auto-deploys a GDScript plugin toaddons/engineforge_bridge/
2. The plugin is a @tool EditorPlugin that starts an HTTP server on ports 27050–27060
3. The plugin writes a discovery file to.godot/engineforge/bridge.json with the active port
4. The IDE polls this file every 5 seconds to discover the Godot instance
5. Once discovered, all communication happens via HTTP request/response

Plugin deployment

The bridge plugin is auto-deployed when EngineForge detects a Godot project. You need to enable it once: go to Project → Project Settings → Plugins and check EngineForge Bridge. After enabling, the plugin uses the @tool annotation, so it loads automatically on every subsequent editor launch.

The port range (27050–27060) is separate from Unity's range (26742–26752) to avoid conflicts when both editors are running.

HTTP endpoints

Command categories

Scene

Node

Script

Resource

Editor

Project

Console

Screenshot

Animation

Smart features

Node ownership

Nodes created via the bridge automatically getnode.owner = edited_scene_root set, ensuring they persist when the scene is saved.

Type instantiation

Node types are resolved via ClassDB.instantiate(). Any built-in Godot node type (Sprite2D, CharacterBody2D, Camera2D, Label, etc.) can be created. Unknown types fall back to a plain Node.

Physics rules

These are critical rules the AI follows when creating physics-based scenes in Godot:

1. Every CollisionShape2D must have a shape resource assigned. Creating a CollisionShape2D without setting its shape property results in a non-functional collision shape.
2. Shape sizes use full dimensions, not half-extents. A RectangleShape2D with size: [40, 80] is 40 pixels wide and 80 pixels tall.
3. For CapsuleShape2D, set height before radius. This is a Godot constraint: height must be ≥ 2 × radius.
4. Every physics body needs a CollisionShape2D childwith a shape assigned:

   CharacterBody2D (Player)
   ├── CollisionShape2D (must have shape!)
   └── Sprite2D or ColorRect

Scene workflows

Creating a new scene

1. Write any scripts needed (GDScript files)
2. Call editor.getScreenInfo to get viewport dimensions
3. Call scene.create to create a blank scene
4. Create all nodes in a single batch for efficiency
5. Attach scripts to nodes
6. Call scene.save

Modifying an existing scene

1. Call scene.getTree to see the current node structure
2. Review what exists before making changes
3. Add, modify, or remove nodes as needed
4. Call scene.save

Timeouts