跳到主内容

godot-bridge 使用指南

通过 TCP 启动并控制运行中的 Godot 游戏,替代 MCP 服务器。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

通过 TCP 启动并控制运行中的 Godot 游戏,替代 MCP 服务器。

— 源: plugins.ai_summary

安装与验证

dsh plugin --profile web add github:Smalldy/godot-bridge

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 游戏内协议({command, params, id} + 换行)与 godot-mcp 完全一致,游戏侧与既有工作流无需任何改动。
  • 每条命令拉起一个一次性 node -e 桥:连接 → 发一行 → 打印第一行响应 → 退出。游戏服务器是单连接/单命令(_busy),短连接模型完美匹配。
  • 通过 harness 的原始 subprocess 服务启动(而非受沙箱限制的 shell 执行器),Godot 得以正常写 user:// 文件,不会被 DSH 文件沙箱杀掉(见"坑")。
  • DeepSeek Harness(带 host 运行时的会话)
  • node 在 PATH 中

— 源: plugin_wiki.readme_zh (fallback readme_raw)

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则

godot-bridge 使用指南