Smalldy/godot-bridge
DSH↔Godot engine runtime bridge: launch and drive a running Godot 4.x game through its in-game TCP interaction server — 16 tools (runtime control via ~130 game commands, scene/UI inspection, GDScript eval, input simulation, screenshots, headless static ops, project editing, export, script validation, engine-path setup), replaces godot-mcp.
Lets DSH agents launch and drive a running Godot 4.x game through its in-game TCP interaction server, speaking the same newline-delimited JSON protocol the game already listens on. Tools include godot_run_project, godot_stop_project, godot_get_debug_output, godot_command (any of ~130 interaction-server commands: get_scene_tree, get_ui_elements, eval, get/set_property, call_method, click, key_press, screenshot, raycast, serialize_state, ui_*), godot_screenshot, godot_ping, godot_set_engine_path, plus 16 headless static operations (godot --headless --script godot_operations.gd) for scene/script/resource/input-map/export-preset work without a running game.
Install
dsh plugin --profile web add github:Smalldy/godot-bridgedsh plugin --profile web add github:Smalldy/godot-bridge (README documents the GitHub install; a matching npm godot-bridge 0.0.4-alpha exists but is pre-release — used the documented GitHub path). Requires a running Godot 4.x project with the mcp_interaction_server.gd autoload (or the game's TCP interaction server on 127.0.0.1:9090).
Compatibility
DSH host plugin (dsh.bundle); replaces the godot-mcp MCP server — no MCP protocol, no Python server, no editor addon. Godot 4.x.
Details
- Repo: Smalldy/godot-bridge
- Category: Tools & Capabilities
- Stars: 18
- Version: GitHub source (npm godot-bridge 0.0.4-alpha exists)
- Last push: 2026-08-18
- First seen: 2026-08-14
Recent updates
Native DSH↔Godot bridge; replaces godot-mcp; ~130 interaction-server commands + 16 headless ops; correct Godot 4 keycodes (fixes godot-mcp's Godot 3 baseline bug); no MCP/Python/editor addon.
FAQ
- Do I need the godot-mcp server?
- No — godot-bridge replaces godot-mcp entirely. The game side only needs its existing McpInteractionServer autoload listening on 127.0.0.1:9090.
- Can it work without a running game?
- Yes — headless ops (godot_headless_op, godot_validate_script, godot_set_project_setting, godot_manage_autoloads, godot_manage_input_map, godot_manage_export_presets) run godot --headless and need no game instance.
- Which Godot version is supported?
- Godot 4.x, including correct Godot 4 keycodes in the input-map tools (fixing godot-mcp's Godot 3 baseline keycode bug).
Alternatives
JAdpp/dsh-whale-galgame · cyanfish-x/dsh-live2d-pets · omdsh-dev/dsh-gomoku