Esta página se tradujo automáticamente del inglés. Lee el original en inglés.

Blog

Desarrollo de juegos con Bevy e IA — Crea, compila e inspecciona juegos de Rust desde el chat

AI Game Developer ya soporta Bevy. Crea un juego Rust, sigue el progreso real de cargo y deja que el agente consulte el juego en marcha por BRP.

Desarrollo de juegos con Bevy e IA — Crea, compila e inspecciona juegos de Rust desde el chat

Bevy es un motor de juegos de código abierto escrito en Rust, construido en torno a un Entity Component System. No tiene editor: un juego de Bevy es un crate de cargo, escrito en código y ejecutado con cargo. AI Game Developer, nuestra aplicación de escritorio con un agente de IA integrado, ya es compatible con proyectos de Bevy. La aplicación crea un nuevo juego de Bevy por ti, lo compila y lo ejecuta con una tarjeta de progreso que muestra el progreso real de cargo, y conecta el agente con el juego en ejecución para que pueda mirar dentro del mundo ECS y cambiarlo.

Este artículo cubre lo que la aplicación hace por un proyecto de Bevy, lo que necesitas instalar tú mismo y cómo trabaja el agente con un juego en ejecución.

Desarrollo de juegos con Bevy e IA

Rust y Bevy se adaptan bien a un agente de IA. El compilador es estricto y sus mensajes de error son precisos, así que el agente aprende rápido qué salió mal. El ECS mantiene el estado del juego en componentes simples que se pueden listar y leer. Lo que faltaba era el bucle alrededor del código: iniciar la compilación, saber cuándo el juego se está ejecutando realmente y ver qué hay dentro sin adivinarlo a partir de los registros.

AI Game Developer añade ese bucle. Trata una carpeta como proyecto de Bevy cuando su Cargo.toml depende de bevy y tiene una carpeta src, y a partir de ahí el proyecto obtiene un botón Play, una tarjeta de progreso de compilación y un conjunto de herramientas en vivo para el agente.

Lo que necesitas: Rust y cargo

La aplicación no instala Rust por ti. Los juegos de Bevy se compilan con cargo, así que instala la cadena de herramientas de Rust con rustup desde https://rustup.rs una vez. La aplicación busca cargo en los lugares habituales: tu CARGO_HOME, la carpeta .cargo/bin predeterminada en tu directorio personal o tu PATH, lo cual importa en macOS cuando la aplicación se inicia desde el Dock y no ve el PATH de tu shell. Si falta cargo, la aplicación lo indica y enlaza a rustup en lugar de fallar con un error vago.

Bevy también tiene sus propios requisitos de sistema en algunas plataformas, como bibliotecas de gráficos y audio en Linux. Sigue la guía de instalación de Bevy para tu sistema operativo, y la aplicación te avisará cuando un juego se detiene justo después de arrancar, con la línea de panic de su registro.

Crear un nuevo proyecto de Bevy

Puedes crear un proyecto de Bevy desde el diálogo de creación de proyectos de la aplicación de escritorio, desde la CLI con el comando create de abajo, o pidiéndoselo al agente en un chat. El resultado es un crate pequeño y listo para ejecutar:

  • Un Cargo.toml con Bevy 0.20 y su feature bevy_remote activada, además del perfil de desarrollo recomendado por Bevy: tu propio código compila rápido y las dependencias están optimizadas.
  • Un main.rs que añade los plugins predeterminados de Bevy, los plugins del Remote Protocol en un puerto que la aplicación pasa, y una cámara 2D.
  • Una carpeta assets y un .gitignore para la carpeta target.
BashCLI de AI Game Developer
/create-project bevy my-game

¿Ya tienes un juego de Bevy? Abre su carpeta. La instalación del plugin de Bevy de la aplicación añade la feature bevy_remote a tu Cargo.toml. Nunca edita tu código Rust: si tu aplicación todavía no añade los plugins remotos, la aplicación te muestra la línea que hay que añadir, y el agente puede añadirla por ti cuando se lo pidas.

Observa el progreso real de compilación de cargo

La primera compilación de un juego de Bevy compila cientos de crates y puede tardar varios minutos. Esperar sin saber qué ocurre es la peor parte, así que la aplicación lo muestra. Cuando pulsas Play, la aplicación ejecuta cargo run en segundo plano y lee la barra de progreso del propio cargo desde su registro. La tarjeta de progreso muestra entonces cada paso con números reales: actualización del índice de crates, descarga de los crates del juego y compilación con las unidades de compilación terminadas y totales y el porcentaje que el propio cargo informa. Nada es estimado.

Una ilustración de la tarjeta de progreso de compilación: Compilando el juego, 308 de 480 unidades, 64 por ciento, después el juego arranca y se conectan las herramientas del agente
Ilustración: el progreso de compilación que la aplicación lee de cargo, y después las herramientas en vivo

Cuando termina la compilación, la tarjeta indica que el juego está arrancando y espera hasta que realmente se ejecuta. Si cargo se detiene con un error de compilación, la tarjeta muestra las líneas del error y la ruta del registro completo. Si el juego entra en panic justo después de arrancar, por ejemplo porque falta una biblioteca del sistema, recibes el mensaje de panic en lugar de un juego que desapareció en silencio. Las compilaciones posteriores son incrementales y mucho más rápidas.

Cada proyecto se ejecuta una vez: pulsar Play de nuevo mientras el juego está en marcha lo muestra en lugar de iniciar una segunda copia. Cerrar un chat no detiene tu juego, porque puede que sigas jugando.

El agente habla con tu juego a través de BRP

Bevy incluye el Bevy Remote Protocol, BRP para abreviar: JSON-RPC sobre HTTP que permite a otro programa consultar y cambiar el mundo ECS de una aplicación en ejecución. AI Game Developer lo usa como conexión en vivo, solo en tu propia máquina (127.0.0.1). Cuando el agente se conecta a un proyecto de Bevy, obtiene estas herramientas:

  • discover lista los métodos remotos que sirve el juego en ejecución.
  • query encuentra entidades por los componentes que tienen o no tienen, y devuelve los valores de los componentes.
  • get_components lee componentes concretos de una entidad.
  • list_components lista los componentes de una entidad, o todos los tipos de componente que el juego registró.
  • call ejecuta cualquier otro método BRP, por ejemplo crear o eliminar una entidad, insertar o cambiar componentes, o leer y escribir recursos.

Eso le da al agente hechos en lugar de suposiciones. Pregunta «¿por qué no se mueve el enemigo?» y el agente puede consultar los componentes Transform y velocidad del enemigo mientras el juego se ejecuta, cambiar un valor para probar una idea y luego corregir el código. Las herramientas funcionan con los nombres de método de las versiones actuales de Bevy y recurren a los nombres antiguos que usaban Bevy 0.15 y 0.16.

Varios proyectos de Bevy pueden ejecutarse a la vez. La aplicación da a cada juego que inicia su propio puerto BRP y solo habla con los juegos que inició para ese proyecto, dejando el puerto predeterminado de Bevy a un juego que hayas iniciado tú.

Conviene saberlo

  • El juego de Bevy se abre en su propia ventana nativa, como de costumbre. La aplicación no lo detiene cuando estás inactivo; un reinicio o una desconexión del agente sí lo detiene.
  • Las herramientas del agente ven lo que BRP expone: componentes y recursos que admiten reflexión. Deriva Reflect en tus propios componentes y recursos para hacerlos visibles.
  • La licencia propia de Bevy, MIT o Apache-2.0, se aplica a tu juego igual que sin la aplicación.

Primeros pasos

Instala Rust con rustup, descarga AI Game Developer desde ai-game.dev/download, crea un proyecto de Bevy y pulsa Play. Mientras se ejecuta la primera compilación, describe al agente el juego que quieres. Hay más información sobre la aplicación en ai-game.dev/docs/app. ¿Prefieres compilar para el navegador? Lee sobre la compatibilidad con Three.js en ai-game.dev/blog/threejs-game-development-with-ai, y sobre el framework BRUTAL de C# en ai-game.dev/blog/brutal-dotnet-game-development-with-ai.

Créditos de las imágenes: el logotipo del pájaro de Bevy proviene del repositorio de Bevy (MIT OR Apache-2.0); identifica al motor y sigue siendo de Bevy. Las ilustraciones las creó AI Game Developer.

Más del blog

Todas las entradas