# Probar un juego de Godot 4 con un agente de Cursor

> Un complemento y un subagente de Cursor permiten que un agente haga capturas y recorra la interfaz de un juego de Godot 4 como un jugador.

- **Tipo:** Caso de uso
- **Tema:** Programación
- **Herramientas:** Cursor
- **Dificultad:** avanzada
- **Origen:** [Joelnicolass/godot-studio-playtest en GitHub](https://github.com/Joelnicolass/godot-studio-playtest)
- **En el directorio desde:** 3 de octubre de 2026
- **URL:** https://conqueia.com/caso/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.

## Pruébalo con Cursor

```
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

### ¿Sirve para otros motores de juego?

El complemento es para Godot 4. La idea de fondo es la misma, pero en otro motor habría que preparar uno equivalente.

### ¿Qué significa AGENT_FAIL?

Que la prueba ha fallado: un error de programación, un control sin asignar o una comprobación que no se cumple cuentan como fallo.

## Fuentes

- [Joelnicolass/godot-studio-playtest en GitHub](https://github.com/Joelnicolass/godot-studio-playtest)

---

Fuente: conqueia.com/caso/probar-un-juego-de-godot-4-con-un-agente-de-cursor