Paquetes

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:

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:

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 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).
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.

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.

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:

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:

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:

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.
• Crea el tuyo en Creación de paquetes.
• La entrada paquetes, plugins de Claude y servidores MCP muestra la ventana Packages y un servidor MCP de proyecto en acción.