Engine de jogos com IA
Como construir uma engine de jogos AAA com agentes de IA
Estamos construindo FRIENDLY?, um jogo de sobrevivência em uma engine própria em Rust e Vulkan, pensada para alcançar gráficos e netcode de classe AAA. A engine é escrita por agentes de IA sob direção humana e submetida a um contrato rigoroso: nada é mesclado enquanto não passar nas verificações. Esta página mostra o ciclo e as nove regras por trás dele.
O que estamos construindo
FRIENDLY? é um jogo de sobrevivência em fase inicial de desenvolvimento.
A engine é escrita em Rust (edição 2024) diretamente sobre Vulkan 1.3 ou superior, com shaders Slang pré-compilados, o crate Bevy ECS, o Jolt Physics 5.6 e upscaling DLSS e FSR.
O netcode usa servidor autoritativo e roda sobre QUIC com TLS 1.3. O mundo é um vale real de cerca de 6 × 6 km.
Cerca de 100 % do código é escrito por agentes de IA sob direção humana. O arquivo de projeto do jogo resume o contrato em uma frase: “Strictness is the product.” (O rigor é o produto.)
O ciclo: planejar, decidir, faixa, verificações, mesclar
O mesmo ciclo roda a nossa engine de jogos e vai para o seu repositório quando configuramos os seus agentes.
-
Planejar
O plano é do responsável. As funcionalidades seguem PRD → tarefas → execução.
-
Decidir
Cada decisão é registrada como ADR antes de existir código.
-
Faixa
Uma mudança, uma faixa. Agentes especialistas, um líder.
-
Verificações
Testes e uma barreira de lint que só fica mais rigorosa. Uma nova verificação precisa falhar uma vez primeiro.
-
Mesclar
Só entra trabalho verde. Os agentes não podem afrouxar as próprias regras.
Nove regras que tornam os agentes confiáveis
Cada regra traz o seu motivo e um exemplo concreto da engine.
-
O responsável é dono do plano
- Regra
- As pessoas decidem o que é construído. Os agentes constroem.
- Por quê
- Os agentes executam bem um plano. Escolher o plano é a parte que não dá para delegar.
- Exemplo
- As funcionalidades seguem PRD → tarefas → execução, e o plano fica com o responsável.
-
Decidir primeiro, por escrito
- Regra
- Uma decisão é registrada antes de existir código.
- Por quê
- Uma decisão escrita pode ser conferida e revertida. Uma decisão escondida em um diff, não.
- Exemplo
- Cada decisão é um ADR, e um crate novo precisa do seu ADR antes de existir.
-
Uma mudança, uma faixa
- Regra
- Cada mudança tem a sua própria faixa.
- Por quê
- Uma mudança pequena e separada é fácil de revisar e fácil de descartar.
- Exemplo
- Cada mudança na engine vive na sua própria faixa e precisa passar nas verificações antes de ser mesclada.
-
Verificações antes do merge, e uma verificação nova falha primeiro
- Regra
- Nada é mesclado enquanto as verificações não passarem, e toda verificação nova precisa ser vista falhando antes de se confiar nela.
- Por quê
- Uma verificação que nunca falhou pode não estar verificando nada.
- Exemplo
- A barreira de lint são os grupos clippy all, pedantic e nursery, mais cerca de 70 lints de restrição. O código entregue não tem panics, o código unsafe só existe em crates de uma lista autorizada, cada item está documentado e os testes vêm primeiro.
-
O agente não pode afrouxar as próprias regras
- Regra
- O plano de controle é somente leitura para os agentes.
- Por quê
- Uma regra que um agente pode editar é só uma sugestão.
- Exemplo
- Regras, hooks, agentes e a barreira de lint estão travados em somente leitura.
#[allow]é proibido; só é permitido#[expect(lint, reason)], com uma justificativa escrita. A barreira só fica mais rigorosa.
-
O conhecimento vive em arquivos
- Regra
- O que os agentes precisam saber está escrito no repositório.
- Por quê
- O que vive em um chat some na sessão seguinte. O que vive no repositório é lido toda vez.
- Exemplo
- Guardamos o conhecimento do projeto em arquivos do repositório que chamamos de living skills.
-
Um agente de entrada e especialistas
- Regra
- Um agente principal recebe o trabalho e repassa aos especialistas.
- Por quê
- Um agente mantém a visão geral. Os especialistas trazem a profundidade.
- Exemplo
- Um agente principal, a “porta”, trabalha com agentes especialistas em renderização, netcode e revisão de código Rust.
-
Hooks barram ações perigosas
- Regra
- Ações perigosas são bloqueadas por hooks, não por instruções.
- Por quê
- Uma instrução é um conselho. Um hook é uma imposição.
- Exemplo
- No repositório da engine, hooks barram ações perigosas antes de elas rodarem.
-
Nenhuma afirmação sem uma execução real
- Regra
- Um número só é publicado quando uma execução real o produziu.
- Por quê
- Um número de cabeça é boato.
- Exemplo
- Só publicamos números medidos em execuções reais, com o hardware identificado. Por isso esta página não traz valores de quadros por segundo.
Três exemplos da engine
Cada exemplo é uma funcionalidade da engine e a regra que está por trás dela.
Clima ajustado a registros reais
O modelo climático é calibrado com a reanálise ERA5 e com registros de estações do NCEI e do DWD. Ele controla nuvens volumétricas e usa as posições reais do sol e da lua.
A regra 9 em ação: o modelo é ajustado a registros medidos, não ao gosto de alguém. As nuvens são a parte que ainda está inacabada; veja abaixo.

Árvores onde existem árvores de verdade
O mapa é um vale real perto de Ružomberok, na Eslováquia, com cerca de 6 × 6 km de terreno real. As árvores ficam onde os dados LiDAR do vale, com resolução de 1 m, indicam árvores.
A decisão de construir sobre um vale real está registrada em um ADR, como toda decisão (regra 2).

Balas sem hitscan
Cada projétil segue a sua própria trajetória sob a ação da gravidade, do vento e de um arrasto que depende do número de Mach. Não existe hitscan.
Em uma funcionalidade assim, “parece certo” não prova nada; por isso o método exige verificações e execuções reais (regras 4 e 9).
O que ainda não está pronto
- Formas das nuvens. O modelo climático controla nuvens volumétricas, mas as formas ainda não estão como queremos.
- Iluminação global. Em desenvolvimento, desativada por padrão.
- O jogo em si. É um trabalho em andamento em fase inicial: uma pequena cena jogável com duas casas, grandes florestas e clima, e zumbis provisórios que demonstram a detecção de acertos e a balística em rede.
- O objetivo de classe AAA. É o objetivo pelo qual trabalhamos. Não afirmamos paridade com nenhuma outra engine e não publicamos valores de quadros por segundo.
A configuração por trás disso
Nossa própria configuração de IA sobre o Claude Code, em números: um sistema de 27 agentes especializados com 73 módulos de conhecimento e cinco servidores MCP próprios.
Nos nossos próprios produtos, nada é entregue sem passar no PHPStan no nível mais alto e no ESLint, Stylelint, TypeScript, Dart e Clippy na configuração mais rigorosa, além de 215 regras personalizadas. O código gerado também não tem exceções.
Por trás estão mais de 20 anos de desenvolvimento web full stack, mais de quatro anos construindo com IA e um framework web próprio em 18 idiomas.
Perguntas frequentes
Agentes de IA conseguem construir uma engine de jogos?
No nosso caso, cerca de 100 % do código é escrito por agentes de IA sob direção humana. O resultado é um trabalho em andamento em fase inicial, e é um contrato rigoroso de regras e verificações que o mantém correto.
O que torna confiável o código escrito por IA?
Verificações antes do merge: testes, uma barreira de lint com os grupos clippy mais cerca de 70 lints de restrição, e outras checagens. Somam-se a isso regras e hooks que os agentes não podem afrouxar.
O jogo está pronto?
Não. Estamos construindo e ele está em fase inicial. O que ainda falta está em “O que ainda não está pronto”.
