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

Qué paquetes hay en la app AI Game Dev, cómo instalarlos, actualizarlos, excluirlos y quitarlos con gamedev pkg o la ventana Packages, y los niveles.

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

Los paquetes amplían la app AI Game Dev con capacidades completas: Blender, música con SuperCollider, una base de conocimiento del proyecto, generación 3D con Tripo, modelos locales de imagen y vídeo, modelos en la nube de vídeo y audio, y cualquier cosa que un equipo construya para sí mismo. Esta página explica qué es un paquete, qué paquetes vienen con la app y cómo gestionarlos en la ventana Packages de escritorio y con el comando `gamedev pkg`.

## Qué es un paquete

Un paquete es una carpeta con un manifiesto, `aigd-package.json`, y opcionalmente algo de JavaScript. El modelo es el mismo que el de las extensiones de VS Code: todo lo que muestra un paquete se declara en su manifiesto y es visible antes de que se ejecute su código, y el código solo arranca cuando algo lo necesita.

Un paquete puede aportar:

- **Herramientas de sesión** en la fila Tools, a menudo respaldadas por un servidor MCP, para que el agente obtenga nuevas herramientas.
- **Comandos de barra** como `/blender` o `/kb`, que funcionan en el chat de escritorio y en la CLI.
- **Comandos** para la paleta de comandos, **menús** y botones de la barra de herramientas del compositor, elementos de la **barra de estado**.
- **Paneles**, **vistas** del panel lateral, ventanas propias y **editores personalizados** o vistas previas para tipos de archivo.
- **Ajustes**, **tutoriales** breves dentro de la app y **dependencias** de otros paquetes o plugins de Claude.
- Datos puros: los modelos locales de imagen y vídeo son paquetes sin código, que declaran sus archivos, tamaño de descarga, licencia y el hardware para el que sirven.

Cada paquete tiene un id con la forma `publisher.name`. Los paquetes de primera parte usan el publisher `aigd`, por ejemplo `aigd.blender`.

## Paquetes, plugins de Claude, servidores MCP y extensiones de motor

La app tiene cuatro tipos de extensión. Todos acaban siendo herramientas que el agente puede usar, pero se gestionan en lugares distintos:

| Tipo | Qué amplía | Dónde se gestiona |
| --- | --- | --- |
| Paquete | La propia app: herramientas, comandos, paneles, editores, modelos | Ventana Packages, `/packages`, `gamedev pkg` |
| Plugin de Claude | El agente Claude: skills, comandos, agentes, servidores MCP de plugins | **Settings**, **Claude Plugins** o `/plugin` |
| Servidor MCP | Herramientas de cualquier servidor MCP, local o remoto, para el proyecto actual | **Settings**, **MCP servers** o `/mcp` |
| Extensión de motor | Más herramientas dentro del plugin de Unity, Unreal o Godot | Acción de extensiones de la barra lateral, o `/install-extension` (ver [extensiones](https://ai-game.dev/docs/extensions)) |

Un servidor MCP que añadas en Settings pertenece al proyecto que estaba abierto cuando lo añadiste y nunca es visible en otros proyectos. Un plugin o servidor MCP nuevo se aplica al chat que ya está abierto a partir de su siguiente mensaje.

## Paquetes que vienen con la app

En el primer arranque, la app instala sus paquetes predeterminados por ti, en el nivel de usuario, para que estén disponibles en todos los proyectos:

| Paquete | Qué añade |
| --- | --- |
| `aigd.blender` | Blender: el agente construye y edita modelos 3D en un Blender real |
| `aigd.supercollider` | Música: compón, renderiza y exporta música de juego con SuperCollider |
| `aigd.knowledge` | Knowledge Base: notas Markdown en el proyecto que el agente lee y actualiza |
| `aigd.tripo` | Tripo: herramientas de 3D, textura, malla, rig y animación |
| `aigd.sdcpp` | Generación local de imagen y vídeo con stable-diffusion.cpp |

Un paquete predeterminado que elimines nunca se vuelve a añadir. Instalar un paquete no significa que todos los chats lo lleven: activas sus herramientas por sesión en la fila Tools. Los modelos locales de imagen y vídeo, y las familias de modelos en la nube, son paquetes separados; consulta el [catálogo de paquetes](https://ai-game.dev/es/docs/wiki/app/packages-catalog) para verlos todos.

## La ventana Packages

Ábrela desde el icono de paquetes de la barra de estado, en la esquina inferior derecha de la ventana ("Open Packages"). Muestra el proyecto y sus niveles arriba, y estas pestañas:

- **Installed**: los paquetes activos en este proyecto, con su estado, versión y nivel.
- **Browse**: busca en el registro de paquetes de AI Game Dev.
- **Claude plugins**: los plugins de Claude que los paquetes requieren para este proyecto.
- **Models**: los modelos locales de imagen y vídeo que puedes descargar, que se muestran cuando el proyecto tiene el runtime de generación.

La cabecera tiene **Check for updates** y **Reload**, que reinicia los paquetes del proyecto. Selecciona un paquete para ver sus detalles, niveles, ajustes y errores.

## Instalar un paquete

### En la app de escritorio

1. Abre la ventana Packages y selecciona **Browse**.
2. Busca, por ejemplo `hello`, y selecciona el paquete.
3. Debajo del botón de añadir, elige el nivel: **User**, **Project** o **Local** (ver [niveles](https://ai-game.dev/es/docs/wiki/app/packages#levels)).
4. Haz clic en **Add to Project** (o **Add to User**, **Add to Local**).

Para añadir un paquete de fuera del registro, escribe en el cuadro de añadir. Acepta un id del registro (`aigd.blender`, opcionalmente con un rango de versiones como `aigd.blender@^1.2`), un enlace de GitHub o `owner/repo`, un paquete de npm (`npm:<name>` o su enlace de npmjs.com) o una ruta de carpeta.

### En la CLI

Ejecuta `gamedev pkg` en la carpeta del proyecto (o pasa `--cwd <path>`), o usa `/packages` en la CLI interactiva. El nivel predeterminado es `--project`.

```bash
gamedev pkg list                          # the packages in effect for this project
gamedev pkg list --user                   # the user level alone
gamedev pkg add aigd.blender --user       # from the registry, for every project
gamedev pkg add github:owner/repo         # from GitHub, for this project
gamedev pkg add npm:some-package --local  # from npm, this machine only
```

Un paquete del registro añadido sin rango se escribe como `^<installed version>`, así recibe actualizaciones compatibles.

## Niveles: user, project, local

Los paquetes y sus ajustes se declaran en tres niveles. Un nivel superior anula a uno inferior: local gana a project, y project gana a user.

| Nivel | Se aplica a | Se declara en | Confirmado en Git |
| --- | --- | --- | --- |
| User | Todos los proyectos de este ordenador | `~/.ai-game-dev/packages.json` | No |
| Project | Todos los que abran el proyecto | `<project>/.ai-game-dev/packages.json` | Sí |
| Local | Solo este proyecto en este ordenador | `<project>/.ai-game-dev/packages.local.json` | No (la app lo añade a `.ai-game-dev/.gitignore`) |

Cada nivel tiene también un archivo de bloqueo junto a él (`packages-lock.json`, `packages-lock.local.json`) que fija las versiones exactas, para que los compañeros que comparten el bloqueo del proyecto instalen exactamente los mismos bytes.

Usa **Project** para los paquetes que necesita todo el equipo, **User** para tus herramientas personales y **Local** para elecciones específicas de la máquina, como la ruta a una herramienta instalada en tu ordenador.

## Excluir un paquete en un proyecto

Para desactivar un paquete de nivel de usuario en un proyecto, selecciónalo y elige **Exclude** en la fila del nivel, o:

```bash
gamedev pkg exclude aigd.blender            # off in this project (written to the project file)
gamedev pkg include aigd.blender            # undo
```

El archivo del proyecto contendrá entonces `"aigd.blender": false`; los demás proyectos no se ven afectados.

## Actualizar paquetes

Las actualizaciones automáticas están activadas de forma predeterminada. La app comprueba poco después del arranque, cada cuatro horas y al hacer clic en **Check for updates**. Instala la versión más reciente dentro del rango que declara cada nivel y que sea compatible con tu app, y muestra una notificación por ejecución, como "Actualizando 1 paquete… (1/1)" seguida de "1 paquete actualizado".

- Desactiva las actualizaciones automáticas de un paquete con su interruptor **Auto-update** en la ventana Packages, o con `gamedev pkg auto-update off <id>`. La elección es por ordenador.
- Actualiza ahora con `gamedev pkg update` (todos) o `gamedev pkg update <id>`.
- Los paquetes de una carpeta local, y las fuentes de GitHub fijadas a una etiqueta, nunca se actualizan automáticamente.

Un paquete que necesita una app más nueva lo dice ("requiere AI Game Dev >=X, tienes Y"); actualiza primero la app.

## Quitar un paquete

Selecciónalo y elige **Remove**, o:

```bash
gamedev pkg remove <id>              # remove it from the project level
gamedev pkg remove <id> --user       # remove it from the user level
```

Un paquete instalado solo como dependencia de otro no tiene Remove, solo Exclude; desaparece por sí solo cuando nada lo necesita.

## Ajustes de los paquetes

Selecciona un paquete y abre **Settings**. Junto a cada ajuste eliges el nivel en el que se escribe; la etiqueta muestra de dónde viene el valor actual. Algunos ajustes son selectores de carpeta con **Browse…** y una comprobación de espacio libre; otros ofrecen opciones que vienen de la app.

En la CLI:

```bash
gamedev pkg settings aigd.blender                 # every key, its value and level
gamedev pkg settings <id> <key> <value> --local   # write a value at a level
gamedev pkg settings <id> <key> --unset --project # clear the value at a level
```

Un valor se comprueba contra su tipo declarado antes de guardarse; un valor rechazado no cambia nada y sale con el código 1.

## Dependencias

Un paquete puede depender de otros paquetes y de plugins de Claude. La app los instala por ti y mantiene una versión de cada paquete por proyecto. La ventana Packages lista una dependencia como "instalado para `<id>`" con su nivel. Los plugins de Claude que necesita un paquete se instalan por proyecto en una caché propiedad de la app y se cargan solo en las sesiones de ese proyecto, nunca en tu propio Claude Code.

## Seguridad y errores

Los paquetes se ejecutan con los permisos de tu usuario, igual que las extensiones de VS Code: no hay sandbox. Instala paquetes solo de fuentes de confianza. Los paquetes del registro de AI Game Dev se verifican contra sus sumas de comprobación publicadas antes de descomprimirse.

Si un paquete falla, su tarjeta muestra un recuento de advertencias y su pestaña **Errors** lista los detalles. Los errores de paquetes de terceros nunca se envían a ningún sitio; los errores de paquetes `aigd` de primera parte de nuestro registro se nos notifican solo con tu consentimiento para los informes de fallos. Los paquetes instalados arrancan sin conexión a la red.

## Siguientes pasos

- Consulta todos los paquetes disponibles en el [catálogo de paquetes](https://ai-game.dev/es/docs/wiki/app/packages-catalog).
- Crea el tuyo en [Creación de paquetes](https://ai-game.dev/es/docs/wiki/app/creating-packages).
- La entrada [paquetes, plugins de Claude y servidores MCP](https://ai-game.dev/es/blog/ai-game-dev-packages-plugins-mcp) muestra la ventana Packages y un servidor MCP de proyecto en acción.

---

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

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