本页由英文机器翻译而成。阅读英文原文。

博客

用 AI 进行 Bevy 游戏开发 — 在聊天中创建、构建并检视 Rust 游戏

AI Game Developer 现已支持 Bevy。创建 Rust 游戏,查看 cargo 的真实构建进度,并让 AI 代理通过 BRP 查询运行中的游戏。

用 AI 进行 Bevy 游戏开发 — 在聊天中创建、构建并检视 Rust 游戏

Bevy 是一个用 Rust 编写的开源游戏引擎,围绕实体组件系统构建。它没有编辑器:一个 Bevy 游戏就是一个 cargo crate,用代码编写,用 cargo 运行。AI Game Developer 是我们内置 AI 代理的桌面应用,现在支持 Bevy 项目。应用会为你创建一个新的 Bevy 游戏,用一张显示 cargo 真实进度的进度卡来构建并运行它,并把代理连接到运行中的游戏,让它能查看 ECS 世界内部并进行修改。

本文介绍该应用为 Bevy 项目做了什么、你需要自己安装什么,以及代理如何与运行中的游戏协作。

用 AI 进行 Bevy 游戏开发

Rust 和 Bevy 很适合 AI 代理。编译器严格,错误信息精确,因此代理能很快明白哪里出了问题。ECS 把游戏状态保存在普通组件中,可以列出和读取。此前缺少的是围绕代码的那套循环:启动构建、知道游戏何时真正在运行,以及不靠日志猜测地看到它内部有什么。

AI Game Developer 补上了这套循环。当一个文件夹的 Cargo.toml 依赖 bevy 并且含有 src 文件夹时,它就把该文件夹视为 Bevy 项目,从此该项目会获得 Play 按钮、构建进度卡和一套供代理使用的实时工具。

你需要什么:Rust 和 cargo

应用不会替你安装 Rust。Bevy 游戏用 cargo 构建,所以先用 rustup 从 https://rustup.rs 安装一次 Rust 工具链。应用会在常见位置查找 cargo:你的 CARGO_HOME、主目录下默认的 .cargo/bin 文件夹,或你的 PATH——这在 macOS 上很重要,因为从 Dock 启动应用时它看不到你 shell 的 PATH。如果缺少 cargo,应用会明确说明并给出 rustup 链接,而不是用一个含糊的错误失败。

在某些平台上,Bevy 还有自己的系统要求,例如 Linux 上的图形和音频库。请按适合你操作系统的 Bevy 安装指南操作,当游戏启动后立刻停止时,应用会连同日志中的 panic 行一起告诉你。

创建新的 Bevy 项目

你可以从桌面端的创建项目对话框、用下方 create 命令的 CLI,或在聊天中让代理来创建 Bevy 项目。结果是一个小巧、可直接运行的 crate:

  • 一个 Cargo.toml,包含 Bevy 0.20 并开启其 bevy_remote feature,以及 Bevy 推荐的开发 profile:你自己的代码编译很快,依赖则经过优化。
  • 一个 main.rs,添加 Bevy 的默认插件、在应用传入的端口上启用 Remote Protocol 插件,以及一个 2D 相机。
  • 一个 assets 文件夹和一个针对 target 文件夹的 .gitignore。
BashAI Game Developer CLI
/create-project bevy my-game

已有 Bevy 游戏?打开它的文件夹。应用针对 Bevy 的插件安装会向你的 Cargo.toml 添加 bevy_remote 特性。它绝不会修改你的 Rust 源码:如果你的应用还没有添加 remote 插件,应用会显示需要添加的那一行,你开口时代理也能替你加上。

查看真实的 cargo 构建进度

Bevy 游戏的首次构建要编译数百个 crate,可能耗时数分钟。在不知道发生什么的情况下等待是最难受的部分,所以应用把它显示出来。当你按下 Play,应用会在后台运行 cargo run,并从其日志中读取 cargo 自己的进度条。进度卡随后用真实数字显示每一步:更新 crate 索引、下载游戏的 crate,以及编译时已完成和总的构建单元数,还有 cargo 自己报告的百分比。没有任何估算。

构建进度卡的示意图:正在编译游戏,480 个单元中已完成 308 个,64%,随后游戏启动,代理的工具连接上来
示意图:应用从 cargo 读取的构建进度,然后是实时工具

构建完成后,卡片会显示游戏正在启动,并等待它真正运行起来。如果 cargo 因编译错误停止,卡片会显示错误行和完整日志的路径。如果游戏启动后立即 panic,例如因为缺少某个系统库,你会得到 panic 消息,而不是一个悄悄消失的游戏。后续构建是增量的,要快得多。

每个项目只运行一次:游戏运行时再按 Play 会显示它,而不是启动第二个副本。关闭聊天不会停止你的游戏,因为你可能还在玩它。

代理通过 BRP 与你的游戏通信

Bevy 自带 Bevy Remote Protocol,简称 BRP:基于 HTTP 的 JSON-RPC,允许另一个程序查询和修改运行中应用的 ECS 世界。AI Game Developer 把它用作实时连接,仅限你自己的机器(127.0.0.1)。当代理连接到 Bevy 项目时,它会得到这些工具:

  • discover 列出运行中游戏提供的远程方法。
  • query 按实体拥有或不拥有的组件查找实体,并返回组件值。
  • get_components 读取某个实体的指定组件。
  • list_components 列出某个实体的组件,或游戏注册的所有组件类型。
  • call 运行任何其他 BRP 方法,例如生成或销毁实体、插入或修改组件,或读写资源。

这让代理得到事实而非猜测。问“为什么敌人不动?”,代理可以在游戏运行时查询敌人的 Transform 和 velocity 组件,改一个值来验证想法,然后修复代码。这些工具使用当前 Bevy 版本的方法名,并会回退到 Bevy 0.15 和 0.16 使用的旧名称。

多个 Bevy 项目可以同时运行。应用为它启动的每个游戏分配自己的 BRP 端口,并且只与它为该项目启动的游戏通信,把 Bevy 的默认端口留给你自己启动的游戏。

须知

  • Bevy 游戏像往常一样在自己的原生窗口中打开。你空闲时应用不会停止它;重启或与代理断开连接会停止它。
  • 代理的工具只能看到 BRP 暴露的内容:支持反射的组件和资源。为你自己的组件和资源派生 Reflect,让它们可见。
  • Bevy 自身的 MIT 或 Apache-2.0 许可证适用于你的游戏,与不使用该应用时一样。

开始使用

用 rustup 安装 Rust,从 ai-game.dev/download 下载 AI Game Developer,创建一个 Bevy 项目并按下 Play。首次构建运行时,向代理描述你想要做的游戏。关于该应用的更多信息见 ai-game.dev/docs/app。想改为面向浏览器构建?阅读 ai-game.dev/blog/threejs-game-development-with-ai 上关于 Three.js 支持的内容,以及 ai-game.dev/blog/brutal-dotnet-game-development-with-ai 上关于 BRUTAL C# 框架的内容。

图片来源:Bevy 小鸟标志来自 Bevy 仓库(MIT OR Apache-2.0);它用于指代该引擎,仍归 Bevy 所有。插图由 AI Game Developer 制作。

博客更多内容

全部文章