本頁面由英文機器翻譯而成。閱讀英文原文。

部落格

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

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

以 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 代理的桌面應用程式,現在讓踏出 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 視窗並執行影格迴圈。

BashAI Game Developer CLI
/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 各步驟的示意圖:.NET SDK 下載、SHA-512 驗證、外掛、還原、建置與執行
示意圖:首次執行時 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。它在你的遊戲行程內執行,並透過 AI Game Developer 將遊戲連接到代理。有了它,代理可以用 RQL 檢視並修改執行中的遊戲(一套查詢語言,取代數百個各自獨立的工具)、讀取遊戲的記錄,並要求遊戲結束。遊戲執行時,它也會在專案中為代理寫入兩份技能文件:brutal-rql 與 brutal-framework,教代理如何查詢遊戲,以及如何撰寫 BRUTAL 程式碼。

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

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
}

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

更多部落格文章

所有文章