Proyectos y motores

Todo en la app AI Game Dev ocurre dentro de un proyecto: una carpeta en tu ordenador. Cuando la carpeta es un proyecto de Unity, Unreal Engine o Godot, la app detecta el motor, configura el plugin MCP correspondiente y conecta las herramientas del editor a tu chat. Esta página cubre cómo abrir y crear proyectos en la app de escritorio y en la CLI, la instalación y actualización del plugin, y cómo trabaja el agente con el editor.

Motores compatibles#

También puedes abrir cualquier otra carpeta, como un proyecto de solo assets de Blender, una carpeta de documentos de diseño o un repositorio de herramientas. El agente podrá entonces trabajar con archivos, paquetes y herramientas, aunque sin las herramientas del motor.

Abrir un proyecto en la app de escritorio#

Una ventana vacía es un lanzador. Ofrece:

• Open folder… para elegir una carpeta de proyecto.
• Create new project para empezar un nuevo proyecto de Unity, Unreal o Godot.
• Tus proyectos recientes.

Cada proyecto vive en su propia ventana. Haz Ctrl-clic (Windows, Linux) o Cmd-clic (macOS) en un proyecto reciente para abrirlo en una ventana nueva en lugar de reemplazar la actual. Cuando vuelvas a iniciar la app, todas las ventanas de proyecto que estaban abiertas reaparecen con su tamaño, posición y distribución.

Instalar o actualizar el plugin del motor#

Después de abrir un proyecto de motor, la barra lateral muestra el motor del proyecto y sus acciones:

• Install Package cuando el plugin del motor todavía no está en el proyecto, o Update Package cuando hay disponible una versión más reciente del plugin.
• Open Editor para iniciar el editor del motor para este proyecto.

Haz clic en Install Package para añadir el plugin. La app nunca modifica un proyecto existente por su cuenta: el clic es tu consentimiento, porque la instalación escribe en tu proyecto (para Unity, por ejemplo, añade el paquete a Packages/manifest.json). Cuando un proyecto se crea desde la app, el plugin se instala automáticamente como parte de la creación.

Los instaladores de plugins vienen incluidos en la app: no necesitas Node.js, npm, unity-mcp-cli, unreal-mcp-cli ni godot-cli en tu máquina.

En la CLI las mismas acciones son comandos de barra:

/install-plugin            install the MCP plugin into the current project
/install-plugin C:/Games/MyGame
/open                      open the editor for the current project

Extensiones de motor#

Las extensiones de motor añaden más herramientas a un plugin, por ejemplo herramientas extra de Unity para sistemas de partículas o animación. Examínalas e instálalas desde la acción de extensiones de la barra lateral en la app de escritorio, o con /install-extension en la CLI. La página de extensiones lista lo que hay disponible para cada motor.

Crear un proyecto nuevo#

En la app de escritorio, elige Create new project:

1. Elige el motor.
2. Introduce un nombre de proyecto. El proyecto se crea en una subcarpeta con ese nombre dentro de la carpeta padre que elijas; las carpetas que falten se crean.
3. Elige el editor: se preselecciona la versión instalada más reciente, o elige manualmente un editor instalado. Si no hay instalado ningún editor para ese motor, la app lo indica; instala primero el motor y luego continúa.
4. La app crea el proyecto, instala el plugin y lo abre.

En la CLI:

/create-project unity SkywardKeep
/create-project godot SkywardKeep D:/Games

La sintaxis es /create-project <unity|godot|unreal> <name> [parentDir].

Cómo trabaja el agente con el editor#

Puedes empezar a chatear antes de que el editor esté en marcha. Una conversación normal nunca lanza nada. Cuando el agente necesita el editor para una tarea, pide a la app que abra el editor del proyecto, espera hasta que las herramientas del editor estén disponibles y luego continúa la misma tarea. Un editor que se conecta más tarde en una sesión, por ejemplo porque lo abriste tú mismo, se conecta al chat en curso sin iniciar uno nuevo.

Algunas reglas hacen que esto sea predecible:

• Solo se inicia un editor por proyecto, aunque varias sesiones lo necesiten al mismo tiempo.
• Una llamada al motor que ya se envió nunca se reproduce automáticamente tras una desconexión; el agente comprueba el resultado antes de intentar otra escritura.
• Stop cancela una espera del editor. Un editor que ya se ha iniciado permanece abierto.
• Iniciar un proyecto grande puede tardar un rato. A un lanzamiento se le conceden hasta 15 minutos y luego hasta 2 minutos más para que aparezcan las herramientas.

Dentro del editor#

Cada plugin tiene su propia ventana en el editor (para Unity, la ventana AI Game Developer) con el estado de la conexión. Cuando la app abre el editor, le pasa tu sesión iniciada, así que el plugin se conecta a través de ai-game.dev sin necesidad de un token manual. Si el editor muestra "Disconnected", abre esa ventana, elige Cloud y haz clic en Authorize, y luego espera a Ready.

Los ajustes específicos de cada plugin, la instalación manual y la conexión de otros clientes de IA se tratan en la wiki de cada motor:

• Unity: instalación, conectar clientes de IA, unity-mcp-cli.
• Unreal: instalación, conectar clientes de IA, unreal-mcp-cli.
• Godot: instalación, conectar clientes de IA, godot-cli.

Abrir un proyecto en la CLI#

La CLI trabaja en el directorio actual, o en una carpeta que indiques:

cd /path/to/your/game
gamedev

# or
gamedev /path/to/your/game
gamedev --project /path/to/your/game

Al iniciarse, la CLI indica lo que detectó, por ejemplo "Unity project detected", o que la carpeta no tiene ningún proyecto de Unity, Godot o Unreal.

Qué puede hacer el agente en tu proyecto#

Con un motor conectado, pregunta en lenguaje natural, por ejemplo:

• "Lista todo lo que hay en la escena activa."
• "Crea un cubo en el origen y dale un cuerpo físico."
• "Haz una captura de pantalla de la vista actual."

El catálogo de herramientas lista todas las herramientas de motor, y las buenas prácticas explican cómo escribir peticiones que funcionen. Las páginas de motor de Unity, Unreal y Godot resumen cada integración.