# Solución de problemas — App y CLI de AI Game Dev · AI Game Developer Wiki 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 se tradujo automáticamente del inglés. [Lee el original en inglés](https://ai-game.dev/docs/wiki/app/troubleshooting). 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](https://ai-game.dev/es/docs/wiki/app/cli#headless). **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](https://ai-game.dev/docs/auth). ## 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](https://ai-game.dev/pricing)), puede no ofrecerse en el país de tu dirección de facturación (consulta [disponibilidad de modelos](https://ai-game.dev/model-availability)), 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](https://ai-game.dev/es/docs/wiki/unity/installation), [Unreal](https://ai-game.dev/es/docs/wiki/unreal/installation) o [Godot](https://ai-game.dev/es/docs/wiki/godot/installation). **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](https://ai-game.dev/es/docs/wiki/app/installation#updates)). **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:`. **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 `. **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 `. **«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 ` 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](https://ai-game.dev/es/docs/wiki/app/packages-catalog#local-image-models). **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 `; `/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](https://ai-game.dev/es/docs/wiki/app/faq), las [FAQ del sitio](https://ai-game.dev/docs/faq) y las [notas de la versión](https://ai-game.dev/es/releases) para ver las correcciones recientes. --- Source (HTML): https://ai-game.dev/es/docs/wiki/app/troubleshooting Machine-translated (es) from the English page: https://ai-game.dev/docs/wiki/app/troubleshooting