Desenvolvimento de jogos .NET com BRUTAL e IA — jogos em C# sem configuração no AI Game Developer
Crie um jogo C# BRUTAL e clique em Play Game. O AI Game Developer baixa o .NET SDK verificado, adiciona o plugin Brutal-MCP e conecta o agente.

BRUTAL é um framework C# gratuito e de código aberto para criar jogos, ou sua própria engine de jogo, feito pela Ahwoo. Ele dá ao C# acesso direto a APIs nativas e ao Vulkan, com bindings para GLFW, SDL, Dear ImGui, Jolt, Box2D, FMOD, RakNet e mais. De propósito, ele não tem editor, nem scene graph, nem renderer: você escreve sua própria stack. O AI Game Developer, nosso app desktop com um agente de IA integrado, agora torna os primeiros passos com o BRUTAL quase sem esforço. Crie um projeto, clique em Play Game, e o app prepara tudo o que o jogo precisa para compilar e rodar, incluindo o .NET SDK.
Este post explica o que acontece quando você clica em Play Game e o que o agente de IA pode fazer com um jogo BRUTAL em execução.
Desenvolvimento de jogos .NET com BRUTAL e IA
Um framework sem editor é uma combinação natural para um agente de IA: o jogo inteiro é código, e o agente é bom em código. Duas coisas ainda atrapalhavam. A primeira era a configuração: o .NET SDK certo, os pacotes NuGet, um projeto que compila. A segunda era a visibilidade: sem editor, não há inspector onde você ou o agente possam olhar o estado do jogo enquanto ele roda.
O AI Game Developer resolve as duas. A configuração é automática, e o plugin Brutal-MCP roda dentro do seu jogo e o conecta ao agente.
Crie um projeto BRUTAL
Crie um projeto pelo diálogo de criação do app desktop, pela CLI ou pedindo ao agente em um chat. O app escreve um projeto console .NET 10 que referencia os pacotes BRUTAL de que um primeiro jogo precisa (Core, Logging, Glfw e Concurrency) e o plugin Brutal-MCP. Seu Program.cs configura o logging, abre uma janela GLFW e executa um loop de frames.
/create-project brutal my-gameO projeto também contém um NOTICE.txt, e o README lista as obrigações da Licença BRUTAL: um jogo que você publica credita a Ahwoo e mostra o logo do BRUTAL antes do gameplay. É mais fácil acertar isso desde o primeiro dia do que lembrar antes do lançamento.
Play Game: .NET sem configuração
Você não precisa instalar nada à mão. Quando você clica em Play Game pela primeira vez, o app passa por estas etapas e mostra cada uma em um único cartão de progresso:
- O .NET SDK. Se sua máquina já tem um .NET 10 ou mais recente, o app usa esse. Se não, ele baixa a própria cópia dos servidores oficiais da Microsoft, mostra a porcentagem do download e verifica o arquivo com um hash SHA-512 fixo antes de instalá-lo na própria pasta. Nada muda na configuração .NET do seu sistema.
- O plugin. Se o projeto ainda não referencia o pacote Brutal-MCP, o app o adiciona ao .csproj.
- dotnet restore, que baixa os pacotes BRUTAL do NuGet na primeira execução. O cartão continua mostrando há quanto tempo o restore está rodando, para você saber que ele ainda está trabalhando.
- dotnet build. Se a build falhar, você recebe as linhas de erro do compilador, não um jogo que nunca aparece.
- dotnet run. O jogo abre na própria janela e se conecta ao agente.

O download do SDK tem cerca de 200 MB, então ele acontece só quando é necessário, não quando o app inicia. Depois disso, o Play Game vai direto para a build. Se você precisar de uma versão específica do SDK, escolha-a nas configurações, e um global.json no seu projeto tem prioridade sobre a configuração, como acontece com o comando dotnet. Se o download não puder funcionar, por exemplo offline, o app mostra um link para a página de download do .NET da Microsoft para você instalar o SDK por conta própria.
Os detalhes também são cuidados. Se você removeu o plugin de um projeto de propósito, o app lembra disso e não o adiciona de volta. Se o plugin for referenciado a partir de um arquivo MSBuild compartilhado, como Directory.Build.props, o app o enxerga ali e não mexe nos seus arquivos. E se um jogo falhar porque falta uma biblioteca nativa no seu sistema, como uma biblioteca de gráficos ou de janelas, a mensagem começa dizendo o que instalar.
O que o agente pode fazer em um jogo em execução
O Brutal-MCP é um pacote NuGet, com.IvanMurzak.Brutal.MCP, publicado no nuget.org. Ele roda dentro do processo do seu jogo e o conecta ao agente por meio do AI Game Developer. Com ele, o agente pode inspecionar e alterar o jogo em execução com RQL, uma única linguagem de consulta em vez de centenas de ferramentas separadas, ler os logs do jogo e pedir para o jogo encerrar. Quando o jogo roda, ele também grava duas skills para o agente no seu projeto, brutal-rql e brutal-framework, que ensinam o agente a consultar o jogo e a escrever código BRUTAL.
Como o BRUTAL não tem scene graph, você escolhe o que o agente vê. Registre os objetos que importam e chame Tick uma vez por frame para que as alterações feitas pelo agente rodem na sua thread principal entre os frames:
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
}Campos e propriedades estáticos do assembly do seu jogo ficam visíveis sem registro, e você pode marcar com um atributo os métodos que o agente pode chamar. O plugin nunca lança exceções dentro do seu jogo: os problemas são escritos no console com o prefixo Brutal-MCP.
Extensões para as bibliotecas do BRUTAL
O poder do BRUTAL está nos seus bindings, então o plugin tem extensões opcionais para eles: ImGui, GLFW, SDL, Jolt, Box2D, FMOD, RakNet, o Vulkan Memory Allocator e o RenderDoc. Cada uma é um pacote NuGet separado com configuração de uma linha, instalado pelo app ou pelo comando install-extension da CLI. O app avisa quando uma extensão precisa de um pacote BRUTAL que seu projeto ainda não referencia.
Comece agora
Baixe o AI Game Developer em ai-game.dev/download, crie um projeto BRUTAL e clique em Play Game. Enquanto o SDK baixa, diga ao agente o que você quer construir. Para saber mais sobre o app, veja ai-game.dev/docs/app. Interessado em outras engines sem editor? Leia sobre Bevy em ai-game.dev/blog/bevy-game-development-with-ai e sobre jogos web com Three.js em ai-game.dev/blog/threejs-game-development-with-ai. Para aprender o próprio BRUTAL, comece pelo repositório em https://github.com/ahwootech/BRUTAL.
Créditos das imagens: o emblema do BRUTAL identifica o framework; BRUTAL e seu logo pertencem à Ahwoo Limited. As ilustrações foram feitas pelo AI Game Developer.

