W
AI-Wiki
SOURCE

如何用Godot游戏引擎从零开始构建独立游戏：AI时代的全流程上手实操 摘要

文档概览

这篇文章是一份偏实操的长文，不是趋势评论。作者开头先给出自身结论：在 2025 到 2026 这一年，AI 辅助游戏开发已经从概念验证进入“能用阶段”；作者过去半年在 Godot 上用 AI 做了 3 个完整原型，并重构了 1 个背包插件，认为“选对引擎，AI 工具链的效率差距可以拉到 5 到 10 倍”。

文章随后按顺序展开五类内容：

  • 为什么 Godot 是 AI 游戏开发的优选
  • 如何搭建 Godot、Claude Code、Godot MCP Pro、Cursor、Trae 等工具链
  • 如何用 GPT-image-2、Stable Diffusion、Midjourney、NanoBananaPro 生成角色、TileSet、UI
  • 如何从零做一个 2D“太空闪避”原型，包括场景结构、脚本、输入、测试、导出
  • 常见踩坑与一条 4 周入门路线

文章主推的组合是“Claude Code + Godot MCP Pro”，同时给出无法使用海外服务时的国产替代链路，如 Trae + DeepSeek / GLM / Kimi。

关键事实

1. Godot 的节点-场景架构被作者视为最适配 AI 的核心原因

文中明确说：Godot 里每个游戏对象都是一个节点（Node），节点按树状结构组成场景（Scene）。

作者进一步强调，这种结构“层级明确，关系清晰，可以递归遍历”，因此刚好匹配 AI 擅长处理的数据模型。文章还直接指出，Claude 可通过 MCP 协议直接读写场景树；而当 Cursor 之类工具去理解项目结构时，Godot 的节点树也比其他主流引擎更适合 AI 推理。

文中把这套架构拿来和两类常见模型做对比：

  • Unity 的预制体-组件模型
  • Unreal 的 Actor-Component 体系

作者的判断是：在“让 AI 理解并改造编辑器中的实际游戏结构”这件事上，Godot 的节点树更直接、更适合一次性推理和递归操作。

文章给了一个很具体的自然语言示例：只要对 AI 说“在 Main 场景里创建一个 CharacterBody2D 节点，下面挂 Sprite2D 和 CollisionShape2D，碰撞体宽度 64 像素”，AI 就可以一次完成，而不必让人手动切面板配置。

这部分与已有条目 节点-场景架构、Godot MCP Pro、Godot 直接相关。

2. GDScript 被认为能显著降低 AI 生成代码的出错率

作者认为 Godot 的原生脚本语言 GDScript 接近 Python，因此更利于 AI 稳定生成代码。文中列出的原因包括：

  • 没有头文件分离
  • 没有预处理器宏
  • 没有复杂泛型

文章明确说，AI 生成 GDScript 的“首次正确率”明显高于 C# 和 C++。对应对比是：同样的角色移动逻辑，如果换成 C#，AI 还要处理命名空间、类型声明、生命周期方法签名等“胶水代码”，更容易出错。

文中给了一个极简角色移动示例，体现的是“几行代码即可跑通”的优势，但在后文真正完整的项目示例里，作者给出了更细的 玩家移动脚本。

3. 2025-2026 年 Godot 生态里已经形成完整 AI 工具链

文章列出了一个覆盖编辑器控制、IDE 编码、游戏内 LLM 集成的工具矩阵：

  • Godot MCP Pro：169 个工具，可让 AI 操控编辑器，包括创建场景节点、写脚本、运行游戏、截屏验证、自动化测试；价格为 15 美元一次性买断
  • godot-mcp 免费版：13 个基础工具，覆盖基础场景操作和脚本编辑
  • NobodyWho：在游戏内本地运行 GGUF 格式 LLM，用于 NPC 智能对话与动态剧情，离线可用，免费
  • Godot LLM Framework：在游戏里集成 OpenAI / Ollama 等 API，支持 function calling，免费
  • Claude Code：Anthropic 的终端级 AI 编程工具，原生支持 MCP 协议与子代理模式，价格为 20 美元/月（Pro）
  • Cursor：IDE 级 AI 辅助开发，支持代码补全和上下文修改，MCP 需要手动配 JSON，20 美元/月
  • Trae：字节跳动的 AI 原生 IDE，搭载豆包 / DeepSeek，提供 Builder / Chat 双模式、设计稿转代码，免费

作者强调这些工具不是互斥关系，而是可在一个项目中并行使用：

  • Claude Code 或 Trae 负责日常编码
  • Godot MCP Pro 负责编辑器内部操作
  • NobodyWho 或 Godot LLM Framework 负责游戏内 AI 对话

这部分与 AI 游戏开发流水线代理、Godot AI 原型闭环 语境高度一致：AI 不只是写代码，还要能连到编辑器、运行项目、验证结果、继续修复。

重要细节

环境搭建约束

作者建议安装 Godot 4.x 标准版，而不是 .NET 版，理由是 AI 辅助开发场景下 GDScript 体验更好。

创建项目时，文中给出三个明确约束：

  • 项目路径使用纯英文，避开中文目录名
  • 渲染器选择 Forward+
  • 创建完项目后立刻执行 git init

Claude Code 的安装前提是 Node.js 版本至少为 18。安装命令为：

  • npm install -g @anthropic-ai/claude-code

随后进入项目目录运行 claude 启动。

CLAUDE.md 的作用与规则

文章强调必须在项目根目录编写 CLAUDE.md，把它当作 AI 的项目规范手册。作者的核心观点是：如果没有规则约束，AI 会自行发明命名风格、乱选节点类型，甚至可能给 RigidBody2D 写 move_and_slide()，而这在 Godot 里会直接编译不过。

文中给出的规范包括：

  • 使用 GDScript 2.0 语法
  • 所有函数参数和返回值必须加类型注解
  • 变量命名用 snake_case，常量用 UPPER_CASE，类名用 PascalCase
  • 信号命名使用过去式，如 player_died、coin_collected、game_started
  • 场景放 scenes/，脚本放 scripts/，资源放 assets/，UI 放 ui/
  • 组件化优先于继承，功能通过子节点组合实现，避免深层继承链
  • 所有跨节点引用使用 @export var，不要在代码中硬编码路径
  • 碰撞检测优先使用信号 body_entered / area_entered，不要在 _process 中做碰撞判断
  • 节点类型选择规则明确区分 CharacterBody2D、RigidBody2D、Area2D、StaticBody2D
  • 输入系统统一使用 Input Map，不在代码里写死按键

这些规范直接服务于后面文章里的 玩家移动脚本、游戏管理器脚本 和场景搭建过程。

Godot MCP Pro 的配置过程

文中把 Godot MCP Pro 描述为“AI 操控 Godot 编辑器的核心桥梁”。安装与连接步骤包含：

  1. 把 addons/godot_mcp/ 复制到项目根目录
  2. 在 Godot 编辑器中进入“项目 → 项目设置 → 插件”，勾选启用 Godot MCP Pro
  3. 进入项目的 server/ 目录，运行 npm install 与 npm run build

随后需要把 MCP 服务器注册到 Claude Code，在项目根目录下 .claude/mcp.json 中配置：

  • command 为 node
  • args 指向 server/build/index.js 的绝对路径

或者也可直接使用命令 /mcp add godot-mcp-pro -- node 你的项目路径/server/build/index.js 注册。

作者特别提醒：Claude Code 启动时会自动扫描 .claude/mcp.json，注册一次后，后续每次打开项目会自动连接。

文中给出了一组可直接对 AI 下达的编辑器操作指令示例：

  • 创建一个 Player 场景，包含 CharacterBody2D 节点和移动脚本
  • 运行游戏 5 秒后截图，检查分数 UI 是否正常显示
  • 找到项目中所有 Area2D 节点，统一设置 collision_mask 为 3
  • 分析 Player 场景的节点树，看有没有冗余子节点

这里再次呼应了文前关于“Claude 可通过 MCP 协议直接读写场景树”的论述。

Cursor 与 Trae 的定位差异

文章把 Cursor 和 Trae 都作为 Claude Code 的平替或补充方案，但它们的边界不同：

  • Cursor 属于海外 IDE 级 AI 工具，优势在可视化交互、选中代码对话、侧边栏查看修改效果
  • Cursor 的 MCP 需要手动配置 .cursor/mcp.json，且 Godot 项目中还要写 .cursorrules 来约束 AI 输出
  • Trae 属于国内 AI 原生 IDE，底层模型是豆包和 DeepSeek，不需要科学上网