이 페이지는 영어에서 기계 번역되었습니다. 영어 원문 읽기.

블로그

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 에이전트가 있는 데스크톱 앱인 AI Game Developer는 이제 BRUTAL의 첫걸음을 거의 수고 없이 만들어 줍니다. 프로젝트를 만들고 Play Game을 누르면, 앱이 .NET SDK를 포함해 게임을 빌드하고 실행하는 데 필요한 모든 것을 준비합니다.

이 글에서는 Play Game을 눌렀을 때 무슨 일이 일어나는지, 그리고 실행 중인 BRUTAL 게임에서 AI 에이전트가 무엇을 할 수 있는지 설명합니다.

AI와 함께하는 BRUTAL .NET 게임 개발

에디터가 없는 프레임워크는 AI 에이전트와 자연스럽게 맞습니다. 게임 전체가 코드이고, 에이전트는 코드를 잘 다루니까요. 하지만 두 가지가 여전히 걸림돌이었습니다. 첫째는 설정이었습니다. 올바른 .NET SDK, NuGet 패키지, 빌드되는 프로젝트. 둘째는 가시성이었습니다. 에디터가 없으면 게임이 실행되는 동안 여러분이나 에이전트가 게임 상태를 들여다볼 인스펙터가 없습니다.

AI Game Developer는 두 가지 모두를 해결합니다. 설정은 자동이고, Brutal-MCP 플러그인이 게임 안에서 실행되며 게임을 에이전트에 연결합니다.

BRUTAL 프로젝트 만들기

데스크톱의 프로젝트 만들기 대화상자에서, CLI에서, 또는 채팅으로 에이전트에게 요청해서 프로젝트를 만들 수 있습니다. 앱은 첫 게임에 필요한 BRUTAL 패키지(Core, Logging, Glfw, Concurrency)와 Brutal-MCP 플러그인을 참조하는 .NET 10 콘솔 프로젝트를 작성합니다. Program.cs는 로깅을 설정하고 GLFW 창을 열고 프레임 루프를 실행합니다.

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

프로젝트에는 NOTICE.txt도 들어 있고, README에는 BRUTAL 라이선스의 의무 사항이 나열되어 있습니다. 출시하는 게임은 Ahwoo를 크레딧에 표시하고 게임플레이 전에 BRUTAL 로고를 보여줘야 합니다. 출시 직전에 기억하는 것보다 첫날부터 제대로 해두는 편이 쉽습니다.

Play Game: 설정 없는 .NET

무언가를 직접 설치할 필요가 없습니다. 처음 Play Game을 누르면 앱이 다음 단계를 차례로 진행하고, 각 단계를 하나의 진행 카드에 표시합니다.

  1. The .NET SDK. 컴퓨터에 이미 .NET 10 이상 SDK가 있으면 앱이 그것을 사용합니다. 없으면 Microsoft 공식 서버에서 자체 사본을 내려받고, 다운로드 비율을 보여주며, 고정된 SHA-512 해시와 아카이브를 대조한 뒤 앱 전용 폴더에 설치합니다. 시스템 전역 .NET 설정은 아무것도 바뀌지 않습니다.
  2. 플러그인. 프로젝트가 아직 Brutal-MCP 패키지를 참조하지 않으면 앱이 .csproj에 추가합니다.
  3. dotnet restore. 첫 실행 시 NuGet에서 BRUTAL 패키지를 내려받습니다. 카드에는 restore가 얼마나 오래 실행 중인지 계속 표시되어 아직 작업 중임을 알 수 있습니다.
  4. dotnet build. 빌드가 실패하면 게임이 뜨지 않는 대신 컴파일러의 오류 줄을 보여줍니다.
  5. dotnet run. 게임이 자체 창에서 시작되고 에이전트에 연결됩니다.
Play Game 단계 삽화: .NET SDK 다운로드, SHA-512 검사, 플러그인, restore, build, run
삽화: 첫 실행에서 Play Game이 하는 일

SDK 다운로드는 약 200MB이므로 앱이 시작될 때가 아니라 필요할 때만 이루어집니다. 그 후에는 Play Game이 곧바로 빌드로 넘어갑니다. 특정 SDK 버전이 필요하면 설정에서 선택할 수 있고, 프로젝트의 global.json이 설정보다 우선합니다. dotnet 명령에서 그러하듯이요. 다운로드가 불가능한 경우, 예를 들어 오프라인이라면 앱이 Microsoft의 .NET 다운로드 페이지로 연결해 주므로 SDK를 직접 설치할 수 있습니다.

세부 사항도 꼼꼼합니다. 프로젝트에서 플러그인을 일부러 제거했다면 앱이 그것을 기억하고 다시 추가하지 않습니다. 플러그인이 Directory.Build.props 같은 공유 MSBuild 파일에서 참조되고 있다면 앱이 그곳에서 확인하고 여러분의 파일은 건드리지 않습니다. 그리고 그래픽 라이브러리나 윈도우 라이브러리처럼 시스템에 없는 네이티브 라이브러리 때문에 게임이 실패하면, 메시지가 무엇을 설치해야 하는지부터 알려줍니다.

실행 중인 게임에서 에이전트가 할 수 있는 일

Brutal-MCP는 nuget.org에 게시된 NuGet 패키지 com.IvanMurzak.Brutal.MCP입니다. 게임 프로세스 안에서 실행되며 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가 제작했습니다.

블로그의 다른 글

전체 글