Probar un juego de Godot 4 con un agente de Cursor

A quién le sirve. Desarrolladores de juegos con Godot 4 que quieren una prueba automática de su interfaz, con capturas y un informe de fallos.

Qué hicieron

Instalas un complemento de Godot, habilidades, un comando y un subagente. Quien llama le da al subagente probador una parte del juego con criterios, una escena y una acción. El agente revisa los nombres únicos de los nodos de la escena y el mapa de controles, escribe un flujo en JSON dentro de res://agent/ y lo ejecuta con la línea de comandos del complemento. Las pulsaciones se envían como acciones de control ya definidas, y las capturas acaban en la carpeta out/.

Cómo salió

Cada ejecución termina en AGENT_OK o AGENT_FAIL, y el agente informa de si pasa o falla. Un error de script o un control sin asignar cuenta como fallo. La fuente no da resultados medidos, más allá de una demostración que va del arranque a una carrera.

Conviene saber

Las capturas y los flujos necesitan una ventana de juego real. Si falta la escena de depuración, el agente responde NEED_SETUP y se detiene, y no la crea él.

Qué necesitas

• Un proyecto de Godot 4
• Cursor, el editor de código con agentes de IA
• El complemento, las habilidades, el comando y el subagente que ofrece el enlace de la ficha, una página de GitHub donde se guarda el código
• Una ventana de juego real, porque las capturas no funcionan sin pantalla

Cómo hacerlo tú, paso a paso

1. Instala en tu proyecto de Godot el complemento, las habilidades, el comando y el subagente del enlace de la ficha.
2. Comprueba que tu proyecto tiene la escena de depuración que pide el complemento. Si falta, el agente responde NEED_SETUP y se detiene, sin crearla él.
3. Da al subagente probador una parte del juego, con criterios, una escena y una acción.
4. Deja que revise los nombres únicos de los nodos (los elementos de la escena) y el mapa de controles, escriba un flujo en JSON, un archivo de datos ordenado, dentro de res://agent/ y lo ejecute.
5. Mira el resultado: cada ejecución termina en AGENT_OK o AGENT_FAIL.
6. Revisa las capturas, que quedan en la carpeta out/.
7. Corrige lo que falle y vuelve a lanzar la prueba.

Prepara un agente que pueda lanzar mi juego de Godot 4, hacer capturas de pantalla y recorrer los flujos principales de la interfaz como lo haría un jugador. Hazle informar de cualquier botón roto, callejón sin salida o fallo visual que encuentre. Habrás terminado cuando tenga un informe con cada problema y cómo reproducirlo.

Consejos

• Ejecuta las pruebas con el juego abierto en una ventana real. Sin ventana no hay capturas.
• Un error de programación o un control sin asignar cuenta como fallo, así que revisa también tus controles.
• Empieza por un flujo corto, como el arranque, y añade más cuando funcione.

Preguntas frecuentes

Fuentes

• Joelnicolass/godot-studio-playtest en GitHub ↗

En el directorio desde el 3 de octubre de 2026.