ofxGodotBridge

Godot 4 editor plugin and GDExtension for laying out and live-tweaking openFrameworks scenes (pairs with ofxGodot).

Two tracks: the Godot editor builds/controls oF scenes remotely (Track A, this repo's editor plugin), and a GDExtension hosts headless oF core inside Godot (Track B, in progress — see spikes/).

Install (editor plugin)

Copy addons/of_bridge into your Godot project's addons/ folder, then enable the "OF Bridge" plugin in Project Settings → Plugins. Needs Godot 4.7+ (tested on 4.7.2 standard; the mono build is not required).

Layout

• addons/of_bridge/ — the plugin: plugin.cfg, plugin.gd (OF Bridge

dock), of_link.gd (minimal OFLink WebSocket client, shared by the dock and the headless test).

• link_test.gd/.tscn — headless roundtrip demo: 10 JSON pings against a

running oF peer, prints WS_SPIKE_RESULT=PASS count=10/10.

• spikes/ — verified GDExtension experiments (sources only): the stock

template (gdext-template) and full OF core in an extension (ofcore). See spikes/README.md.

Usage

Run an oF peer with ofxGodot (the ofxGodot example/ app listens on 127.0.0.1:17432; the echo spike uses 17431), open this project in the Godot editor, and use the OF Bridge dock: Connect, then Send a line such as {"type":"ping"} — replies land in the dock log. Headless roundtrip:

HOME=/tmp/ofgodot-home /Applications/Godot.app/Contents/MacOS/Godot \ --headless --path .

(expects the echo peer on 17431; prints WS_SPIKE_RESULT=PASS count=10/10.)

Link protocol (v1, implemented by ofxGodot)

Godot → oF: {"cmd":"set","name":"group/param","value":…}, {"cmd":"loadScene","scene":{…}}, {"cmd":"schema"}. oF → Godot: {"type":"update",…}, {"type":"schema","params":[…]}, {"type":"sceneResult","ok":bool}. See the ofxGodot README for the full shape.

License

MIT, see LICENSE.