# Solução de problemas — App e CLI do AI Game Dev · AI Game Developer Wiki Resolva problemas comuns do AI Game Dev e da CLI gamedev: login, modelos, plugin da engine e conexão com o editor, pacotes, geração local e em nuvem. Esta página foi traduzida automaticamente do inglês. [Leia o original em inglês](https://ai-game.dev/docs/wiki/app/troubleshooting). 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](https://ai-game.dev/pt-br/docs/wiki/app/cli#headless). **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](https://ai-game.dev/docs/auth). ## 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](https://ai-game.dev/pricing)), pode não ser oferecido no país do seu endereço de cobrança (veja [disponibilidade de modelos](https://ai-game.dev/model-availability)) 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](https://ai-game.dev/pt-br/docs/wiki/unity/installation), [Unreal](https://ai-game.dev/pt-br/docs/wiki/unreal/installation) ou [Godot](https://ai-game.dev/pt-br/docs/wiki/godot/installation). **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](https://ai-game.dev/pt-br/docs/wiki/app/installation#updates)). **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:`. **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 `. **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 `. **"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 ` 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](https://ai-game.dev/pt-br/docs/wiki/app/packages-catalog#local-image-models). **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 `; `/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](https://ai-game.dev/pt-br/docs/wiki/app/faq), o [FAQ do site](https://ai-game.dev/docs/faq) e as [notas de versão](https://ai-game.dev/pt-br/releases) para correções recentes. --- Source (HTML): https://ai-game.dev/pt-br/docs/wiki/app/troubleshooting Machine-translated (pt-BR) from the English page: https://ai-game.dev/docs/wiki/app/troubleshooting