Neocortex Logo

Como criar NPCs com IA no Godot | Guia 2026

Como criar NPCs com IA no Godot em 2026: HTTPRequest e uma API de modelo, o SDK Godot da Neocortex, um modelo local com o NobodyWho e o plugin Player2.

Sercan AltundasFounder of Neocortex

· 9 min de leitura

Como criar NPCs com IA no Godot em 2026: HTTPRequest e uma API de modelo, o SDK Godot da Neocortex, um modelo local com o NobodyWho e o plugin Player2.

Você cria um NPC com IA no Godot enviando o que o jogador diz para um modelo de linguagem e mostrando ou falando a resposta: pelo próprio nó HTTPRequest do Godot e uma API de modelo, por um SDK de personagens, ou por um complemento que roda um modelo na máquina do jogador. O Godot não tem recurso próprio de personagens com IA, então todo caminho acrescenta GDScript ou um complemento.

Este guia é para desenvolvedores de Godot 4 que querem personagens que respondem com as próprias palavras, em vez de seguir uma árvore de diálogo. Ele cobre quatro caminhos: HTTPRequest com uma API de modelo, o SDK Godot da Neocortex, um modelo local com o NobodyWho e o plugin Player2 para NPCs com IA. Cada um vem com os passos, o que exige e quanto custa, seguido de uma tabela comparativa, dicas válidas para qualquer método e perguntas frequentes.

4 formas de criar NPCs com IA no Godot

Os quatro começam com um nó na sua cena que representa o personagem e uma entrada para o jogador, um LineEdit ou um microfone. Eles diferem em onde o modelo roda, quem paga por ele e quanto GDScript você escreve.

Método 1: HTTPRequest e uma API de modelo

Esta rota usa apenas o que já vem no Godot. O nó HTTPRequest é "um nó com capacidade de enviar requisições HTTP", então um script pode enviar a fala do jogador para um provedor de modelos e ler a resposta. Usamos a Responses API da OpenAI como exemplo.

O que você precisa: uma chave de API de um provedor de modelos e um pouco de GDScript.

  1. Crie uma chave de API. Na OpenAI, crie em platform.openai.com/api-keys.
  2. Adicione um nó HTTPRequest. Torne-o filho da cena do seu NPC e conecte seu sinal request_completed a uma função no script do NPC.
  3. Escreva o personagem. Mantenha uma string de instrução do sistema com o nome, o papel, o tom e os limites do personagem.
  4. Envie a fala. Monte um corpo JSON com o modelo, as instruções e a mensagem do jogador, depois chame request() com https://api.openai.com/v1/responses, os cabeçalhos Authorization: Bearer <key> e Content-Type: application/json, o método POST e o corpo.
  5. Leia a resposta. No handler de request_completed, interprete o corpo como JSON e coloque o texto em um Label ou RichTextLabel acima do NPC.
  6. Guarde o histórico. Armazene as últimas trocas em um Array e envie-as em cada requisição; o modelo esquece tudo entre as chamadas.
  7. Construa os extras. Voz, sincronização labial e ações são trabalho seu: mais chamadas de API para a fala e suas próprias regras para transformar respostas em jogabilidade.
  8. Proteja a chave. A documentação do Godot recomenda TLS e alerta contra enviar informações sensíveis. Uma chave em um jogo exportado pode ser lida, então coloque um servidor próprio na frente do provedor antes do lançamento.

Custo: o Godot é gratuito. Você paga as taxas por token do provedor.

Onde fica devendo: memória, voz, ações, segurança e o servidor da chave são todos seus para construir e manter.

Método 2: o SDK Godot da Neocortex

A Neocortex é nosso produto, então leia esta seção com isso em mente. Você cria o personagem em um editor visual no navegador e depois o usa no Godot por meio de um complemento de código aberto (Apache 2.0). Personalidade, conhecimento, emoções, voz e ações são nós no editor; no Godot, você adiciona nós prontos. A página de NPC com IA para Godot tem a lista completa.

O que você precisa: Godot 4.7 ou mais recente e uma conta na Neocortex com uma chave de API.

  1. Crie o personagem. No painel, abra Characters, clique em Create New Character, informe um nome e clique em Create. Monte-o no editor de nós.
  2. Teste no navegador. Clique em Play no canto superior direito do editor.
  3. Crie uma chave de API. Abra API Keys no painel.
  4. Instale o complemento. Baixe a versão mais recente em https://github.com/neocortex-link/neocortex-godot-sdk/releases/latest e copie addons/neocortex-godot-sdk para a pasta addons do seu projeto.
  5. Ative-o. Abra Project > Project Settings > Plugins e ative o Neocortex. Cole sua chave de API no painel Neocortex.
  6. Adicione um chat em um passo. Escolha Project > Tools > Neocortex > Complete Text Chat ou Complete Voice Chat. Isso adiciona um chat funcional à cena; escolha o personagem na lista suspensa do Inspector.
  7. Conecte ao seu jogo. Use o nó NeocortexSmartAgent para o personagem, NeocortexAudioReceiver para o microfone, NeocortexFaceAnimator para sincronização labial com blend shapes no estilo ARKit, NeocortexInteractable para objetos que o personagem deve conhecer, e NeocortexEventLogger para eventos que aconteceram. Os nós de ação no editor enviam nomes de ação que o seu GDScript pode executar.
  8. Abra os exemplos. Sete cenas de exemplo e um launcher abrem pelo painel Neocortex: Text Chat, Audio Chat, Actions, Interactables, Group Chat, Usage Gating e Quiz Show.

Limites a conhecer: a gravação para em 29 segundos, sons com menos de 0.15 segundo não são enviados, e as requisições de chat expiram após 30 segundos.

Custo: Starter é €9, Pro €29 e Team €99 por mês com cobrança anual, ou €11, €35 e €119 com cobrança mensal. O uso comercial exige Pro ou Team. Veja preços.

Onde fica devendo: os personagens rodam na nossa nuvem, então o jogo precisa de conexão. Um jogo exportado carrega a chave de API, então defina limites de uso nela. O chat em grupo exige Pro ou Team, o quiz exige Team, e nossa documentação não lista todos os destinos de exportação.

Comece agora

Método 3: um modelo local com o NobodyWho

O NobodyWho é um motor de inferência de código aberto que roda modelos de linguagem na máquina do jogador, com um complemento para Godot. O readme diz que ele não precisa de "chaves de API" e não tem taxas ocultas.

O que você precisa: Godot 4.6 ou mais recente (conforme a documentação do Godot dele) e um modelo no formato GGUF.

  1. Instale. No Godot, abra a aba AssetLib, pesquise NobodyWho, baixe e importe com a opção Ignore asset root marcada. Ou copie addons/nobodywho de uma release para a pasta do seu projeto. Reinicie ou recarregue o editor.
  2. Escolha um modelo. Qualquer modelo GGUF funciona. O readme sugere o Qwen3 0.6B para começar; modelos remotos são baixados e guardados em cache no primeiro uso.
  3. Crie o chat. Em um script, chame await NobodyWhoChat.create(<model path>, {}).
  4. Faça uma pergunta. Chame chat.ask(<player text>) e use await no completed() do resultado. A documentação diz para sempre aguardar o valor retornado logo em seguida.
  5. Defina o papel. Dê ao chat as instruções do personagem, seguindo a seção Chat da documentação do NobodyWho.
  6. Confira os alvos. O NobodyWho suporta exportação para desktop e Android no Godot. Não tem exportação para iOS ou web.

Custo: grátis para uso comercial sob EUPL-1.2. Se você alterar o código do próprio NobodyWho, essas alterações precisam ser de código aberto.

Onde fica devendo: a velocidade e a qualidade da resposta dependem do hardware do jogador e do tamanho do modelo, e o modelo aumenta o download. Os recursos de voz são listados para o motor; confira se a integração com o Godot os tem antes de planejar com eles.

Método 4: o plugin Player2 para NPCs com IA

O Player2 é um app de desktop com APIs locais para jogos e mods. O plugin dele para Godot "usa APIs de IA gratuitas do app Player2" e se conecta quando o app está aberto.

O que você precisa: Godot 4.5 (como listado na Asset Library), um ID de cliente de desenvolvedor do Player2 e o app Player2.

  1. Instale o plugin. Pegue-o na Godot Asset Library ou no GitHub, e arraste a pasta addons para o seu projeto.
  2. Adicione seu ID de cliente. Crie um em player2.game/profile/developer e informe-o em Project Settings > Player2 > Game Key.
  3. Adicione o nó do NPC. Adicione um nó Player2 AI NPC à cena e edite a descrição do agente.
  4. Conecte o chat. Chame a função chat do nó com o texto do jogador e conecte o sinal chat_received para mostrar as respostas. Chame notify para avisar o agente sobre eventos do mundo.
  5. Adicione voz. Defina um Voice ID na Character Config ou adicione um nó Player2TTS; para entrada de fala, adicione Player2STT e ative a entrada de áudio em Project Settings > Audio.
  6. Execute o Player2. Abra o app Player2; o plugin se conecta automaticamente.

Custo: grátis para criadores, segundo as páginas do Player2. O plugin é GPLv3.

Onde fica devendo: o site do Player2 diz que as APIs locais funcionam com o app aberto, então planeje o que jogadores sem o app vão ver. Confira a licença GPLv3 em relação ao seu projeto.

Os quatro métodos comparados

FatorHTTPRequest e uma APISDK NeocortexNobodyWhoPlugin Player2
Onde o personagem é definidoStrings no GDScriptEditor visual de nós no navegadorSeu GDScriptDescrição do nó no Godot
Onde o modelo rodaNuvem do provedorNuvem da NeocortexDispositivo do jogadorPelo app Player2
Versão do Godot4.x com HTTPRequest4.7 ou mais recente4.6 ou mais recente4.5 listada
VozConstrua você mesmoIncluída, com sincronização labialListada para o motorNós de TTS e STT
Licença do complementoNenhuma necessáriaApache 2.0EUPL-1.2GPLv3
Custo inicialTaxas por token do provedorA partir de €9 por mêsGrátisGrátis para criadores
Habilidade necessáriaGDScript, HTTP, um servidorCopiar um complemento, adicionar nósGDScript, escolha de modeloAdicionar um nó

O HTTPRequest dá controle total com mais código. O NobodyWho é a rota offline, presa ao hardware do jogador. A Neocortex mantém os personagens em um editor hospedado, com voz, sincronização labial e exemplos. O Player2 é o nó mais rápido de adicionar e depende do app dele.

Dicas para resultados melhores no Godot

Estes hábitos ajudam em todos os métodos.

  1. Mantenha as chaves fora das exportações. Tudo o que está em um projeto exportado pode ser lido. Guarde arquivos de configuração com chaves fora do controle de versão, e use um servidor ou limites de uso por jogador e por personagem.
  2. Mostre que o NPC ouviu o jogador. Troque para uma animação de "pensando" ou mostre um rótulo no momento em que a requisição começa, para que a espera pela resposta nunca pareça um jogo travado.
  3. Conte ao personagem sobre a cena. Envie objetos próximos e eventos recentes com cada mensagem, para que o NPC fale sobre o ambiente em que está.
  4. Deixe o GDScript dar a palavra final sobre as ações. Mantenha uma lista curta de ações que um personagem pode pedir e verifique cada uma no código antes de executar.
  5. Use uma árvore de diálogo para a trama. Mantenha as falas que movem a história em um complemento de diálogo roteirizado e use o personagem com IA para tudo o que está em volta. Nosso post sobre plugins para Godot lista complementos para a parte roteirizada.

Como escolher o método certo para o Godot

HTTPRequest e uma API de modelo servem se você não quer complementos, quer controle total de cada requisição e pode manter um pequeno servidor para a chave.

O SDK da Neocortex serve se você quer criar personagens visualmente, testá-los no navegador e ter voz, sincronização labial, ações e exemplos no Godot 4.7, com o mesmo personagem usável no Unity e no Unreal Engine.

O NobodyWho serve se o jogo precisa funcionar offline, sem custo recorrente, em desktop ou Android.

O plugin Player2 serve se seus jogadores já usam o app Player2, ou se você está fazendo um protótipo e quer o menor número de passos.

Para mais opções, veja as melhores ferramentas de NPC com IA para Godot, e se você ainda está escolhendo o motor, Godot vs Unity.

Perguntas frequentes

Dá para criar NPCs com IA no Godot de graça?

Sim. O NobodyWho é grátis e roda o modelo localmente, e o Player2 é grátis para criadores. Uma API de modelo que você mesmo chama cobra por token.

O Godot tem NPCs com IA embutidos?

Não. O Godot oferece o nó HTTPRequest para chamadas web, mas não traz modelo de linguagem nem sistema de personagens. Nosso post sobre IA no Godot cobre o que existe em volta do motor.

Qual versão do Godot eu preciso?

A Neocortex precisa do Godot 4.7 ou mais recente, o NobodyWho do 4.6 ou mais recente, e o plugin Player2 lista o 4.5. O HTTPRequest faz parte do Godot 4.

Um NPC com IA no Godot pode rodar offline?

Sim, com um modelo local como o NobodyWho em desktop ou Android. As rotas na nuvem, incluindo a Neocortex, precisam de conexão.

O SDK Godot da Neocortex é de código aberto?

Sim. Ele é distribuído sob Apache 2.0, e o código está no GitHub em neocortex-link/neocortex-godot-sdk. Relatos de bugs e ideias são bem-vindos por lá.

NPCs com IA no Godot funcionam em exportações web?

Depende da rota. O NobodyWho não tem exportação web. Para jogos de navegador fora do Godot, a Neocortex também tem um SDK Web.

Artigos semelhantes

Continue lendo