SDK da Neocortex para Godot: NPCs com IA e voz no Godot 4
Nosso SDK para Godot de código aberto leva NPCs com IA ao Godot 4: chat de voz, diálogo com IA com emoções, ações, lip sync e conversas em grupo, a partir do GDScript.
Neocortex TeamThe team behind Neocortex
· 6 min de leitura

A Godot é a engine que a maioria das plataformas de personagens com IA deixa de lado. Não mais: o nosso SDK para Godot já está disponível. Crie um personagem na Neocortex, adicione o addon ao seu projeto Godot 4, e os jogadores podem conversar com ele em voz alta, ouvi-lo responder com a própria voz e vê-lo agir no seu mundo.
Ele é open source, funciona a partir do GDScript e vem com sete cenas de exemplo para você ver tudo funcionando antes de criar a sua.
O que o SDK para Godot acrescenta ao seu jogo
- Personagens com quem os jogadores podem conversar, digitando ou em voz alta.
- Uma voz e uma emoção em cada linha, para que animações e retratos acompanhem o humor.
- Ações que executam o seu próprio código, como abrir uma porta ou entregar um item.
- Percepção da cena, para que os personagens saibam o que está ao redor deles.
- Lip sync, conversas em grupo e apresentadores de quiz.
- Memória, para que uma conversa continue de onde parou.

Diálogo com IA na Godot sem árvores de diálogo
Árvores de diálogo ramificadas quebram no momento em que o jogador pergunta algo que você não escreveu. Com a Neocortex, você desenha o personagem em vez de cada linha: a personalidade, o que ele sabe sobre o seu mundo, como fala e o que tem permissão para fazer. Você testa no navegador até soar certo e depois usa o mesmo personagem na Godot.
Cada resposta chega como uma sequência de linhas, cada uma com a sua própria emoção, então um lojista pode parecer satisfeito com uma venda e irritado com uma barganha na mesma resposta. O personagem também se lembra da conversa, e você pode enviar eventos recentes do jogo, como "o jogador acabou de vencer o duelo", para que as respostas combinem com o que aconteceu. Nossos guias sobre personalidades únicas para NPCs e memória de NPCs aprofundam o lado do design.
Chat de voz com NPCs na Godot
Os jogadores podem falar em vez de digitar. O SDK grava o microfone com detecção de voz ou push to talk, transforma a fala em texto, e o personagem responde com a própria voz. A voz começa a tocar enquanto o resto da resposta ainda está sendo gerado, então as conversas não travam.
Você escolhe como as respostas são faladas: cada linha com a sua emoção, a resposta inteira como um único clipe, ou só texto. No Android, o SDK pede permissão do microfone ao iniciar. Nosso post sobre o pipeline de voz de NPCs com IA explica o que acontece entre o microfone e o alto-falante.
NPCs da Godot que agem sobre o que dizem
Falar é só metade do trabalho. Dê a um personagem ações no editor, como GIVE_ITEM, OPEN_DOOR ou FOLLOW_PLAYER, e ligue cada uma a uma função em GDScript:
@onready var agent: NeocortexSmartAgent = $Blacksmith/NeocortexSmartAgent
func _ready() -> void:
agent.chat_line_started.connect(func(line: NeocortexChatLine): $Subtitle.text = line.text)
agent.register_action("GIVE_ITEM", _give_item)
func _give_item(action: NeocortexChatAction) -> void:
inventory.give(action.target_id) # your own inventory codeO personagem pede, o seu jogo decide. Marque objetos da sua cena como interativos, e o personagem sabe o que está por perto e pode direcionar as ações para eles: "vá até o quadrado vermelho, depois o azul" vira duas ações, cada uma com um alvo. Uma resposta pode trazer várias ações, executadas uma após a outra.

Lip sync, conversas em grupo e quizzes
- Lip sync: a boca do personagem se move com as palavras em blend shapes no estilo ARKit, o padrão que a maioria dos modelos de personagem já usa.
- Conversas em grupo: coloque vários personagens em uma cena, deixe-os falar com o jogador e entre si, e faça-os entrar ou sair enquanto a conversa acontece.
- Apresentadores de quiz: um personagem conduz um quiz com o seu conjunto de perguntas para um ou mais jogadores, com dicas, passes e pontuação tratados para você.

Como adicionar NPCs com IA ao Godot 4
- Baixe a versão mais recente e copie
addons/neocortex-godot-sdkpara o seu projeto. - Ative Neocortex em Project Settings > Plugins, e cole a sua chave de API no painel da Neocortex.
- Escolha Project > Tools > Neocortex > Complete Voice Chat, selecione o seu personagem e aperte Play.
O início rápido da Godot traz os detalhes, e o nosso tutorial sobre como adicionar diálogo de NPC com IA na Godot 4 constrói passo a passo uma cena completa de ferreiro.
O SDK da Godot ou a sua própria integração com LLM?
Você pode enviar texto para uma API de LLM com o nó HTTPRequest da Godot e imprimir a resposta. Isso é um bom protótipo de fim de semana. Um personagem com quem os jogadores vão passar horas precisa de mais: reconhecimento de fala, uma voz por personagem, emoções, memória entre sessões, ações em que o seu jogo possa confiar, e limites para que um jogador não faça a sua conta explodir.
O SDK cobre tudo isso, e os limites de uso por jogador e por personagem de cada chave de API são aplicados nos nossos servidores. Para uma visão mais ampla das opções, veja nossa lista de ferramentas de NPC com IA para Godot.
Código aberto
O SDK está no GitHub sob Apache 2.0, então issues e pull requests são bem-vindos. Os mesmos personagens também funcionam na Unity, na Unreal Engine e na web, então um personagem que você cria para um jogo na Godot pode acompanhar você no próximo projeto.
Conte-nos o que o seu jogo na Godot precisa a seguir no nosso Discord.
Perguntas frequentes
Existe um plugin de NPC com IA para Godot?
Sim. O SDK da Neocortex para Godot é um plugin de editor de código aberto para o Godot 4.7 e superior. Ele adiciona ao seu projeto personagens com IA e voz, com emoções, ações, lip sync, conversas em grupo e quizzes.
Como adiciono diálogo com IA a NPCs na Godot?
Crie o personagem na Neocortex, adicione o SDK da Godot à pasta addons do projeto, ative o plugin e cole a sua chave de API. Depois adicione uma cena de chat em Project > Tools > Neocortex, ou chame text_to_audio em um NeocortexSmartAgent a partir do GDScript.
Posso usar o ChatGPT ou outro LLM para NPCs na Godot?
Você pode chamar uma API de LLM por conta própria com o nó HTTPRequest da Godot, mas aí precisa construir por cima a voz, as emoções, a memória e as ações. O SDK da Neocortex para Godot oferece tudo isso em um único addon, com personagens que você cria em um editor visual.
Os jogadores podem conversar com NPCs da Godot usando a voz?
Podem. O jogador fala no microfone, com detecção de voz ou push to talk, e o personagem responde com a própria voz e uma emoção em cada linha.
O SDK da Godot suporta lip sync?
Sim. O NeocortexFaceAnimator move os blend shapes da boca no estilo ARKit na malha do seu personagem enquanto ele fala.
NPCs com IA na Godot podem disparar eventos de gameplay?
Podem. Dê a um personagem ações como GIVE_ITEM ou OPEN_DOOR, e cada uma chama uma função em GDScript que você registra. As ações podem ter como alvo objetos da cena, e o seu código decide se elas são executadas.
Quais versões da Godot o SDK suporta?
Godot 4.7 ou superior.
O SDK da Neocortex para Godot é open source?
Sim. Ele está no GitHub sob a licença Apache 2.0.






