# Blender

> Crea y edita modelos 3D en un Blender real desde el chat: busca o instala Blender, instala el complemento MCP for Blender y lo conecta al agente por proyecto. Crea props, blockouts y assets low-poly, expórtalos a tu proyecto de Unity, Godot o Unreal y previsualízalos.

- Id: `aigd.blender`
- Origen: Oficial (propio `aigd.*`)
- Categoría: 3D
- Editor: AI Game Dev (`aigd`), verificado
- Última versión: 1.2.16 (publicado el 2026-11-22)
- Licencia: Apache-2.0
- Requiere la app AI Game Dev: `>=0.25.11`
- Código nativo: no
- Valoración: aún sin valoraciones
- Página HTML: https://ai-game.dev/es/packages/aigd.blender

## Instalar

Con la CLI gamedev, en la carpeta del proyecto:

```bash
gamedev pkg add aigd.blender
```

En la app de escritorio: abre la ventana Packages (el icono de paquete en la barra de estado), selecciona **Browse**, busca `aigd.blender` y haz clic en **Add to Project**. Más: https://ai-game.dev/docs/wiki/app/packages

## Versiones

| Versión | Publicado | Requiere app | Notas |
|---|---|---|---|
| 1.2.16 | 2026-11-22 | `>=0.25.11` | la más reciente |
| 1.2.15 | 2026-11-19 | `>=0.25.11` | - |
| 1.2.14 | 2026-11-13 | `>=0.25.11` | - |
| 1.2.13 | 2026-11-13 | `>=0.25.11` | - |
| 1.2.11 | 2026-11-06 | `>=0.25.11` | - |
| 1.2.10 | 2026-11-01 | `>=0.25.11` | - |
| 1.2.4 | 2026-10-15 | `>=0.18.0` | - |
| 1.2.3 | 2026-10-13 | `>=0.18.0` | - |
| 1.2.2 | 2026-09-30 | `>=0.18.0` | - |

## Descripción

````markdown
# Blender (`aigd.blender`)

Conecta un Blender real al agente de AI Game Dev, para que puedas crear y editar modelos 3D pidiéndolo en el chat. El paquete encuentra Blender en tu ordenador o instala una copia portátil, instala el complemento MCP for Blender y lo conecta al agente para el proyecto actual. Está pensado para desarrolladores de juegos que quieren crear props, blockouts, assets low-poly y ediciones de escena en Blender y guardarlos directamente en su proyecto de Unity, Godot o Unreal.

## Qué puedes hacer

- Pide un modelo 3D y deja que el agente lo cree en Blender, lo exporte a tu proyecto y lo muestre en la vista previa de la app.
- Crea, modifica y elimina objetos, y aplica materiales y colores, en una escena de Blender.
- Deja que el agente inspeccione la escena actual y ejecute código Python dentro de Blender para hacer lo que necesite una petición.
- Abre un archivo `.blend` existente y sigue trabajando en él con el agente.
- Cierra Blender en cualquier momento: la siguiente petición que lo necesite volverá a iniciar Blender.

## Peticiones de ejemplo

- "Usando Blender, modela un cofre del tesoro low-poly con cuerpo de madera, bandas de metal oscuro y un pequeño candado dorado, expórtalo como .glb al proyecto y muéstralo en la vista previa."
- "Abre `Art/level-01.blend` y añade seis cajas y dos barriles cerca de la puerta."
- "Haz un blockout sencillo de una casa de dos plantas para mi nivel, de unos 8 por 6 metros."
- "Dale a cada roca de la escena un material verde con musgo."

## Cómo funciona

Ejecuta `/blender` en un chat una vez por proyecto; después, podrás activar **Blender** para un chat desde el botón Herramientas. Configuración:

1. Busca Blender en este ordenador: `BLENDER_BIN`, las descargas de la propia app, `PATH`, bibliotecas de Steam y las ubicaciones de instalación habituales de cada sistema operativo (Program Files, el alias de Microsoft Store y el registro en Windows; `/Applications` y Spotlight en macOS; `/usr/bin`, snap, flatpak y `/opt` en Linux). Cada candidato se comprueba con `blender --version`. Se necesita Blender 4.2 LTS o posterior.
2. Si ninguno sirve, descarga un Blender portátil (5.2.2; 4.5.14 en Macs con Intel, porque Blender 5.x solo se distribuye para macOS en Apple silicon), verificado con un SHA-256 fijado.
3. Descarga [uv](https://github.com/astral-sh/uv) 0.12.19 (SHA-256 fijado), que trae su propio Python, así que no necesitas Python en el sistema.
4. Instala el complemento de [MCP for Blender](https://github.com/ahujasid/blender-mcp) (`mcp-for-blender` 2.0.4, MIT): el servidor MCP y el complemento vienen de una única versión fijada.
5. Registra el servidor MCP de `blender` solo para el proyecto actual (Blender se conecta por proyecto) y luego abre Blender detrás de tu ventana para que no te quite el foco.

El complemento escucha en el puerto 9876 de tu ordenador. El MCP for Blender original incluye comunicación bidireccional, manipulación de objetos, control de materiales, inspección de escenas y ejecución de código Python, además de las integraciones de assets y modelos descritas en su propia documentación.

### El comando `/blender`

| Comando | Qué hace |
|---|---|
| `/blender` | Configura y abre Blender (busca o instala Blender, instala el complemento y lo conecta). |
| `/blender setup [options]` | Configura sin abrir Blender. `--blender <path>` usa un Blender que elijas tú; `--reinstall` reinstala el complemento; `--no-download` nunca descarga Blender; `--safe` restringe el Python del agente en Blender a un subconjunto seguro. |
| `/blender open [file.blend]` | Abre Blender, opcionalmente con un archivo `.blend`. |
| `/blender status` | Qué está configurado y si Blender está conectado. |
| `/blender find` | Enumera todos los Blender de este ordenador. |
| `/blender remove [--addon] [--files] [--all]` | Desconecta Blender del agente; `--addon` también elimina el complemento de Blender, `--files` borra lo que descargó la app y `--all` hace ambas cosas. |

La app de escritorio también muestra dos consejos: uno para activar Blender desde el botón Herramientas en un proyecto 3D, y «Blender está listo» con un prompt de ejemplo ya preparado (un cofre del tesoro low-poly).

## Requisitos

- Blender 4.2 LTS o posterior, o deja que la app descargue un Blender portátil (Windows x64 y arm64, macOS en Apple silicon e Intel, Linux x64; Linux arm64 no tiene compilación oficial de Blender).
- Un proyecto abierto: Blender se conecta al agente por proyecto.
- AI Game Dev 0.25.11 o posterior.

## Licencia

Este paquete: Apache-2.0. MCP for Blender (`mcp-for-blender`): MIT. Blender es software libre de la Blender Foundation bajo la GNU GPL. El avatar del paquete es el icono oficial de Blender; la marca Blender pertenece a la Blender Foundation. Esta es una integración de terceros, no realizada por la Blender Foundation.
````
