Esta página se tradujo automáticamente del inglés. Lee el original en inglés.

Publicar paquetes

Publica un paquete en el registro comunitario de AI Game Developer: publisher, subida, notas, canales beta, deprecación, yanking y otras fuentes.

Actualizado el 19 de noviembre de 2026 Ver como Markdown

El registro comunitario es donde los usuarios encuentran e instalan paquetes por id: gamedev pkg add acme.level-tools, o Browse en la ventana Packages, con actualizaciones automáticas y valoraciones de 1 a 5 estrellas. Cualquier cuenta registrada en ai-game.dev puede publicar, los paquetes son gratuitos y cada versión pasa comprobaciones automáticas en lugar de una revisión manual. Esta página cubre todo el recorrido: tu publisher, la primera subida, las notas de versión, los canales de versiones preliminares, la deprecación, el yanking y las demás formas de compartir un paquete.

El catálogo de paquetes en ai-game.dev: un paquete de motor destacado, filtros de categoría y filas de paquetes oficiales y de la comunidad
El catálogo de paquetes: paquetes oficiales y paquetes de la comunidad, cada uno con su comando de instalación.

Reclama un publisher

Tu id de publisher es la primera mitad de cada id de paquete que publicas (acme en acme.level-tools). Reclámalo una vez; es por orden de llegada:

gamedev login
gamedev pkg publisher claim acme --name "Acme Tools"

Un id de publisher tiene de 2 a 40 letras minúsculas, dígitos y guiones simples. El id propio de AI Game Dev (aigd), los nombres de motores (unity, godot, unreal, brutal, bevy, threejs), las marcas registradas y los nombres parecidos como un1ty o unity-tools están reservados. Una cuenta necesita un correo verificado y puede tener hasta 3 publishers.

La cuenta que reclama un publisher es su propietario. Un propietario puede añadir mantenedores por correo electrónico; los mantenedores pueden subir, retirar (yank), deprecar, editar notas de versión, mover canales y emitir tokens. Solo un propietario gestiona miembros y publishers de confianza.

Publica una versión

Pon "publisher": "acme" en aigd-package.json, incrementa version, compila y después:

gamedev pkg publish level-tools

La CLI empaqueta la carpeta (las mismas comprobaciones y los mismos bytes que gamedev pkg pack), la sube y espera a las comprobaciones. Una versión pasa por estos estados:

EstadoSignificado
uploaded, checkingEsperando o ejecutando las comprobaciones automáticas
publishedHa pasado todas las comprobaciones; está en el índice firmado en aproximadamente un minuto
rejectedHa fallado una comprobación; el informe indica cada fallo. Corrígelo y vuelve a subir la misma versión
yankedRetirada por su publisher: los rangos la omiten, las instalaciones existentes la conservan
revokedEliminada por AI Game Dev (malware, una cuenta robada): todas las aplicaciones la desactivan

Las versiones son inmutables. Un número de versión publicado, retirado (yanked) o revocado nunca se puede volver a subir; solo uno rechazado. Publica la corrección como una versión nueva.

La página de un paquete en el catálogo: nombre, publisher, versión, botón y comando de instalación, previsualizaciones de starters, un panel About y la última versión publicada
La página de un paquete de la comunidad en el catálogo. Los usuarios lo instalan con un clic o un comando.

Notas de versión

Cada versión puede incluir notas de versión en Markdown. Los usuarios las ven por versión en la ventana Packages (Versions) y en el panel del publisher. Indícalas al subir:

gamedev pkg publish level-tools --notes RELEASE_NOTES.md

Sin --notes, el registro toma la sección de tu CHANGELOG.md (en la carpeta del paquete, incluida en el archivo) desde el encabezado de la versión (## 1.2.0, ## [1.2.0] o ## v1.2.0) hasta el siguiente encabezado del mismo nivel o uno superior, recortada a 20 KB:

# Changelog

## [1.2.0]

- Export levels as glTF.
- Fix the collectible count in nested scenes.

Las notas son como máximo 20 KB de Markdown, se sanean como un README y se comprueban en busca de inyección de prompts como cualquier otro texto de un paquete. Un miembro puede editarlas después en el panel del publisher. El índice firmado incluye los primeros 4 KB, con un enlace al resto.

Canales: latest, beta y otros

Un canal (una dist-tag) nombra la versión que reciben los usuarios cuando la piden por nombre:

gamedev pkg add acme.level-tools          # the latest channel
gamedev pkg add acme.level-tools@beta     # whatever beta points to
  • Una versión preliminar (1.3.0-beta.1) nunca se instala por defecto: latest es la versión estable publicada más alta a menos que la establezcas tú, y nunca puede apuntar a una versión preliminar.
  • Los demás canales los nombras tú (beta, next, nightly): en minúsculas, empezando por una letra y con un máximo de 16 caracteres. Un paquete tiene como máximo 5 canales, latest incluido.
  • Una versión retirada (yanked) o revocada no se puede etiquetar; un canal que apunta a una versión que se retira se elimina.
  • Publica una versión preliminar como versión preliminar de semver (1.3.0-beta.2). Una versión preliminar llamada alpha, beta, rc, next, preview, canary, nightly, dev o experimental mueve ese canal a sí misma automáticamente, a menos que un miembro haya establecido el canal a mano; cualquier canal también se puede mover en el panel del publisher (Channels).
  • gamedev pkg add acme.level-tools@beta escribe el canal en packages.json, { "source": "^1.3.0-beta.1", "channel": "beta" }. Quien prueba obtiene la versión del canal mientras sea más nueva que la última estable, y pasa a la versión estable en cuanto se publica, en su siguiente actualización.

Deprecar un paquete o una versión

La deprecación avisa a los usuarios de que deben migrar sin romper nada de lo que ya está instalado:

  • Un paquete: un mensaje (de hasta 300 caracteres) y, opcionalmente, el id de un paquete de reemplazo. La app y la CLI muestran el mensaje y el reemplazo; las copias instaladas siguen funcionando y el paquete todavía se puede añadir.
  • Una versión: un mensaje como «pérdida de datos al exportar escenas anidadas, actualiza a 1.2.1».

Al elegir una versión, la app prefiere una que no esté deprecada. Ambos tipos son reversibles y quedan registrados en el log de auditoría del registro. Se configuran en el panel del publicador.

Retirar y revocar

Retira una versión que publicaste por error: a partir de entonces los rangos de versiones la omiten, y las instalaciones que ya la tienen la conservan. La retirada es reversible y un token de publicador puede retirar versiones. La revocación es el interruptor de emergencia de AI Game Dev para una versión maliciosa o robada: sale del índice y todas las apps que la tienen la desactivan en su siguiente lectura del índice.

Publicar desde CI

Dos formas, ambas mostradas en Trusted Publishing:

  • Trusted Publishing (recomendado): GitHub Actions o GitLab CI demuestran qué repositorio y qué workflow están publicando; no se guarda ningún secreto en ningún sitio y cada versión registra su procedencia. Allí se describen una GitHub Action y una plantilla de GitLab CI listas para usar, IvanMurzak/gamedev-publish-action.
  • Un token de publicador: gamedev pkg publisher token create acme --label ci --days 90, guardado como secreto de CI y pasado como AI_GAME_DEV_PUBLISHER_TOKEN.

El panel del publicador

Todo lo que un publicador gestiona después de la primera subida está en el panel del publicador en ai-game.dev/publisher, para propietarios y mantenedores con la sesión iniciada: tus publicadores y paquetes, cada versión con su estado y su informe de comprobaciones, notas de la versión, canales, deprecación y retirada, miembros y roles, tokens de publicador, y publicadores de confianza con fragmentos de workflow que puedes copiar. Consulta Reglas y comprobaciones del registro.

Otras fuentes: GitHub, npm y carpetas

El registro no es la única forma de compartir un paquete. Estas fuentes se instalan sin las comprobaciones del registro, así que ejecuta gamedev pkg validate tú mismo, y son la forma de compartir un paquete que usa API propuesta:

gamedev pkg add github:acme/level-tools           # the default branch: moves with each push
gamedev pkg add github:acme/level-tools@v1.2.0    # a tag: pinned, never auto-updated
gamedev pkg add npm:acme-level-tools@^1.2.0       # an npm package and range
gamedev pkg add file:../level-tools               # a folder
  • GitHub: con un tag, la app descarga un asset de la release cuyo nombre acaba en .aigd.tgz (adjunta el archivo que escribió gamedev pkg pack); si no, el repositorio en ese commit, así que aigd-package.json debe estar en la raíz y dist/ debe estar commiteado.
  • npm: publica la carpeta del paquete con npm publish. El archivo de npm debe contener aigd-package.json y dist/; añade también "engines": { "aigd": "<range>" } a package.json, para que la app se salte las versiones que no puede ejecutar sin descargarlas.
  • Equipos: añade el paquete a nivel de Project para que quede commiteado en .ai-game-dev/packages.json y cada compañero de equipo obtenga la misma versión, fijada por el archivo de lock del proyecto.