用一句话造场景：Godot-MCP 自然语言驱动游戏开发的 8 个经典提示词-平芜编程栈

用一句话造场景：Godot-MCP 自然语言驱动游戏开发的 8 个经典提示词

【免费下载链接】Godot-MCPAn MCP for Godot that lets you create and edit games in the Godot game engine with tools like Claude项目地址: https://gitcode.com/gh_mirrors/god/Godot-MCP

Godot-MCP 是一款把 AI 助手（如 Claude）接入 Godot 游戏引擎的开源插件，基于模型上下文协议（MCP），让你用自然语言直接创建场景、节点和脚本——说一句“加个会巡逻的敌人”，它就能在你的 Godot 项目里真正动手干活。本文精选 8 个新手可直接套用的经典提示词，帮你快速上手自然语言驱动的游戏开发。

先花 2 分钟了解 Godot-MCP 是什么

Godot-MCP 由两部分组成：

组成部分	位置	作用
Godot 插件（Addon）	addons/godot_mcp/	在编辑器内启动 WebSocket 服务，执行节点、脚本、场景等命令
MCP 服务器	server/src/index.ts	把 Claude 的请求翻译成 Godot 能执行的指令

工作流程非常直观：👇

打开 Godot 项目，在右侧的 "Godot MCP Server" 面板点击Start Server（面板源码见 mcp_panel.gd）
启动 MCP 服务器（cd server && npm install && npm run build && npm start）
在 Claude 中用一句话下达任务
回到 Godot 查看 AI 创建的场景、节点和脚本

💡 详细原理可以看 docs/architecture.md，它解释了 Claude → MCP 服务器 → Godot 的完整指令链路。

一键安装步骤

克隆仓库：git clone https://gitcode.com/gh_mirrors/god/Godot-MCP
将godot_mcp文件夹复制到你自己的 Godot 项目addons目录，在项目设置 → 插件中启用 "Godot MCP"
在server目录执行npm install和npm run build
按上面第 2 步在 Claude Desktop 中配置好 MCP 工具

完整图文说明见 docs/installation-guide.md。

8 个经典提示词清单

以下提示词全部来自项目官方文档的真实示例，覆盖造场景、写脚本、做 UI、调 Bug 四大场景。💬 建议逐条复制体验，从简单任务开始。

1. 一句话生成 2D 平台跳跃场景

我在 Godot 里做一个 2D 平台游戏。帮我创建一个简单场景：包含玩家角色精灵、一个平台和一枚可收集的金币。

这条提示词会触发create_scene、create_node等工具（定义在 node_tools.ts、scene_tools.ts）。几秒钟后，切回 Godot 就能看到完整的场景树——不用手动添加任何节点。

2. 给角色写移动与跳跃脚本

给玩家角色加一个移动脚本：方向键左右移动，空格键跳跃。

AI 会自动生成 GDScript 文件、写好_physics_process()移动逻辑，并把脚本挂到玩家节点上。之后按 F5 运行即可测试，全程无需打开代码编辑器。

3. 搭建游戏主菜单

我需要游戏主菜单，包含"开始游戏"、"选项"和"退出"三个按钮，帮我实现。

这是最典型的"一句话造 UI"任务：AI 会创建菜单场景、摆放 Button 节点、编写点击响应脚本，并给"开始游戏"按钮接入场景切换逻辑。官方示例见 README.md 的 Example Prompts 一节。

4. 制作巡逻型敌人 AI

创建一个敌人 AI：在多个路点之间巡逻，当玩家进入攻击范围时发起攻击。

💡 小技巧：先让 AI 执行get-scene-tree读取当前场景结构，再下达这条指令，它能更准确地知道"玩家"节点在哪里。

5. 实现带 UI 的计分系统

给游戏加一个计分系统：玩家收集物品时分数增加。请创建：1. 带分数标签的 UI；2. 跟踪分数的脚本；3. 收集物品时更新分数的逻辑。

这是多步骤任务的范例——AI 会自动拆解成"建 UI → 写全局脚本 → 接入收集物脚本"三步依次执行，正好展示了 AI 的链式工作流能力。

6. 让 AI 当你的调试助手

我的玩家角色有时会穿过地板掉下去，帮我排查一下原因。

调试是 MCP 最有价值的场景之一：AI 能读取你当前场景的节点属性、碰撞体设置和脚本内容，定位到问题（比如碰撞层配置错误、移动速度超过物理步长）并直接修改。

7. 一键重构：改用信号通信

把这段代码重构成使用信号（signal）代替直接节点引用。

Godot 社区推崇信号解耦，而手写信号连接繁琐。把这段提示词发给 AI，它会重写脚本、声明信号并自动连接，是学习 GDScript 设计模式的好机会。

8. 直接运行项目验证效果

运行项目，然后告诉我当前场景的结构。

通过run-project、stop-project、get-scene-tree等编辑器命令（参考 editor_tools.ts），你可以让 AI 代替你"按 F5"，跑起来后还能让它读回场景树做核对，形成"改 → 跑 → 查"的闭环。

新手提示词写法指南

📌 官方在 docs/getting-started.md 中总结了 5 条经验，浓缩成 4 点：

说具体：写清节点类型、名字、坐标，例如"创建一个名为 StartButton 的 Button 节点"
先简单：从单个节点、单个脚本开始，再逐步加复杂度
多迭代：让 AI 做小改动，频繁回 Godot 检查，而不是一次要一大段功能
给上下文：涉及具体节点时，先让 AI 读取场景树或当前脚本，它再动手会更准

命令出错了怎么办？

Claude 连不上 Godot：确认 MCP 面板里的 WebSocket 服务器已启动，端口一致（默认 9080）
命令执行失败：查看 MCP 面板日志，检查提示词里的节点路径是否有效（一般以res://或/root/开头）
改动没显示：保存场景并刷新编辑器

更多排障内容见 docs/getting-started.md 的 Troubleshooting 章节。

用一句话造场景：Godot-MCP 自然语言驱动游戏开发的 8 个经典提示词