Desenvolvimento de jogos Bevy com IA — crie, compile e inspecione jogos em Rust pelo chat
O AI Game Developer agora suporta Bevy: crie um jogo em Rust, veja o progresso real do cargo e consulte o jogo em execução via BRP.

Bevy é um motor de jogos open source escrito em Rust, construído em torno de um Entity Component System. Ele não tem editor: um jogo Bevy é um crate do cargo, escrito em código e executado com cargo. O AI Game Developer, nosso aplicativo desktop com um agente de IA integrado, agora suporta projetos Bevy. O aplicativo cria um novo jogo Bevy para você, compila e executa com um cartão de progresso que mostra o progresso real do cargo, e conecta o agente ao jogo em execução para que ele possa olhar dentro do mundo ECS e alterá-lo.
Este post cobre o que o aplicativo faz por um projeto Bevy, o que você precisa instalar por conta própria e como o agente trabalha com um jogo em execução.
Desenvolvimento de jogos Bevy com IA
Rust e Bevy combinam bem com um agente de IA. O compilador é rigoroso e suas mensagens de erro são precisas, então o agente aprende rápido o que deu errado. O ECS mantém o estado do jogo em componentes simples que podem ser listados e lidos. O que faltava era o ciclo em volta do código: iniciar a compilação, saber quando o jogo está de fato rodando e ver o que há dentro dele sem adivinhar a partir dos logs.
O AI Game Developer adiciona esse ciclo. Ele trata uma pasta como projeto Bevy quando seu Cargo.toml depende de bevy e ela tem uma pasta src, e a partir daí o projeto ganha um botão Play, um cartão de progresso de compilação e um conjunto de ferramentas ao vivo para o agente.
O que você precisa: Rust e cargo
O aplicativo não instala o Rust para você. Jogos Bevy são compilados com cargo, então instale o toolchain do Rust com rustup a partir de https://rustup.rs uma vez. O aplicativo encontra o cargo nos lugares habituais: seu CARGO_HOME, a pasta padrão .cargo/bin no seu diretório home, ou seu PATH, o que importa no macOS quando o aplicativo é iniciado pelo Dock e não vê o PATH do seu shell. Se o cargo estiver faltando, o aplicativo avisa e aponta para o rustup em vez de falhar com um erro vago.
O Bevy também tem seus próprios requisitos de sistema em algumas plataformas, como bibliotecas de gráficos e áudio no Linux. Siga o guia de configuração do Bevy para o seu sistema operacional, e o aplicativo avisará quando um jogo parar logo depois de iniciar, com a linha de panic do seu log.
Crie um novo projeto Bevy
Você pode criar um projeto Bevy pela caixa de diálogo de criação de projeto do desktop, pela CLI com o comando create abaixo, ou pedindo ao agente em um chat. O resultado é um crate pequeno e pronto para rodar:
- Um Cargo.toml com Bevy 0.20 e sua feature bevy_remote ativada, além do perfil de desenvolvimento recomendado pelo Bevy: seu próprio código compila rapidamente, as dependências são otimizadas.
- Um main.rs que adiciona os plugins padrão do Bevy, os plugins do Remote Protocol em uma porta que o aplicativo informa, e uma câmera 2D.
- Uma pasta assets e um .gitignore para a pasta target.
/create-project bevy my-gameJá tem um jogo Bevy? Abra a pasta dele. A instalação do plugin Bevy do aplicativo adiciona a feature bevy_remote ao seu Cargo.toml. Ele nunca edita seus fontes Rust: se seu app ainda não adiciona os plugins remotos, o aplicativo mostra a linha que precisa ser adicionada, e o agente pode adicioná-la para você quando você pedir.
Acompanhe o progresso real da compilação do cargo
A primeira compilação de um jogo Bevy compila centenas de crates e pode levar vários minutos. Esperar sem saber o que acontece é a pior parte, então o aplicativo mostra isso. Quando você pressiona Play, o aplicativo executa cargo run em segundo plano e lê a própria barra de progresso do cargo a partir do log. O cartão de progresso então mostra cada etapa com números reais: atualizando o índice de crates, baixando os crates do jogo e compilando com as unidades concluídas e totais e a porcentagem que o próprio cargo informa. Nada é estimado.

Quando a compilação termina, o cartão informa que o jogo está iniciando e espera até que ele realmente rode. Se o cargo parar com um erro de compilação, o cartão mostra as linhas do erro e o caminho do log completo. Se o jogo der panic logo após iniciar, por exemplo porque falta uma biblioteca de sistema, você recebe a mensagem de panic em vez de um jogo que sumiu silenciosamente. Compilações posteriores são incrementais e bem mais rápidas.
Cada projeto roda uma vez: pressionar Play de novo enquanto o jogo roda o exibe em vez de iniciar uma segunda cópia. Fechar um chat não para seu jogo, porque você pode ainda estar jogando.
O agente conversa com seu jogo via BRP
O Bevy traz o Bevy Remote Protocol, BRP para abreviar: JSON-RPC sobre HTTP que permite a outro programa consultar e alterar o mundo ECS de um app em execução. O AI Game Developer o usa como a conexão ao vivo, apenas na sua própria máquina (127.0.0.1). Quando o agente se conecta a um projeto Bevy, ele recebe estas ferramentas:
- discover lista os métodos remotos que o jogo em execução oferece.
- query encontra entidades pelos componentes que elas têm ou não têm, e retorna os valores dos componentes.
- get_components lê componentes escolhidos de uma entidade.
- list_components lista os componentes de uma entidade, ou todos os tipos de componente que o jogo registrou.
- call executa qualquer outro método BRP, por exemplo criar ou remover uma entidade, inserir ou alterar componentes, ou ler e escrever recursos.
Isso dá ao agente fatos em vez de suposições. Pergunte "por que o inimigo não se move?" e o agente pode consultar os componentes Transform e de velocidade do inimigo enquanto o jogo roda, alterar um valor para testar uma ideia e depois corrigir o código. As ferramentas funcionam com os nomes de método das versões atuais do Bevy e recorrem aos nomes mais antigos usados pelo Bevy 0.15 e 0.16.
Vários projetos Bevy podem rodar ao mesmo tempo. O aplicativo dá a cada jogo que inicia sua própria porta BRP e conversa apenas com jogos que ele iniciou para aquele projeto, deixando a porta padrão do Bevy para um jogo que você mesmo iniciou.
Bom saber
- O jogo Bevy abre na sua própria janela nativa, como de costume. O aplicativo não o interrompe quando você fica ocioso; um reinício ou uma desconexão do agente o interrompe.
- As ferramentas do agente veem o que o BRP expõe: componentes e recursos que suportam reflection. Use Derive Reflect nos seus próprios componentes e recursos para torná-los visíveis.
- A licença do próprio Bevy, MIT ou Apache-2.0, se aplica ao seu jogo como se aplicaria sem o aplicativo.
Comece agora
Instale o Rust com rustup, baixe o AI Game Developer em ai-game.dev/download, crie um projeto Bevy e pressione Play. Enquanto a primeira compilação roda, descreva ao agente o jogo que você quer. Mais sobre o aplicativo em ai-game.dev/docs/app. Prefere criar para o navegador? Leia sobre o suporte a Three.js em ai-game.dev/blog/threejs-game-development-with-ai, e sobre o framework BRUTAL em C# em ai-game.dev/blog/brutal-dotnet-game-development-with-ai.
Créditos das imagens: o logotipo do pássaro Bevy vem do repositório do Bevy (MIT OR Apache-2.0); ele identifica a engine e continua sendo do Bevy. As ilustrações foram feitas pelo AI Game Developer.

