重庆大学AI训练营 + 20230763 + Godot游戏原型搭建助手

[Empiluna]

Godot 主程序智能体（Godot Main Assistant）

基于 Godot 4 + MCP + Nexent 的 AI 游戏开发主程序智能体
支持自动搭建场景、生成 GDScript、管理节点树、多智能体协作与自动测试。

---

项目简介

Godot Main Assistant 是一个专为 Godot 4.x 引擎设计的 AI 主程序开发智能体。

它运行于：

• Nexent 多智能体平台
• Godot MCP 工具链
• 大语言模型（LLM）

能够自动完成：

• 游戏项目架构设计
• 场景自动搭建
• 节点树管理
• GDScript 编写
• 信号连接
• 自动测试循环
• 多智能体协作开发

目标是实现：

“让 AI 真正参与 Godot 游戏工程开发，而不仅仅是生成代码。”

---

核心特性

1. 完整支持 Godot 4 规范

智能体严格遵循 Godot 4.x 语法：

使用新版注解

@export var speed := 300.0
@onready var sprite = $Sprite2D

---

使用新版信号连接语法

button.pressed.connect(_on_button_pressed)

---

使用 Godot 4 CharacterBody2D 工作流

func _physics_process(delta):
    velocity.x = direction * speed
    move_and_slide()

---

2. 自动搭建场景

智能体能够自动：

• 创建 Scene
• 创建节点
• 构建节点树
• 设置属性
• 保存场景

例如：

create_scene(
    scene_path="res://scenes/Main.tscn",
    root_node_type="Node2D"
)

---

3. 自动生成 GDScript

支持生成：

• 玩家控制器
• UI 系统
• 敌人 AI
• 对话系统
• 背包系统
• TileMap
• 存档系统
• 技能系统
• 状态机

---

4. 多智能体协作

项目包含多个 AI 智能体协同开发。

---

主程序智能体

负责：

• 架构设计
• 核心逻辑
• 场景组织
• 脚本生成
• 节点管理

---

美术智能体（Godot Art Assistant）

负责：

• 搜索免费素材
• Shader 编写
• 材质配置
• UI 美化
• 贴图导入

---

测试智能体（Godot Test Assistant）

负责：

• 自动运行项目
• 捕获 Runtime Log
• 截图分析
• 错误检测
• 自动反馈

---

系统架构

用户
 │
 ▼
Godot 主程序智能体
 │
 ├── 场景搭建
 ├── GDScript 编写
 ├── 节点管理
 ├── 信号连接
 └── 协调其它智能体
      │
      ├── 美术智能体
      │     ├── Shader
      │     ├── 素材
      │     └── UI
      │
      └── 测试智能体
            ├── 自动运行
            ├── Runtime 日志
            ├── 截图
            └── 错误分析

---

MCP 工具支持

该项目基于 Godot MCP 工具链运行。

---

场景相关工具

• create_scene
• open_scene
• save_scene
• get_scene_tree

---

节点相关工具

• create_node
• delete_node
• rename_node
• move_node
• update_node_property

---

脚本相关工具

• create_script
• modify_script
• read_script
• attach_script

---

运行与调试

• run_project
• stop_project
• get_editor_logs

---

资源相关

• create_resource
• list_project_resources
• reimport_resources

---

环境要求

必需软件

• Godot 4.0+
• Nexent Platform
• MCP Godot 插件
• Python 3.10+（推荐）

---

安装教程

1. 安装 Godot 4

官方下载：

https://godotengine.org/

推荐版本：

• Godot 4.2+
• Godot 4.3

---

2. 安装 Nexent

平台：

https://nexent.ai/

按照 Nexent 官方文档完成安装。

---

3. 配置 MCP

Godot MCP 插件 https://github.com/yurineko73/Godot-MCP-Native

确保：

• Godot MCP 插件已启用
• MCP Server 正在运行
• Nexent 已连接 MCP

工作流程：

Godot 编辑器
      │
      ▼
MCP 插件
      │
      ▼
Nexent 智能体

---

4. 导入智能体

将以下文件导入 Nexent：

agent_godot_main_assistant.json

使用方式

示例 Prompt

创建一个像素风横版动作游戏：

要求：
- 玩家移动
- 跳跃
- 敌人 AI
- 收集物
- 暂停菜单
- 存档系统

---

AI 将自动完成

1. 设计项目架构
2. 创建目录结构
3. 创建场景
4. 创建节点树
5. 编写 GDScript
6. 绑定脚本
7. 调用美术智能体
8. 调用测试智能体
9. 修复错误
10. 迭代直到测试通过

---

标准开发流程

Step 1：项目架构设计

智能体会先设计：

res://
 ├── scenes/
 ├── scripts/
 ├── assets/
 ├── shaders/
 └── ui/

---

Step 2：场景创建

自动：

• 创建 Scene
• 创建 Node
• 配置层级

---

Step 3：脚本生成

例如：

extends CharacterBody2D

@export var speed := 300.0

func _physics_process(delta):
    var direction = Input.get_axis("ui_left", "ui_right")

    velocity.x = direction * speed

    move_and_slide()

---

Step 4：美术协作

若需要素材：

主程序智能体会调用：

godot_art_assistant

自动：

• 搜索素材
• 下载贴图
• 编写 Shader
• 设置材质

---

Step 5：自动测试

调用：

godot_test_assistant

自动：

运行项目
    ↓
捕获 Runtime 日志
    ↓
检测 Error
    ↓
截图分析
    ↓
返回测试结果

---

使用示例

平台跳跃小游戏

注意：
1.只适用于游戏原型的快速制作，而无法制作完整的游戏，需要进行手动调整
2.由于智能体的思考轮数限制，需要通过对话继续推进

点击下载：

agent_godot_main_assistant_1780045655665.json