​

Godot Bridge

​

声明与激活

{
  "id": "godot-bridge",
  "name": "Godot Bridge",
  "version": "1.0.0",
  "mcpServers": [{ "name": "godot", "command": "uvx", "args": ["godot-mcp"] }],
  "activation": { "requires": { "desktop_connected": true }, "user_selectable": true }
}

​

环境前置

​

确定性回放测试

# 冻结时间
Engine.time_scale = 0.0

​

例：测试跳跃

1. run_game
2. set_time_scale(0)
3. inject_input("jump", true)
4. step_frame() × 10
5. read_node_property("/root/Game/Player", "position.y")
   → 断言 > initial_y（确实跳起来了）
6. step_frame() × 30
7. read_node_property → 断言已落地（y ≈ 地面高度）

​

开发工作流

1. 检查项目场景树
2. 创建/修改节点与脚本
3. 运行游戏测试
4. 用确定性回放验证
5. 关键时刻截图
6. 针对发现的问题迭代

​

能力清单（MCP 接线补齐后可用）

​

安全规则

• 不经询问不改 .godot/ 项目设置
• 只用 undo 安全的操作
• 跑测试前先保存
• 不删除有大量依赖者的节点

​

代码风格约束

​

边界与失败态

• 没有 Desktop 就没有这个插件，云端对话里不出现。
• Engine.time_scale = 0 期间游戏不会自己前进。如果测试脚本忘了 step_frame()，表现是「卡住了」而不是报错——这是预期语义，不是死循环。
• MCP 声明当前未接线（见页头），所以模型会给出方法论而非实际执行。
• 确定性回放只覆盖能读到属性的逻辑。渲染正确性、shader 表现、音频这些读不出数值的部分，仍然只能靠截图与人工判断。
• 热重载有边界。GDScript 可以热重载，但改变了导出变量结构或场景结构时通常需要重启游戏。

​

排错

​

验证你的配置

1. 在 Profy Desktop 新对话的插件面板中应能看到 Godot Bridge。看不到 = Desktop 未连接。
2. 勾选后问「当前 Godot 项目的场景树是什么结构」。返回方法建议而非真实节点树，说明命中页头描述的未接线状态。
3. 让它「设计一个验证角色跳跃高度的测试」。正确回答必须包含 set_time_scale(0)、step_frame、read_node_property 断言三要素——这验证技能层已加载。

​

相关页面