Godot AI工具全景图:46个工具120+操作,场景、节点与脚本操控一网打尽
【免费下载链接】godot-aiProduction-grade MCP server and AI tools for the Godot engine. A Snap to install. Totally free and fun.项目地址: https://gitcode.com/gh_mirrors/go/godot-ai
Godot AI是一款面向 Godot 引擎的生产级 MCP 服务器与 AI 工具集,让 Claude Code、Codex、Cursor 等 AI 助手直接操控你正在运行的 Godot 编辑器。它提供 46 个 MCP 工具、120+ 项操作,覆盖场景搭建、节点编辑、脚本编写、信号连接、UI 布局、材质、动画、粒子、相机与环境配置,一句话指令即可让 AI 替你完成开发工作。
上图:约 2 小时内用 Godot AI 构建的赛博朋克 HUD 演示,全程无需手写代码
什么是 Godot AI:让 AI 接管你的 Godot 编辑器
Godot AI 的工作链路非常简洁:MCP 客户端(你的 AI 编程助手)通过标准 stdio 桥接godot-ai attach,连到 Python 服务器,再通过受认证的 WebSocket 直连 Godot 编辑器插件。整个链路走本地回环、凭证轮换,安全且开箱即用。
- 🧩Godot 4.7+(4.x 线)即可使用,官方还提供一键 Snap 安装
- 🐍 需要 uv 提供
uvx启动 Python 服务(此处为工具运行环境要求,非网络链接) - 🤖 支持Claude Code、Claude Desktop、Codex、Cursor、VS Code、Antigravity、Hermes Agent等主流 MCP 客户端,在 Godot AI 停靠面板点一下Configure即可完成配置,源码见 client_configurator.gd
连接成功后,你可以直接对 AI 说:
"Show me the current scene hierarchy." / "Create a Camera3D named MainCamera under /Main." / "Build a voxel block-world game with save slots."
工具全景图:46 个工具、120+ 操作的三种设计
Godot AI 的 46 个工具采用"核心 + 高频动词 + 领域聚合"的三层设计(完整清单见 docs/TOOLS.md):
① 4 个常驻核心工具—— 任何客户端都会优先加载:
| 工具 | 作用 |
|---|---|
editor_state | 编辑器版本、当前场景、就绪与运行状态 |
scene_get_hierarchy | 分页遍历场景树 |
node_get_properties | 读取节点完整属性快照 |
session_activate | 多编辑器场景下锁定目标会话 |
② 19 个高频动词—— 最常用的读写操作被单独命名,如batch_execute(原子批量执行)、node_create、script_create、scene_open、project_run、test_run、logs_read、editor_screenshot等,保证 AI"一步到位"。
③ 27 个领域聚合工具—— 每个领域一个<domain>_manage,用op参数分发,把操作总量撑到 120+ 而工具数远低于部分客户端的 100 个上限。领域目录定义在 domains.py:
| 聚合工具 | 代表操作 |
|---|---|
scene_manage | create / save_as / get_roots |
node_manage | delete / duplicate / rename / reparent / move |
animation_manage | 关键帧轨道 + fade、slide、shake、pulse 预设 |
material_manage | 材质参数、着色器、Visual Shader 图编辑 |
ui_manage | 锚点预设、富文本、布局构建 |
game_manage | 运行时输入模拟(按键/鼠标/手柄/帧精确序列) |
tilemap_manage/gridmap_manage | 地图刷格、填充、清空 |
filesystem_manage | 读写、搜索、重导入、带依赖检查的移动/删除 |
上图:仅用几条提示词生成的 3D 方块对战游戏场景与计分 UI
场景与节点操控:AI 游戏开发的核心舞台
场景树是 Godot 开发的骨架,Godot AI 把它完整暴露给了 AI:
- 读:
scene_get_hierarchy分页拉取整棵场景树,node_get_properties拿到任意节点的每个属性,还能按组(group)查询 - 写:
node_create建节点、node_set_property改属性、node_find按条件搜索,node_manage再提供重命名、移动、复制、换父节点等 8 种操作 - 原子化:
batch_execute把多条命令打包成一次事务,第一条出错整体回滚——AI 批量搭建场景时不会留下半成品
配合api_manage(op="get_class")查询任意 Godot 类的属性/方法/信号文档,AI 写代码前能"查字典",显著减少幻觉调用。
脚本编写:AI 写的 GDScript,验证、热重载一步到位
脚本是本文标题里"一网打尽"的关键一环:
script_create/script_patch写入.gd后立即做语法校验并热重载,响应里直接带diagnostics(结构化报错),AI 拿到错误当场修script_attach把脚本挂到节点,script_manage(op="find_symbols")提取类、方法、@Export成员大纲- C# 为纯文本模式:可写入和解析大纲,但不负责 .NET 编译
test_run在编辑器内跑 GDScript 测试套件(API 见 docs/testing.md),logs_read把输出面板与 Debugger 错误行读给 AI 做诊断闭环
上图:同一个方块游戏的 Save Slots 存档界面——UI、按钮逻辑与存档数据全部由 AI 生成
从 UI 到动画:20+ 视觉与交互领域全覆盖
除了场景/节点/脚本,Godot AI 把"让游戏变好看、变好玩"的领域几乎全部工具化:
- 🎨视觉:
theme_manage换色/字体/样式,material_manage调参数与着色器,visual_shader_*系列甚至能编辑可视化着色器节点图 - 🎬动效:
animation_create+ 15 个animation_manage操作,内置淡入、滑入、抖动、脉冲等预设 - 📷相机与粒子:
camera_manage带预设(阻尼、跟随、限制),particle_manage一键应用粒子预设 - 🗺️地图系统:tilemap 刷格、tileset 图集查询、gridmap 填充、导航网格烘焙
- ⚙️进阶:CSG 建模、曲线、环境、物理形状自动生成、输入映射绑定
上图:AI 构建的完整 HUD——生命条、小地图、系统日志与技能栏联动
快速上手:四步跑通 Godot AI
- 安装:选择官方发布版本(或一键 Snap),插件位于
your-project/addons/godot_ai/ - 启用插件:Project → Project Settings → Plugins → Godot AI,面板自动启动 MCP 服务器
- 连接客户端:在 Godot AI 停靠面板点Configure(或 Configure all)写入对应客户端配置
- 开口说话:试试"在 ui/ 下搜索 PackedScene 文件"、"运行场景测试套件"这类指令
上图:由数条提示词搭建、含存档系统的方块世界游戏实机演示
更多资料:跟着源码与文档深入
- 完整工具与操作手册:docs/TOOLS.md
- 工具分类设计说明:docs/tool-taxonomy.md
- 客户端配置细节:docs/client-configuration.md
- Python 工具层源码:src/godot_ai/tools/
- Godot 插件端处理器源码:plugin/addons/godot_ai/handlers/
- 测试编写指南:docs/testing.md
总结:Godot AI 用 46 个工具、120+ 操作把"场景、节点、脚本"三大核心加上 UI、动画、材质、粒子、相机等 20 余个领域全部交给 AI 助手,从"AI 帮你写代码"进化到"AI 直接操作你的编辑器"。装上插件、连上客户端,下一次开一个新项目,试试只说需求、不看代码。
【免费下载链接】godot-aiProduction-grade MCP server and AI tools for the Godot engine. A Snap to install. Totally free and fun.项目地址: https://gitcode.com/gh_mirrors/go/godot-ai
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考