Solução de problemas

Esta página reúne os problemas que os usuários do app AI Game Dev e da CLI gamedev encontram com mais frequência, com a provável causa e a solução. Encontre o sintoma na sua área: login, modelos, conexão com a engine, pacotes, modelos locais, geração em nuvem ou a CLI.

Login#

A janela do navegador de login não abre. Nenhum navegador padrão está definido, ou um firewall bloqueou o login. Defina um navegador padrão e escolha Sign in novamente. Atrás de um proxy corporativo, permita HTTPS de saída para ai-game.dev. Na CLI, /login mostra um código e um endereço que você pode abrir em qualquer outro dispositivo.

O app voltou para a tela de login, ou a CLI pede /login. Sua sessão expirou ou foi revogada, por exemplo na página de dispositivos conectados da sua conta. Entre novamente; seus chats e configurações são mantidos.

Uma execução headless termina com o código 2. O computador não está conectado, o prompt estava vazio, ou a pasta ou uma flag não é utilizável. Execute gamedev de forma interativa uma vez e digite /login. Veja os códigos de saída.

A conta conectada está errada. O app, a CLI e o gamedev acp compartilham um único login por computador. Use /login --switch na CLI, ou saia e entre novamente no app de desktop.

Mais sobre os fluxos: Guia de autenticação.

Modelos#

A lista de modelos diz que está carregando ou inacessível. A lista vem de ai-game.dev. Sem conexão e sem uma cópia salva da última lista, não há nada para mostrar. Verifique sua conexão e reabra o seletor.

Um modelo está esmaecido. O motivo aparece abaixo do nome: pode exigir um plano superior (veja a página de preços), pode não ser oferecido no país do seu endereço de cobrança (veja disponibilidade de modelos) ou pode exigir confirmação de idade na sua conta. O rodapé da lista de modelos mostra a região em que sua disponibilidade se baseia.

--model é recusado na CLI. O modelo não está disponível para a sua conta. Escolha um com /model ou passe outro id.

O uso acaba rápido. O uso é mostrado como uma porcentagem da sua cota mensal. Modelos maiores consomem mais dela para o mesmo trabalho; use um modelo mais rápido para edições rotineiras e mantenha ativadas apenas as ferramentas de que uma sessão precisa.

Plugin da engine e conexão com o editor#

A CLI diz que não há projeto Unity, Godot ou Unreal na pasta. Abra a pasta raiz do projeto: para Unity, a pasta com ProjectSettings/; para Godot, a pasta com project.godot; para Unreal, a pasta com o arquivo .uproject.

O plugin não foi instalado. A engine ou o projeto não pôde ser encontrado. Verifique se a engine está instalada (Unity Hub, Unreal Engine ou Godot) e se você abriu uma pasta de projeto real, depois clique em Install Package na barra lateral ou execute /install-plugin. Para instalar manualmente, siga o guia de Unity, Unreal ou Godot.

A barra lateral oferece Update Package. Há uma versão mais recente do plugin disponível. Clique para atualizar o plugin no projeto.

O editor mostra "Disconnected". O editor não concluiu a autorização ou perdeu a conexão com a Cloud. Abra a janela AI Game Developer no editor, escolha Cloud, clique em Authorize e aguarde Ready.

O agente espera muito tempo pelo editor. Projetos grandes levam um tempo para abrir. O app espera até 15 minutos pelo início do editor e até mais 2 minutos pelas ferramentas dele. Pressione Stop para cancelar a espera; um editor que já iniciou permanece aberto. Abrir o editor você mesmo antes de uma sessão longa evita a espera.

Ao criar um projeto, a mensagem diz que o editor da engine não está instalado. Instale a engine primeiro ou escolha manualmente um editor instalado na caixa de criação.

Pacotes#

"requer AI Game Dev >=X, você tem Y". O pacote precisa de um app mais recente. Atualize o app (veja Instalação).

Um pacote mostra uma contagem de avisos. Abra a janela Packages, selecione o pacote e leia a aba Errors. O log do app tem os detalhes em pkg:<id>.

Os pacotes pararam de funcionar em um projeto. Se o host de pacotes travar três vezes em cinco minutos, ele não é reiniciado automaticamente. Clique em Reload na janela Packages ou execute /packages reload na CLI.

Um pacote não é atualizado. As atualizações automáticas são por pacote e por computador: verifique a chave Auto-update dele. Pacotes de uma pasta local e fontes do GitHub fixadas em uma tag nunca são atualizados automaticamente. Use Check for updates ou gamedev pkg update <id>.

Uma versão está marcada como "not in registry anymore". Essa versão foi retirada. Ela continua funcionando e nunca é oferecida como destino de atualização.

Um pacote está bloqueado porque uma dependência está excluída. A dependência está desativada em algum nível deste projeto. Escolha Include it again na janela Packages ou use gamedev pkg include <id>.

"Tools of package X are unavailable in this session". Um servidor MCP com o mesmo nome já está configurado para a sessão (por você, pelo projeto ou por uma engine). Renomeie ou remova o outro servidor em Settings, MCP servers.

Uma pasta de pacote vinculada não faz nada. id-mismatch significa que o manifesto da pasta indica outro pacote; not-found significa que a pasta foi movida. Execute gamedev pkg unlink <id> para voltar à versão publicada.

Falta uma ferramenta no chat. Pacotes instalados não adicionam ferramentas a todos os chats. Ative a ferramenta na linha Tools da sessão (CLI: /config, Tools). A mudança vale a partir da próxima mensagem.

Modelos locais de imagem e vídeo#

Um modelo não é oferecido para o meu computador. Cada modelo lista o hardware compatível; o app oferece apenas o que sua GPU, memória de vídeo e driver conseguem executar. Se você mudou o hardware ou os drivers, execute /images redetect. Veja a tabela de hardware.

A geração falha com "out of memory" ou é muito lenta. Uma execução que fica sem memória de vídeo é repetida uma vez com um orçamento de memória menor. Um fallback silencioso para a CPU é relatado como falha em vez de ficar oculto. Tente um modelo mais leve (por exemplo, uma variante Lightning ou o Z-Image Turbo) ou feche outros programas que usam muito a GPU. /images stop cancela imagens na fila e libera a GPU.

O disco está cheio. Mova o armazenamento de modelos para um disco maior em Settings, Model storage, ou com /images storage <new folder>; /images free-space exclui arquivos que nenhum modelo usa.

O runtime de imagens foi bloqueado ou está quebrado. Execute /images reinstall para configurá-lo novamente.

Geração em nuvem#

O agente diz que a geração em nuvem não está ativada. Ative Cloud generation na linha Tools da sessão ou use /cloud ask na CLI.

Um modelo de nuvem não pode ser usado. A geração em nuvem é para planos pagos, alguns modelos exigem Studio ou superior, e alguns não são oferecidos em todas as regiões. A aba Models indica o motivo. Um job com falha não consome sua cota.

SuperCollider e Blender#

A música não inicia no Linux. O runtime do SuperCollider está disponível hoje no Windows e no macOS.

O Blender não é encontrado. Execute /blender list para ver todos os Blender que o app encontra, /blender setup para configurá-lo novamente (opcionalmente com o caminho do seu Blender), ou deixe o /blender baixar um Blender portátil. É necessário o Blender 4.2 ou mais recente.

CLI e serviço em segundo plano#

A CLI está desatualizada. Execute gamedev update.

"The running host does not offer … yet. Quit every AI Game Dev window and CLI, then start again". O serviço em segundo plano é mais antigo que a CLI ou o app que você iniciou. Feche todas as janelas do AI Game Dev e a CLI e comece de novo, ou use /update now na CLI.

Preciso de logs para um relatório de bug. gamedev daemon status mostra o estado do serviço em segundo plano e gamedev daemon logs --lines 200 exibe os logs recentes dele. Compartilhe a parte relevante, nunca suas credenciais, no Discord ou no GitHub.

Ainda com problemas#

Consulte o FAQ, o FAQ do site e as notas de versão para correções recentes.