Como usar o ChatGPT em Blueprints da Unreal Engine
Use o ChatGPT em Blueprints da Unreal Engine: chame a API da OpenAI a partir de um nó em C++, exponha-o aos Blueprints e compare com um NPC com voz do plugin da Neocortex.
Sercan AltundasFounder of Neocortex
· 9 min de leitura

"Como uso o ChatGPT nos Blueprints da Unreal?" geralmente significa: deixar o jogador conversar com um NPC e fazer um modelo de linguagem responder. A Unreal não tem nenhum nó de Blueprint para requisições web, então o primeiro passo é um pouco de C++. Este guia cria um nó de ChatGPT chamável por Blueprint com o módulo HTTP da Unreal, depois mostra o que é preciso para publicar e como o mesmo NPC fica com o plugin da Neocortex.
Caminho 1: um nó de ChatGPT para Blueprints
Você precisa de um projeto em C++, de uma chave de API da OpenAI e dos módulos HTTP e Json adicionados a PublicDependencyModuleNames no seu Build.cs. Este componente envia uma fala do jogador para o endpoint de chat completions e dispara um evento de Blueprint com a resposta:
// NpcChatComponent.cpp: declare Ask as a BlueprintCallable UFUNCTION and OnReply as a
// BlueprintAssignable delegate with one FString parameter in NpcChatComponent.h
#include "NpcChatComponent.h"
#include "HttpModule.h"
#include "Interfaces/IHttpResponse.h"
#include "Dom/JsonObject.h"
#include "Serialization/JsonReader.h"
#include "Serialization/JsonSerializer.h"
static TSharedPtr<FJsonValue> ChatMessage(const FString& Role, const FString& Content)
{
TSharedRef<FJsonObject> Message = MakeShared<FJsonObject>();
Message->SetStringField(TEXT("role"), Role);
Message->SetStringField(TEXT("content"), Content);
return MakeShared<FJsonValueObject>(Message);
}
void UNpcChatComponent::Ask(const FString& PlayerLine)
{
TSharedRef<FJsonObject> Root = MakeShared<FJsonObject>();
Root->SetStringField(TEXT("model"), TEXT("MODEL_NAME"));
Root->SetArrayField(TEXT("messages"), { ChatMessage(TEXT("system"), SystemPrompt), ChatMessage(TEXT("user"), PlayerLine) });
FString Body;
FJsonSerializer::Serialize(Root, TJsonWriterFactory<>::Create(&Body));
TSharedRef<IHttpRequest, ESPMode::ThreadSafe> Request = FHttpModule::Get().CreateRequest();
Request->SetURL(TEXT("https://api.openai.com/v1/chat/completions"));
Request->SetVerb(TEXT("POST"));
Request->SetHeader(TEXT("Content-Type"), TEXT("application/json"));
Request->SetHeader(TEXT("Authorization"), TEXT("Bearer ") + ApiKey); // testing only, never ship it
Request->SetContentAsString(Body);
Request->OnProcessRequestComplete().BindWeakLambda(this, [this](FHttpRequestPtr, FHttpResponsePtr Response, bool bOk)
{
TSharedPtr<FJsonObject> Json;
if (!bOk || !Response.IsValid() || !FJsonSerializer::Deserialize(TJsonReaderFactory<>::Create(Response->GetContentAsString()), Json)) return;
const TArray<TSharedPtr<FJsonValue>>* Choices;
if (Json->TryGetArrayField(TEXT("choices"), Choices) && Choices->Num() > 0)
{
OnReply.Broadcast((*Choices)[0]->AsObject()->GetObjectField(TEXT("message"))->GetStringField(TEXT("content")));
}
});
Request->ProcessRequest();
}Adicione o componente ao seu NPC, defina SystemPrompt ("You are Brannoch, a gruff blacksmith...") e a chave, e nos Blueprints chame Ask e vincule On Reply ao seu widget de diálogo. Substitua MODEL_NAME por um modelo atual da documentação da OpenAI. A resposta chega na thread do jogo, então é seguro atualizar a interface a partir do evento.
Isso envia uma linha por vez. Para uma conversa, mantenha um array de mensagens e envie todas elas em cada requisição.
O que ele deixa para você construir
- A chave. Uma chave empacotada com o jogo pode ser extraída e consome toda a sua conta da OpenAI. Você precisa de um servidor próprio entre o jogo e a API.
- Voz. Speech-to-text para o jogador, text-to-speech para a resposta, decodificação do áudio em um Sound Wave, e manter a espera curta. Veja como funciona o pipeline de voz de NPCs com IA.
- Emoção e ações. A resposta é texto simples. Para controlar animação e jogabilidade, você pede JSON no prompt, faz o parse e trata as vezes em que ele vem malformado.
- Histórico e custo. Cada mensagem deixa a próxima requisição maior, mais lenta e mais cara.
- Manter o personagem no papel. Os jogadores tentarão quebrar um prompt de sistema em poucos minutos. Veja como manter NPCs com IA no personagem.
Caminho 2: o mesmo NPC com o plugin da Neocortex
Com a Neocortex, o personagem é desenhado em um editor no navegador, com personalidade, um mundo, uma base de conhecimento, uma voz e ações, e o plugin da Unreal oferece nós de Blueprint para o restante:
- Clone o plugin na pasta
Pluginsdo seu projeto, ative-o e adicione"Neocortex"ao seuBuild.cs. - Cole sua chave de API em Project Settings > Game > Neocortex.
- Adicione um componente Neocortex Smart Agent ao NPC e defina o Project Id.
- Chame Send Message For Audio com a fala do jogador.
- Vincule On Chat para o texto, a emoção e a ação, e On Audio para um Sound Wave que você toca com Set Sound e Play.
Para entrada de voz, o componente Neocortex Microphone Recorder grava e transcreve o jogador, então um botão de push-to-talk são três nós de Blueprint. O passo a passo completo está em como adicionar NPCs com IA à Unreal Engine 5.
Lado a lado
| API da OpenAI em C++ | Plugin da Neocortex para Unreal | |
|---|---|---|
| Primeira resposta | Um componente em C++ e parse de JSON | Nós de Blueprint |
| Voz de entrada e saída | Construa você mesmo | Componente de gravação, Sound Wave na saída |
| Emoção | Prompt e parse | Em cada resposta |
| Ações | Pedir JSON no prompt e validar | Definidas no editor, enviadas como palavra-chave |
| Histórico da conversa | Seu array, crescendo | Mantido em uma sessão por personagem |
| Proteção da chave | Seu próprio servidor | Limites por jogador e por personagem em cada chave |
| Design do personagem | Um prompt de sistema | Editor visual com testes no navegador |
Dúvidas comuns na rota faça-você-mesmo
- "A requisição nunca retorna." Confira se o módulo
HTTPestá no seuBuild.cse se a requisição não está sendo coletada pelo garbage collector: mantenha a chamada dentro de um componente que viva enquanto o NPC viver. - "O JSON quebra com aspas." Monte o corpo com
FJsonObject, como acima, em vez de formatar strings à mão. Os jogadores digitam apóstrofos e aspas o tempo todo. - "Posso chamar isso em projetos só com Blueprints?" Não, sem C++ ou um plugin HTTP de terceiros.
Próximos passos
Para o lado do design, leia como dar personalidades únicas aos NPCs e como fazer NPCs com IA agirem sobre o que dizem. Todos os tutoriais estão no guia para criar NPCs com IA.
Verificado em novembro de 2026. A Neocortex não é afiliada à OpenAI nem à Epic Games.
Perguntas frequentes
Posso usar o ChatGPT nos Blueprints da Unreal Engine?
Não com os nós integrados. A Unreal não tem nó de Blueprint para requisições HTTP, então você escreve uma pequena função em C++ com o módulo HTTP e a expõe aos Blueprints, ou instala um plugin. O plugin da Neocortex oferece um personagem de IA completo com nós de Blueprint e voz.
Preciso de C++ para chamar um LLM na Unreal?
Para uma chamada direta à API, algumas linhas de C++ ou um plugin HTTP de terceiros. Com a Neocortex, o projeto precisa ser um projeto em C++ para que o plugin compile, mas tudo o que você usa são nós de Blueprint.
É seguro colocar uma chave de API da OpenAI em um jogo na Unreal?
Não. Qualquer coisa empacotada com o jogo pode ser extraída, e uma chave da OpenAI dá acesso total aos gastos da sua conta. Direcione as chamadas por um servidor próprio. As chaves da Neocortex podem ter limites de uso por jogador e por personagem, que os nossos servidores aplicam, e você pode desativar uma chave pelo painel.
Como dou voz a um NPC com ChatGPT na Unreal?
Você adicionaria speech-to-text para o jogador e text-to-speech para a resposta, depois transformaria o áudio em um Sound Wave. O plugin da Neocortex devolve a resposta como um Sound Wave que você pode tocar, e grava e transcreve a voz do jogador.






