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

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

本页由英文机器翻译而成。[阅读英文原文](https://ai-game.dev/blog/brutal-dotnet-game-development-with-ai)。

[博客](https://ai-game.dev/zh-hans/blog)

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

Ivan Murzak · 2026年11月15日 · 5 分钟阅读 ·

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 窗口并运行帧循环。

Bash AI Game Developer CLI

```bash
/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 做了什么

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](https://nuget.org) 上。它运行在你的游戏进程中，并通过 AI Game Developer 把游戏连接到 agent。借助它，agent 可以用 RQL 查看和修改正在运行的游戏——用一门查询语言代替数百个独立的工具——还能读取游戏日志，并要求游戏退出。游戏运行时，它还会向你的项目中写入两个供 agent 使用的技能：brutal-rql 和 brutal-framework，教 agent 如何查询游戏以及如何编写 BRUTAL 代码。

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

C# Program.cs

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

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

## 博客更多内容

[全部文章](https://ai-game.dev/zh-hans/blog)

### [用 AI 开发 Three.js 游戏 — 在聊天窗口旁构建并试玩网页游戏](https://ai-game.dev/zh-hans/blog/threejs-game-development-with-ai)

2026年11月15日

AI Game Developer 现在可以创建 Three.js 网页游戏，在聊天旁的实时游戏面板中运行，并让 AI 智能体查看、试玩和测试它们。

Ivan Murzak 7 分钟阅读

### [用 AI 进行 Bevy 游戏开发 — 在聊天中创建、构建并检视 Rust 游戏](https://ai-game.dev/zh-hans/blog/bevy-game-development-with-ai)

2026年11月15日

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

Ivan Murzak 6 分钟阅读

---

Source (HTML): https://ai-game.dev/zh-hans/blog/brutal-dotnet-game-development-with-ai

Machine-translated (zh-Hans) from the English page: https://ai-game.dev/blog/brutal-dotnet-game-development-with-ai
