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

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.
- Crie uma chave de API. Na OpenAI, crie em platform.openai.com/api-keys.
- Adicione um nó HTTPRequest. Torne-o filho da cena do seu NPC e conecte seu sinal
request_completeda uma função no script do NPC. - Escreva o personagem. Mantenha uma string de instrução do sistema com o nome, o papel, o tom e os limites do personagem.
- Envie a fala. Monte um corpo JSON com o modelo, as instruções e a mensagem do jogador, depois chame
request()comhttps://api.openai.com/v1/responses, os cabeçalhosAuthorization: Bearer <key>eContent-Type: application/json, o método POST e o corpo. - 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. - 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.
- 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.
- 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.
- 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.
- Teste no navegador. Clique em Play no canto superior direito do editor.
- Crie uma chave de API. Abra API Keys no painel.
- Instale o complemento. Baixe a versão mais recente em
https://github.com/neocortex-link/neocortex-godot-sdk/releases/lateste copieaddons/neocortex-godot-sdkpara a pastaaddonsdo seu projeto. - Ative-o. Abra Project > Project Settings > Plugins e ative o Neocortex. Cole sua chave de API no painel Neocortex.
- 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.
- Conecte ao seu jogo. Use o nó
NeocortexSmartAgentpara o personagem,NeocortexAudioReceiverpara o microfone,NeocortexFaceAnimatorpara sincronização labial com blend shapes no estilo ARKit,NeocortexInteractablepara objetos que o personagem deve conhecer, eNeocortexEventLoggerpara eventos que aconteceram. Os nós de ação no editor enviam nomes de ação que o seu GDScript pode executar. - 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.
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.
- Instale. No Godot, abra a aba AssetLib, pesquise NobodyWho, baixe e importe com a opção Ignore asset root marcada. Ou copie
addons/nobodywhode uma release para a pasta do seu projeto. Reinicie ou recarregue o editor. - 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.
- Crie o chat. Em um script, chame
await NobodyWhoChat.create(<model path>, {}). - Faça uma pergunta. Chame
chat.ask(<player text>)e useawaitnocompleted()do resultado. A documentação diz para sempre aguardar o valor retornado logo em seguida. - Defina o papel. Dê ao chat as instruções do personagem, seguindo a seção Chat da documentação do NobodyWho.
- 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.
- Instale o plugin. Pegue-o na Godot Asset Library ou no GitHub, e arraste a pasta
addonspara o seu projeto. - Adicione seu ID de cliente. Crie um em player2.game/profile/developer e informe-o em Project Settings > Player2 > Game Key.
- Adicione o nó do NPC. Adicione um nó Player2 AI NPC à cena e edite a descrição do agente.
- Conecte o chat. Chame a função
chatdo nó com o texto do jogador e conecte o sinalchat_receivedpara mostrar as respostas. Chamenotifypara avisar o agente sobre eventos do mundo. - Adicione voz. Defina um Voice ID na Character Config ou adicione um nó
Player2TTS; para entrada de fala, adicionePlayer2STTe ative a entrada de áudio em Project Settings > Audio. - 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
| Fator | HTTPRequest e uma API | SDK Neocortex | NobodyWho | Plugin Player2 |
|---|---|---|---|---|
| Onde o personagem é definido | Strings no GDScript | Editor visual de nós no navegador | Seu GDScript | Descrição do nó no Godot |
| Onde o modelo roda | Nuvem do provedor | Nuvem da Neocortex | Dispositivo do jogador | Pelo app Player2 |
| Versão do Godot | 4.x com HTTPRequest | 4.7 ou mais recente | 4.6 ou mais recente | 4.5 listada |
| Voz | Construa você mesmo | Incluída, com sincronização labial | Listada para o motor | Nós de TTS e STT |
| Licença do complemento | Nenhuma necessária | Apache 2.0 | EUPL-1.2 | GPLv3 |
| Custo inicial | Taxas por token do provedor | A partir de €9 por mês | Grátis | Grátis para criadores |
| Habilidade necessária | GDScript, HTTP, um servidor | Copiar um complemento, adicionar nós | GDScript, escolha de modelo | Adicionar 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.
- 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.
- 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.
- 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á.
- 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.
- 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.






