GoPeak 入门:用 AI 串联 Godot 开发
从安装配置到场景、脚本、调试与素材接入,演示如何让 AI 调用 GoPeak 工具,并验证产物已进入 Godot 管线。
- 1
安装并检查 GoPeak
打开 GitHub 项目页,克隆仓库并按 README 安装依赖;启动服务后确认九十余项工具均可被客户端发现。
- 2
配置 Godot 与客户端
在客户端填写 GoPeak 服务地址和 Godot 项目路径,先打开一个测试工程;确认项目可被识别,避免路径含中文或异常权限。
- 3
让 AI 管理场景
向 AI 描述“创建玩家、地面和相机”,由其调用场景管理工具生成节点树;随后在 Godot 中打开场景,检查层级、属性和信号连接。
- 4
生成并接入脚本
要求 AI 为玩家编写移动脚本,通过 GDScript LSP 补全与诊断接口生成代码;让工具写入项目后,确认 Godot 无语法错误。
- 5
调试并修复行为
让 AI 设置断点并启动 DAP 调试,复现玩家无法移动的问题;根据调用栈修改脚本,再次运行,验证位置与速度正确。
- 6
导入素材并验收
让 AI 查询 ClassDB 确认目标节点 API,并从 CC0 素材库选取贴图导入场景;最后运行项目,保存场景、脚本和资源路径。
💡 实用技巧
- 把提示词、工具调用和文件改动串成闭环
- 先让 AI 读取现有工程结构再改文件
- 每轮只安排一个可验证的小目标
- 保存关键场景与脚本,便于回滚比较
⚠️ 常见坑
- Godot 版本或插件未配置会导致工具失效
- 自动生成代码后必须运行诊断并实测
- 不要让 AI 覆盖已有场景和资源
常见问题
Q:GoPeak 安装后客户端发现不了工具怎么办?
先按 README 安装依赖并启动 GoPeak 服务,再检查客户端中的服务地址是否正确。随后确认 Godot 项目路径指向有效工程,且路径不含中文、权限无异常,重新连接后检查九十余项工具能否被发现。
Q:AI 生成的 GDScript 为什么在 Godot 里不能运行?
让 AI 先通过 GDScript LSP 的补全与诊断接口检查代码,再把脚本写入项目后打开 Godot 查看语法错误。若仍无法移动,继续用 DAP 设置断点,复现问题并依据调用栈修改脚本。
Q:怎样确认素材和脚本已进入 Godot 管线?
先让 AI 通过 ClassDB 查询目标节点 API,再从 CC0 素材库选取贴图并导入场景。运行项目检查贴图与脚本是否生效,最后保存场景、脚本和资源路径,并保留改动前版本便于回滚。