☰
Godot AI工具全景图:46个工具120+操作,场景、节点与脚本操控一网打尽
2026/10/1 14:51:10 网站建设 项目流程

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_managecreate / save_as / get_roots
node_managedelete / 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

  1. 安装:选择官方发布版本(或一键 Snap),插件位于your-project/addons/godot_ai/
  2. 启用插件:Project → Project Settings → Plugins → Godot AI,面板自动启动 MCP 服务器
  3. 连接客户端:在 Godot AI 停靠面板点Configure(或 Configure all)写入对应客户端配置
  4. 开口说话:试试"在 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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询