# Proyectos y motores — App y CLI de AI Game Dev · AI Game Developer Wiki

Abre o crea un proyecto de Unity, Unreal o Godot en la app AI Game Dev, instala el plugin del motor y deja que el agente abra el editor cuando haga falta.

Esta página se tradujo automáticamente del inglés. [Lee el original en inglés](https://ai-game.dev/docs/wiki/app/projects-and-engines).

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

| Motor | Plugin | Cómo reconoce la app el proyecto | Versiones compatibles |
| --- | --- | --- | --- |
| Unity | [Unity MCP](https://ai-game.dev/es/docs/wiki/unity) | `ProjectSettings/ProjectVersion.txt`, o una carpeta `Assets/` con `Packages/manifest.json` | Unity 2022.3 LTS o posterior |
| Unreal Engine | [Unreal MCP](https://ai-game.dev/es/docs/wiki/unreal) | Un archivo `*.uproject` en la carpeta | Unreal Engine 5.5 o posterior, proyectos en C++ |
| Godot | [Godot MCP](https://ai-game.dev/es/docs/wiki/godot) | Un archivo `project.godot` en la carpeta | Godot 4.3 a 4.5 (.NET) |

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:

```text
/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](https://ai-game.dev/docs/extensions) 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:

```text
/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.

**Consejo**

Abrir el editor antes de empezar una sesión larga te ahorra la espera de arranque en el primer paso del motor.

## 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](https://ai-game.dev/es/docs/wiki/unity/installation), [conectar clientes de IA](https://ai-game.dev/es/docs/wiki/unity/connecting-ai-clients), [`unity-mcp-cli`](https://ai-game.dev/es/docs/wiki/unity/cli).
- Unreal: [instalación](https://ai-game.dev/es/docs/wiki/unreal/installation), [conectar clientes de IA](https://ai-game.dev/es/docs/wiki/unreal/connecting-ai-clients), [`unreal-mcp-cli`](https://ai-game.dev/es/docs/wiki/unreal/cli).
- Godot: [instalación](https://ai-game.dev/es/docs/wiki/godot/installation), [conectar clientes de IA](https://ai-game.dev/es/docs/wiki/godot/connecting-ai-clients), [`godot-cli`](https://ai-game.dev/es/docs/wiki/godot/cli).

## Abrir un proyecto en la CLI

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

```bash
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](https://ai-game.dev/docs/tools) lista todas las herramientas de motor, y las [buenas prácticas](https://ai-game.dev/docs/best-practices) explican cómo escribir peticiones que funcionen. Las páginas de motor de [Unity](https://ai-game.dev/es/engines/unity), [Unreal](https://ai-game.dev/es/engines/unreal) y [Godot](https://ai-game.dev/es/engines/godot) resumen cada integración.

---

Source (HTML): https://ai-game.dev/es/docs/wiki/app/projects-and-engines

Machine-translated (es) from the English page: https://ai-game.dev/docs/wiki/app/projects-and-engines