# 以 AI 進行 BRUTAL .NET 遊戲開發 — 在 AI Game Developer 中零設定打造 C# 遊戲 — AI Game Dev

建立 BRUTAL C# 遊戲並按下 Play Game。AI Game Developer 會下載經過驗證的 .NET SDK、加入 Brutal-MCP 外掛並連接 AI 代理。

本頁面由英文機器翻譯而成。[閱讀英文原文](https://ai-game.dev/blog/brutal-dotnet-game-development-with-ai)。

[部落格](https://ai-game.dev/zh-hant/blog)

建立 BRUTAL C# 遊戲並按下 Play Game。AI Game Developer 會下載經過驗證的 .NET SDK、加入 Brutal-MCP 外掛並連接 AI 代理。

Ivan Murzak · 2026年11月15日 · 閱讀時間 5 分鐘 ·

BRUTAL 是 Ahwoo 推出的免費開源 C# 框架，可用來製作遊戲，或打造你自己的遊戲引擎。它讓 C# 直接存取原生 API 與 Vulkan，並提供 GLFW、SDL、Dear ImGui、Jolt、Box2D、FMOD、RakNet 等函式庫的綁定。它刻意不提供編輯器、場景圖與渲染器：你得自己組出整套技術堆疊。AI Game Developer 是我們內建 AI 代理的桌面應用程式，現在讓踏出 BRUTAL 的第一步幾乎毫不費力。建立專案、按下 Play Game，應用程式就會準備好遊戲建置與執行所需的一切，包括 .NET SDK。

本文說明按下 Play Game 之後會發生什麼事，以及 AI 代理能對執行中的 BRUTAL 遊戲做什麼。

## 以 AI 進行 BRUTAL .NET 遊戲開發

沒有編輯器的框架，正好與 AI 代理天生契合：整個遊戲都是程式碼，而代理很擅長程式碼。不過還有兩件事擋在路上。第一是環境設定：正確的 .NET SDK、NuGet 套件，以及一個能建置的專案。第二是可見度：沒有編輯器，就沒有檢視器讓你在遊戲執行時查看遊戲狀態，代理也一樣。

AI Game Developer 兩個問題都解決了。設定全自動，而 Brutal-MCP 外掛會在你的遊戲內執行，並將遊戲連接到代理。

## 建立 BRUTAL 專案

你可以從桌面版的建立專案對話框、從 CLI，或在聊天中請代理幫你建立專案。應用程式會寫出一個 .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 授權的義務：你發行的遊戲必須標註 Ahwoo，並在遊戲開始前顯示 BRUTAL 標誌。從第一天就做對，比在發行前才想起來容易得多。

## Play Game：零設定的 .NET

你不需要手動安裝任何東西。第一次按下 Play Game 時，應用程式會依序完成下列步驟，並全部顯示在同一張進度卡片上：

1. .NET SDK。如果你的電腦已經裝有 .NET 10 或更新版本的 SDK，應用程式會直接使用。若沒有，它會從 Microsoft 官方伺服器下載自己的副本，顯示下載百分比，並在安裝到自己的資料夾之前，用固定的 SHA-512 雜湊值驗證壓縮檔。你系統全域的 .NET 設定不會有任何變動。
2. 外掛。如果專案尚未參考 Brutal-MCP 套件，應用程式會將它加入 .csproj。
3. dotnet restore，首次執行時會從 NuGet 下載 BRUTAL 套件。卡片會持續顯示還原已執行的時間，讓你曉得它仍在運作。
4. dotnet build。若建置失敗，你會看到編譯器的錯誤訊息，而不是一個永遠不出現的遊戲。
5. dotnet run。遊戲會在專屬視窗中啟動並連接到代理。

示意圖：首次執行時 Play Game 做了哪些事

SDK 下載約 200 MB，因此只會在需要時進行，而不是在應用程式啟動時。之後 Play Game 就直接進入建置。如果你需要特定的 SDK 版本，可在設定中選擇；而專案中的 global.json 優先於該設定，行為與 dotnet 命令相同。如果下載無法進行，例如離線，應用程式會連結到 Microsoft 的 .NET 下載頁面，讓你自己安裝 SDK。

細節也設想周到。如果你刻意從專案中移除外掛，應用程式會記住這件事，不會再把它加回去。如果外掛是從共用 MSBuild 檔案（例如 Directory.Build.props）參考而來，應用程式會在那裡看到它，並不去更動你的檔案。而如果遊戲因為系統缺少某個原生函式庫（例如繪圖或視窗函式庫）而失敗，訊息開頭就會告訴你要安裝什麼。

## 代理能在執行中的遊戲裡做什麼

Brutal-MCP 是一個 NuGet 套件，com.IvanMurzak.Brutal.MCP，發佈於 [nuget.org](https://nuget.org)。它在你的遊戲行程內執行，並透過 AI Game Developer 將遊戲連接到代理。有了它，代理可以用 RQL 檢視並修改執行中的遊戲（一套查詢語言，取代數百個各自獨立的工具）、讀取遊戲的記錄，並要求遊戲結束。遊戲執行時，它也會在專案中為代理寫入兩份技能文件：brutal-rql 與 brutal-framework，教代理如何查詢遊戲，以及如何撰寫 BRUTAL 程式碼。

由於 BRUTAL 沒有場景圖，要讓代理看到什麼由你決定。註冊重要的物件，並每個影格呼叫一次 Tick，讓代理所做的變更能於影格之間在你的主執行緒上生效：

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
}
```

遊戲組件中的靜態欄位與屬性不需註冊即可看見，你也可以用屬性標註允許代理呼叫的方法。此外掛絕不會向你的遊戲拋出例外：問題會以 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 下載的時候，告訴代理你想做什麼遊戲。想進一步了解這款應用程式，請參閱 [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-hant/blog)

### [用 AI 開發 Three.js 遊戲 — 在對話視窗旁打造並遊玩網頁遊戲](https://ai-game.dev/zh-hant/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-hant/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-hant/blog/brutal-dotnet-game-development-with-ai

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