搭建你的AI开发工具链

写在最前

上一节课我们用三问法把游戏想法收敛成了「弹珠机肉鸽」。这一节课，我们要做一件听上去无聊、但很多新手会卡在这里的事——把开发环境装起来。

为什么这一步重要？因为接下来 11 节课所有的教学示例、所有让 AI 帮你写代码的演示，都依赖一个能跑起来的工程。如果你没有引擎、没装对版本、AI 工具没接通，后面每一节课你都得花半节课的时间补环境，然后越补越乱，最后干脆放弃。

很多新手把"装环境"当成一个无脑下一步的过程，结果踩进各种坑：装错版本、IDE 不识别脚本、Unity License 没激活、Godot MCP 装好了但 AI 喊不动它……一个晚上就这么没了。

这一课要带你做完三件事：

选对引擎——不是哪个最强，是哪个最适合「弹珠机肉鸽」这个具体例子，以及最适合你现在的水平。
把引擎和 AI 工具链装好——不是装个软件就行，是要让 AI 能「看见」你的工程、能直接在引擎里建节点、改参数、写脚本。
熟悉使用方法——一个会从天上掉下来、撞到地板会反弹的圆球。这是后续所有课程的起点。

最终，完成：Godot 能运行、AI 能读取项目、AI 能完成一次简单工程修改。

一、为什么不让你"凭感觉"挑引擎？

打开知乎或 B 站搜一搜「Unity 还是 Godot」，你会看到 50 个回答 50 个版本。一会儿说 Unity 收费坑、一会儿说 Godot 生态弱、一会儿说 UE 蓝图永远的神……

这种讨论对已经做过几款游戏的人才有意义。对于你——手里一个具体项目的新手——挑引擎只应该参考：

这个引擎，能不能在 1 周内上手、后续完善游戏的时候方便改动？

其他「未来扩展性」「跨平台能力」「招聘市场」全部先放一边。所以我下面只用两个维度做对比：

AI 工具链成熟度——决定 AI 能不能帮上忙。
学习曲线——决定你能不能快速做完端给朋友玩。

二、三引擎对比：Unity / Godot / UE

在本教程不考虑原生 JS 项目做演示，主要原因是不具备可视化编辑器界面，开发后期难以演示 / 调教细节。

我把对比写成一张表，你一眼就能看完。注意：这张表是为「弹珠机肉鸽」这个项目写的，不是引擎本身的全维度评测。

维度	Unity 2D	Godot 4	Unreal Engine 5
弹珠物理（核心）	✅ 参数透明、社区资料最多	✅ 内置 GodotPhysics2D，开箱即用	⚠️ Chaos 物理偏 3D，2D 需自搭
体积 / 启动速度	安装包 ~3GB，启动慢	安装包 ~100MB，启动 3 秒	安装包 ~50GB，启动 1 分钟起
AI 工具链（MCP）	unity-mcp 已成熟，能直连场景	godot-mcp 已成熟，节点级操作完整	还在早期，蓝图 AI 接入弱
脚本语言	C#（强类型，跳坑友好）	GDScript（类 Python，AI 写得顺）	C++ / 蓝图（C++ 对新手劝退）
学习曲线（到跑通弹珠）	中（需学 Prefab 组件等）	低（只需学节点）	高（先懂 PIE、ALevel、AActor）
商店资产 / 教程量	极多	中等	多但偏 3D
收费	个人版免费，超阈值才收费	完全开源免费	个人免费，分成模式
本课推荐度	⭐⭐⭐⭐	⭐⭐⭐⭐⭐	⭐

结论先写在前面：本课程后续示例默认使用 Godot 4，Unity 用户可以平行跟，UE 不推荐用来做这个项目。

1）为什么 Godot 4 是首选？

GodotPhysics2D 开箱即用：弹珠机的核心是 RigidBody2D、StaticBody2D、PhysicsMaterial，Godot 直接以节点形式提供，三分钟就能拼出"球落在板上不穿模"。
GDScript 对 AI 友好：GDScript 像 Python，AI（Claude / GPT-4 / Gemini）写起来错误率极低，且 Godot 的 API 命名一致性很好（_ready / _process / _physics_process），AI 不容易瞎编 API。同时游戏场景 tscn 内部书写方式类似前端 CSS 格式，方便 AI 直接编辑游戏场景。
godot-mcp 工具链成熟：可以让 AI 直接在你打开的工程里新建节点、改属性、写脚本、运行场景，而不是只能贴一段代码让你自己复制。
包小启动快：100MB 装好就能用，写完代码 F5 一下立刻跑——这种反馈速度对新手维持手感至关重要。

2）什么时候选 Unity 2D？

如果你已经有一些 Unity 经验、或者你的电脑上已经装好了 Unity Hub，直接用 Unity 也完全可以。Unity 的物理同样好用，C# 在大型项目里更稳，资料量是三家最多的。代价是：包更大、启动更慢、AI 工具链体验略逊于 Godot。

3）为什么 UE 是反例？

UE 不是不好——它在 3A、写实 3D、视效大场景上是天花板。但放在「弹珠机肉鸽」这种纯 2D 物理小游戏上是严重大材小用：

安装 50GB，第一次编辑器冷启动一分钟起；
2D 物理要靠 Paper2D / Chaos 拼装，不如 Godot / Unity 直观；
蓝图调试靠拽连线，AI 工具链对蓝图的支持还在早期；
你即使做出来了，很多精力会花在"对抗引擎"而不是"做游戏"。

把 UE 留给以后做 3D 大项目时再学。第一个游戏不要把它请进来。

✅ 本节决策：本课全部教学示例使用 Godot 4.x（推荐 4.3 及以上）+ GDScript。

三、安装 Godot 4：从 0 到一个能用的编辑器

下面我们手把手装。全程不需要任何账号、不需要付费、不需要科学上网。

1

下载 Godot 4

浏览器打开 godotengine.org（搜索 "Godot" 第一个结果就是），点页面正中的大按钮 「Download Latest」。进入下载页后按系统选择：
· macOS：点「Download for macOS」
· Windows：点「Windows · Standard」（不要选 Mono / .NET 版，除非要写 C#）
· Linux：点「Linux · Standard」

2

解压 & 第一次启动

把 zip 解压到一个英文路径的目录里（重要！）。推荐 macOS：~/Applications/Godot/，Windows：D:\Tools\Godot\（不要放桌面或"我的文档"，路径含中文 / 空格会让部分插件出错）。双击 Godot.app（macOS）或 Godot_v4.x.x_win64.exe（Windows）。macOS 首次启动弹"无法验证开发者"时，按住 Control 点应用图标，选「打开」再次确认。进入欢迎界面，你会看到一个项目管理器窗口（一个空白的项目列表）。

3

建一个空项目验证编辑器能跑

项目管理器左上角点 「创建」；项目名写 PinballRoguelike（全英文）；路径新建一个空文件夹如 C:\GameDev\PinballRoguelike\，不勾选「创建文件夹」；渲染器选 「Compatibility」（兼容模式，2D 项目完全够用）；点「创建」。进入后应能看到顶部菜单栏、左侧场景树 + 文件系统、中间 2D/3D 视图、右侧 Inspector + Node 面板。

看不到某项时，回到 「编辑器 → 编辑器布局 → 默认」 恢复。

默认不打开底部输出面板，走 「编辑器 → 编辑器面板 → 输出」 打开。

4

切到 2D 视图

弹珠机是 2D 项目，中间视图上方一排切换按钮 2D / 3D / Script / AssetLib，点 「2D」。以后大部分时间在 2D 和 Script 之间切换。此时中间变成一个有灰色矩形的空白画布。

提示：下载完若发现是 Godot Mono / Godot .NET 版本，请回去重新下 "Standard" 版——Mono 版用 C#，配置更复杂，本课不需要。忘记切主场景、路径含中文等都是常见坑，见第六节清单。
注：Godot 官网目前已更新，点 Download 会自动检测系统，无需手动选。下载得到一个 zip 包（约 50–80MB），Godot 是绿色软件，无需安装程序。

✅ 走到这里说明 Godot 装好了。

四、配置 AI 工具链：让 AI 真正能"动手"

光装好引擎不够。这就要装一个东西：MCP（Model Context Protocol）服务器。

通俗解释：MCP 就像给 AI 装了一双"手"。普通对话状态下 AI 只能给你贴代码，你来回复制；接上 MCP 之后，AI 能直接打开你的 Godot 工程、新建节点、改属性、写脚本、跑场景，全程你只需要测试和决策。

下面分两步走：先选 IDE / AI 客户端，再装 godot-mcp。

步骤 5：选 AI 编辑器客户端

客户端	适合人群	备注
CodeBuddy（推荐）	完全新手，想要图形化 + 中文界面	内置 MCP 管理，零配置

本节教学默认使用 CodeBuddy。安装：打开 CodeBuddy 官网（搜索 "CodeBuddy" 第一个结果）→ 点首页「下载」，选择 CodeBuddy IDE → 安装后启动并按提示登录 → 进入主界面，左侧有「专家」「插件」「设置」等入口。

步骤 6：装 godot-mcp

对 agent 下指令：帮我配置 godot-mcp，等待片刻后即可配置完成。填路径时选刚才建的 PinballRoguelike 工程根目录（就是你看到 project.godot 文件那个文件夹）。

⚠️ godot-mcp 工作时需要 Godot 编辑器是打开状态。如果你关了编辑器，AI 喊不动它。

步骤 7：验证 AI 真的能动手

回到 CodeBuddy 对话窗，新建一个对话，输入下面这段并回车：

Prompt · 验证 AI 工具链

帮我在当前 Godot 工程里新建一个 2D 场景，
      根节点是 Node2D，命名为 Main，
      并保存到 res://scenes/Main.tscn。

如果一切正常，你会看到：

对话里 AI 列出它要执行的步骤；
Godot 编辑器画面里真的出现了一个新场景，左侧场景树多出 Main 节点；
文件系统面板里 scenes/Main.tscn 文件出现了。

AI 对话框与 Godot 编辑器同步 - 1 — AI 对话框与 Godot 编辑器同步 · 1

AI 对话框与 Godot 编辑器同步 - 2 — AI 对话框与 Godot 编辑器同步 · 2

✅ 如果上面三件事都发生了：恭喜你，AI 工具链跑通了。

五、跑通最小闭环：一个会掉下来的圆球

到这一步，引擎装好了、AI 接通了。我们要让这一节课有一个肉眼可见的产出——一颗圆球从天上掉下来，撞到平台后弹一下。这是本课程后续所有内容的物理基础。

我们先自己手动做一遍——这样你以后才知道 AI 在你工程里改了什么。然后再演示让 AI 一句话搞定。

8.1 加平台（StaticBody2D）

1

添加 StaticBody2D 并命名 Floor

选中场景树里的 Main 节点，点左上方 ➕「添加子节点」（或 Cmd/Ctrl + A），搜索 StaticBody2D 回车，按 F2 重命名为 Floor。

2

挂碰撞形状

StaticBody2D 自己没有形状，必须挂碰撞形状子节点：选中 Floor 再点 ➕，搜 CollisionShape2D 加进去；在 Inspector 的 Shape 字段下拉选 New RectangleShape2D；把 Size 调成 (1000, 50)——一条 1000 宽、50 高的板。

3

摆到屏幕下方

把 Floor 拖到视图中央淡蓝色相机视口的下半部分。

8.2 加圆球（RigidBody2D）

1

添加 RigidBody2D 命名 Ball

选中 Main，添加子节点 RigidBody2D，重命名为 Ball。

2

加碰撞圆

给 Ball 加子节点 CollisionShape2D，Shape 选 New CircleShape2D，Radius 设为 20。

3

加可见的 Sprite2D

给 Ball 加子节点 Sprite2D：Inspector → Texture → 点「Quick Load / 快速加载」→ 选 icon.svg（Godot 默认那个机器人图标，将就用）；Transform → Scale 调小一点如 (0.3, 0.3)，让它跟碰撞圆差不多大。

4

摆到 Floor 上方

把 Ball 拖到 Floor 上方一段距离。

⚠️ 忘记给 RigidBody2D 加 CollisionShape2D，运行时会报警告 "This node has no shape"，球会无视一切直接掉到无穷远。

8.3 给球加一点弹性

选中 Ball，在 Inspector 找到 PhysicsMaterial，下拉选 New PhysicsMaterial，展开后设置：

属性	取值
Bounce（弹性）	0.8
Friction（摩擦）	0.1

8.4 跑一下！

1

保存场景

场景 → 保存场景（Cmd/Ctrl + S），保存为 res://scenes/Main.tscn。

2

运行项目

点右上角 ▶️ 运行项目（或按 F5）。第一次运行会问"主场景"是哪个，选 Main。

3

观察

你应该看到：一个 Godot 图标球从上面掉下来，撞到下面那块板，弹了一下，再弹一下，停下。

✅ 看到球掉下来并弹起——你就把 Godot 物理跑通了。

8.5 让 AI 一句话重做这件事

把刚才做好的 Main.tscn 备份一份（右键 → 复制），然后删掉原来的。在 CodeBuddy 对话框输入：

Prompt · 让 AI 搭出最小物理场景

在当前 Godot 工程的 res://scenes/ 下新建一个
      名为 Main.tscn 的 2D 场景，包含：
      · 一个会下落的 RigidBody2D 圆球（半径 20，Bounce 0.8）
      · 一个 StaticBody2D 长条平台（1000×50）
      平台放在屏幕下半部，圆球放在屏幕上方居中，
      PhysicsMaterial 的 Friction 设为 0.1。
      运行后球应该掉下来弹一下。

按回车，等 AI 干完。如果 AI 一次没跑通——比如球漂在空中、没掉下来——把 Godot 编辑器的截图（或错误信息）丢回对话框，告诉它"球没动，请检查"。这就是后面 05 课要详细讲的「三次对话法」雏形。

✅ 这一刻你已经在用 AI 真正"做游戏"了。

六、装环境时最容易踩的 6 个坑

把这 6 条贴在你显示器边上：

路径里别有中文 / 空格——影响 Git、MCP、部分插件。
下错版本——下 Standard 不是 Mono / .NET（除非你确定要写 C#）。
MCP 工作时 Godot 必须是打开状态——关了 AI 喊不动。
RigidBody2D 必须配 CollisionShape2D——否则物理引擎不知道碰撞体长什么样。
第一次运行要选主场景。
保存项目！保存项目！保存项目！——Godot 不会自动保存，崩了就重做。

七、举一反三

这节课我们学习了「为一个具体项目挑工具 + 跑通最小闭环」这个思路。

项目类型	选型时优先看	最小闭环
卡牌游戏	UI 系统是否好用 + 数据驱动是否方便	拖一张卡到出牌区然后翻面
平台跳跃	TileMap + 物理 + 角色控制器	一个能左右走 + 跳的方块
RTS	寻路 + 编队 + 脚本性能	一个单位被点击后走到鼠标位置

挑引擎多看本项目核心机制 / 亮点是否方便实现 → 跑通一个 5 分钟内能验证物理 / 输入 / 渲染的最小场景 → 再开始堆功能