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

博客

用 AI 进行 BRUTAL .NET 游戏开发 — 在 AI Game Developer 中零配置开发 C# 游戏

创建 BRUTAL C# 游戏并点击 Play Game。AI Game Developer 会下载经过校验的 .NET SDK,添加 Brutal-MCP 插件并连接 AI agent。

用 AI 进行 BRUTAL .NET 游戏开发 — 在 AI Game Developer 中零配置开发 C# 游戏

BRUTAL 是由 Ahwoo 推出的免费开源 C# 框架,用于制作游戏或你自己的游戏引擎。它让 C# 能直接访问原生 API 和 Vulkan,并提供 GLFW、SDL、Dear ImGui、Jolt、Box2D、FMOD、RakNet 等库的绑定。它有意不提供编辑器、场景图和渲染器:整套技术栈由你自己搭建。我们的桌面应用 AI Game Developer 内置 AI agent,现在它让 BRUTAL 的上手过程几乎不费力气。创建一个项目,点击 Play Game,应用就会准备好游戏构建和运行所需的一切,包括 .NET SDK。

本文将说明你点击 Play Game 后会发生什么,以及 AI agent 面对一个正在运行的 BRUTAL 游戏能做些什么。

用 AI 进行 BRUTAL .NET 游戏开发

一个没有编辑器的框架天然适合 AI agent:整个游戏都是代码,而 agent 擅长处理代码。但还有两件事挡在路上。第一是环境配置:正确的 .NET SDK、NuGet 包、一个能构建的项目。第二是可见性:没有编辑器,就没有检查器让你或 agent 在游戏运行时查看它的状态。

AI Game Developer 把这两个问题都解决了。配置是自动完成的,Brutal-MCP 插件在你的游戏进程内运行,并把游戏连接到 agent。

创建一个 BRUTAL 项目

你可以从桌面端的创建项目对话框创建项目,也可以用 CLI,或者直接在聊天中让 agent 创建。应用会生成一个 .NET 10 控制台项目,引用第一个游戏所需的 BRUTAL 包(Core、Logging、Glfw 和 Concurrency)以及 Brutal-MCP 插件。它的 Program.cs 会配置日志、打开一个 GLFW 窗口并运行帧循环。

BashAI Game Developer CLI
/create-project brutal my-game

项目还包含一个 NOTICE.txt,其 README 列出了 BRUTAL License 的义务:你发布的游戏需要致谢 Ahwoo,并在游戏开始前显示 BRUTAL 标志。从一开始就做对,比在发布前才想起来要容易得多。

Play Game:零配置的 .NET

你不需要手动安装任何东西。第一次点击 Play Game 时,应用会依次执行以下步骤,并在同一张进度卡片中展示每一步:

  1. .NET SDK。如果你的机器上已有 .NET 10 或更新版本的 SDK,应用会直接使用它。如果没有,它会从微软官方服务器下载自己的副本,显示下载百分比,并在安装到自己的文件夹之前用固定的 SHA-512 哈希校验压缩包。你系统全局的 .NET 配置不会有任何改动。
  2. 插件。如果项目尚未引用 Brutal-MCP 包,应用会把它添加到 .csproj 中。
  3. dotnet restore,首次运行时它会从 NuGet 下载 BRUTAL 包。卡片会持续显示还原已经运行了多长时间,让你知道它还在工作。
  4. dotnet build。如果构建失败,你会看到编译器的错误行,而不是一个始终不出现的游戏。
  5. dotnet run。游戏在自己的窗口中启动,并连接到 agent。
Play Game 各步骤的示意图:.NET SDK 下载、SHA-512 校验、插件、还原、构建和运行
示意图:首次运行时 Play Game 做了什么

SDK 下载约 200 MB,所以只在需要时才会发生,而不是在应用启动时。此后,Play Game 会直接进入构建。如果你需要特定的 SDK 版本,可以在设置中选择,而项目中的 global.json 会覆盖该设置,和 dotnet 命令的行为一致。如果下载无法进行,例如处于离线状态,应用会给出微软 .NET 下载页面的链接,让你可以自行安装 SDK。

细节也考虑得很周到。如果你有意从项目中移除了插件,应用会记住这一点,不会再加回去。如果插件是通过 Directory.Build.props 这类共享的 MSBuild 文件引用的,应用会在那里识别到它,不会改动你的文件。如果因为你的系统缺少某个原生库(例如图形或窗口库)导致游戏失败,提示信息会以需要安装什么开头。

Agent 在运行中的游戏里能做什么

Brutal-MCP 是一个 NuGet 包,包名 com.IvanMurzak.Brutal.MCP,发布在 nuget.org 上。它运行在你的游戏进程中,并通过 AI Game Developer 把游戏连接到 agent。借助它,agent 可以用 RQL 查看和修改正在运行的游戏——用一门查询语言代替数百个独立的工具——还能读取游戏日志,并要求游戏退出。游戏运行时,它还会向你的项目中写入两个供 agent 使用的技能:brutal-rql 和 brutal-framework,教 agent 如何查询游戏以及如何编写 BRUTAL 代码。

由于 BRUTAL 没有场景图,agent 能看到什么由你决定。注册重要的对象,并每帧调用一次 Tick,这样 agent 所做的修改会在帧与帧之间于你的主线程上执行:

C#Program.cs
BrutalMcp.Register(world, "World");          // make objects visible to agents (any C# object)
BrutalMcp.Register(scheduler, "Simulation");

while (!window.ShouldClose && !BrutalMcp.QuitRequested)
{
    Glfw.PollEvents();
    Update();
    BrutalMcp.Tick();                        // once per frame: agents' main-thread work runs here
}

游戏程序集中的静态字段和属性无需注册即可见,你还可以用特性标记 agent 可以调用的方法。插件绝不会向你的游戏抛出异常:问题会以 Brutal-MCP 前缀写入控制台。

BRUTAL 各库的扩展

BRUTAL 的强大之处在于它的绑定,因此插件为这些绑定提供了可选扩展:ImGui、GLFW、SDL、Jolt、Box2D、FMOD、RakNet、Vulkan Memory Allocator 和 RenderDoc。每个扩展都是独立的 NuGet 包,只需一行配置,可从应用中安装,也可使用 CLI 的 install-extension 命令安装。当某个扩展需要你的项目尚未引用的 BRUTAL 包时,应用会给出警告。

开始使用

从 ai-game.dev/download 下载 AI Game Developer,创建一个 BRUTAL 项目并点击 Play Game。在 SDK 下载的时间里,告诉 agent 你想做什么。要了解这款应用的更多信息,请访问 ai-game.dev/docs/app。对其它没有编辑器的引擎感兴趣?可以阅读 ai-game.dev/blog/bevy-game-development-with-ai 上关于 Bevy 的文章,以及 ai-game.dev/blog/threejs-game-development-with-ai 上关于 Three.js 网页游戏的文章。想学习 BRUTAL 本身,可以从它的仓库 https://github.com/ahwootech/BRUTAL 开始。

图片来源:BRUTAL 徽标用于标识该框架;BRUTAL 及其标志归 Ahwoo Limited 所有。示意图由 AI Game Developer 制作。

博客更多内容

全部文章