Solución de problemas
Arregla problemas de AI Game Dev y la CLI gamedev: inicio de sesión, modelos, conexión con el editor, paquetes y generación local y en la nube.
Esta página recoge los problemas que con más frecuencia encuentran los usuarios de la app AI Game Dev y de la CLI gamedev, junto con la causa probable y la solución. Busca el síntoma en su área: inicio de sesión, modelos, conexión con el motor, paquetes, modelos locales, generación en la nube o la CLI.
Inicio de sesión
La ventana del navegador para iniciar sesión no se abre. No hay ningún navegador predeterminado configurado, o un firewall bloqueó el inicio de sesión. Configura un navegador predeterminado y elige Sign in de nuevo. Si estás detrás de un proxy corporativo, permite HTTPS saliente hacia ai-game.dev. En la CLI, /login muestra un código y una dirección que puedes abrir en cualquier otro dispositivo.
La app volvió a la pantalla de inicio de sesión, o la CLI pide /login. Tu sesión caducó o se revocó, por ejemplo desde la página de dispositivos conectados de tu cuenta. Inicia sesión de nuevo; tus chats y ajustes se conservan.
Una ejecución headless termina con el código 2. El equipo no tiene la sesión iniciada, el prompt estaba vacío, o la carpeta o algún flag no son utilizables. Ejecuta gamedev una vez de forma interactiva y escribe /login. Consulta los códigos de salida.
La cuenta con la sesión iniciada no es la correcta. La app, la CLI y gamedev acp comparten un único inicio de sesión por equipo. Usa /login --switch en la CLI, o cierra sesión y vuelve a iniciarla en la app de escritorio.
Más información sobre estos flujos: Guía de autenticación.
Modelos
La lista de modelos indica que está cargando o que no se puede acceder a ella. La lista proviene de ai-game.dev. Sin conexión y sin una copia guardada de la última lista, no hay nada que mostrar. Comprueba tu conexión y vuelve a abrir el selector.
Un modelo aparece atenuado. El motivo se muestra bajo su nombre: puede requerir un plan superior (consulta la página de precios), puede no ofrecerse en el país de tu dirección de facturación (consulta disponibilidad de modelos), o puede requerir confirmación de edad en tu cuenta. Al final de la lista de modelos se muestra la región en la que se basa tu disponibilidad.
La CLI rechaza --model. El modelo no está disponible para tu cuenta. Elige uno con /model o pasa otro id.
El uso se agota rápidamente. El uso se muestra como un porcentaje de tu asignación mensual. Los modelos más grandes consumen más para el mismo trabajo; usa un modelo más rápido para ediciones rutinarias y mantén activadas solo las herramientas que necesite una sesión.
Plugin del motor y conexión con el editor
La CLI indica que no hay ningún proyecto de Unity, Godot o Unreal en la carpeta. Abre la carpeta raíz del proyecto: para Unity, la carpeta con ProjectSettings/; para Godot, la carpeta con project.godot; para Unreal, la carpeta con el archivo .uproject.
El plugin no se instaló. No se pudo encontrar el motor o el proyecto. Asegúrate de que el motor esté instalado (Unity Hub, Unreal Engine o Godot) y de que hayas abierto una carpeta de proyecto real; después haz clic en Install Package en la barra lateral o ejecuta /install-plugin. Para instalarlo a mano, sigue la guía de Unity, Unreal o Godot.
La barra lateral ofrece Update Package. Hay disponible una versión más reciente del plugin. Haz clic para actualizar el plugin en el proyecto.
El editor muestra «Disconnected». El editor no ha terminado de autorizar o ha perdido su conexión con la nube. Abre la ventana AI Game Developer en el editor, elige Cloud, haz clic en Authorize y espera a Ready.
El agente espera mucho tiempo al editor. Los proyectos grandes tardan un rato en abrirse. La app espera hasta 15 minutos a que arranque el editor y hasta 2 minutos más a que estén listas sus herramientas. Pulsa Stop para cancelar la espera; un editor que ya se inició permanece abierto. Si abres tú mismo el editor antes de una sesión larga, evitas la espera.
Al crear un proyecto se indica que el editor del motor no está instalado. Instala primero el motor, o elige a mano un editor instalado en el diálogo de creación.
Paquetes
«requires AI Game Dev >=X, you have Y». El paquete necesita una versión más reciente de la app. Actualiza la app (consulta Instalación).
Un paquete muestra un contador de advertencias. Abre la ventana Packages, selecciona el paquete y lee su pestaña Errors. El registro de la app tiene los detalles bajo pkg:<id>.
Los paquetes dejaron de funcionar en un proyecto. Si el host de paquetes falla tres veces en cinco minutos, no se reinicia automáticamente. Haz clic en Reload en la ventana Packages, o ejecuta /packages reload en la CLI.
Un paquete no se actualiza. Las actualizaciones automáticas son por paquete y por equipo: comprueba su interruptor Auto-update. Los paquetes de una carpeta local y las fuentes de GitHub fijadas a una etiqueta nunca se actualizan automáticamente. Usa Check for updates o gamedev pkg update <id>.
Una versión aparece marcada como «not in registry anymore». Esa versión fue retirada. Sigue funcionando y nunca se ofrece como destino de actualización.
Un paquete está bloqueado porque una dependencia está excluida. La dependencia está desactivada en algún nivel de este proyecto. Elige Include it again en la ventana Packages, o gamedev pkg include <id>.
«Tools of package X are unavailable in this session». Ya hay un servidor MCP con el mismo nombre configurado para la sesión (por ti, por el proyecto o por un motor). Cambia el nombre o elimina el otro servidor en Settings, MCP servers.
Una carpeta de paquete vinculada no hace nada. id-mismatch significa que el manifiesto de la carpeta nombra otro paquete; not-found significa que la carpeta se ha movido. Ejecuta gamedev pkg unlink <id> para volver a la versión publicada.
Falta una herramienta en el chat. Los paquetes instalados no añaden herramientas a todos los chats. Activa la herramienta en la fila Tools de la sesión (CLI: /config, Tools). El cambio se aplica desde el siguiente mensaje.
Modelos locales de imagen y vídeo
Un modelo no se ofrece para mi equipo. Cada modelo indica el hardware para el que sirve; la aplicación solo ofrece lo que tu GPU, memoria de vídeo y controlador pueden ejecutar. Si has cambiado de hardware o de controladores, ejecuta /images redetect. Consulta la tabla de hardware.
La generación falla con «out of memory» o es muy lenta. Una ejecución que se queda sin memoria de vídeo se reintenta una vez con un presupuesto de memoria menor. El cambio silencioso a la CPU se notifica como fallo en lugar de ocultarse. Prueba un modelo más ligero (por ejemplo, una variante Lightning o Z-Image Turbo) o cierra otros programas que consuman mucha GPU. /images stop cancela las imágenes en cola y libera la GPU.
El disco está lleno. Mueve el almacenamiento de modelos a una unidad más grande en Settings, Model storage, o con /images storage <new folder>; /images free-space elimina los archivos que ningún modelo utiliza.
El entorno de ejecución de imágenes se bloqueó o está roto. Ejecuta /images reinstall para configurarlo de nuevo.
Generación en la nube
El agente dice que la generación en la nube no está activada. Activa Cloud generation en la fila Tools de la sesión, o usa /cloud ask en la CLI.
No se puede usar un modelo en la nube. La generación en la nube es para planes de pago, algunos modelos requieren Studio o superior y otros no se ofrecen en todas las regiones. La pestaña Models indica el motivo. Un trabajo fallido no consume tu cuota.
SuperCollider y Blender
La música no arranca en Linux. El entorno de ejecución de SuperCollider está disponible hoy en Windows y macOS.
No se encuentra Blender. Ejecuta /blender list para ver todos los Blender que detecta la aplicación, /blender setup para configurarlo de nuevo (opcionalmente con la ruta a tu Blender), o deja que /blender descargue un Blender portátil. Se requiere Blender 4.2 o posterior.
CLI y servicio en segundo plano
La CLI está desactualizada. Ejecuta gamedev update.
«The running host does not offer … yet. Quit every AI Game Dev window and CLI, then start again». El servicio en segundo plano es más antiguo que la CLI o la aplicación que has iniciado. Cierra todas las ventanas y CLIs de AI Game Dev y vuelve a empezar, o usa /update now en la CLI.
Necesito registros para un informe de error. gamedev daemon status muestra el estado del servicio en segundo plano y gamedev daemon logs --lines 200 imprime sus registros recientes. Comparte la parte relevante, nunca tus credenciales, en Discord o GitHub.
¿Sigues atascado?
Consulta las FAQ, las FAQ del sitio y las notas de la versión para ver las correcciones recientes.