Come usare ChatGPT nei Blueprint di Unreal Engine
Usa ChatGPT nei Blueprint di Unreal Engine: chiama l'API OpenAI da un nodo C++, esponilo ai Blueprint e confrontalo con un NPC con voce del plugin Neocortex.
Sercan AltundasFounder of Neocortex
· 9 min di lettura

"Come uso ChatGPT nei Blueprint di Unreal?" di solito significa: far parlare i giocatori con un NPC e far rispondere un modello linguistico. Unreal non ha un nodo Blueprint per le richieste web, quindi il primo passo è un po' di C++. Questa guida costruisce un nodo ChatGPT richiamabile dai Blueprint con il modulo HTTP di Unreal, poi mostra cosa serve per distribuirlo e come appare lo stesso NPC con il plugin Neocortex.
Percorso 1: un nodo ChatGPT per i Blueprint
Ti servono un progetto C++, una chiave API OpenAI e i moduli HTTP e Json aggiunti a PublicDependencyModuleNames nel tuo Build.cs. Questo componente invia una battuta del giocatore all'endpoint chat completions e lancia un evento Blueprint con la risposta:
// 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();
}Aggiungi il componente al tuo NPC, imposta SystemPrompt ("Sei Brannoch, un fabbro burbero...") e la chiave, e nei Blueprint chiama Ask e collega On Reply al tuo widget di dialogo. Sostituisci MODEL_NAME con un modello attuale dalla documentazione di OpenAI. La risposta arriva sul thread di gioco, quindi è sicuro aggiornare l'interfaccia dall'evento.
Questo invia una riga alla volta. Per una conversazione, tieni un array di messaggi e inviane tutti a ogni richiesta.
Cosa resta da costruire a te
- La chiave. Una chiave inclusa nel gioco può essere estratta e spende l'intero account OpenAI. Ti serve un tuo server tra il gioco e l'API.
- La voce. Speech to text per il giocatore, text to speech per la risposta, decodifica dell'audio in una Sound Wave, e un'attesa breve. Vedi come funziona la pipeline vocale degli NPC AI.
- Emozione e azioni. La risposta è testo semplice. Per guidare animazioni e gameplay devi chiedere un JSON nel prompt e analizzarlo, poi gestire le volte in cui è malformato.
- Cronologia e costi. Ogni messaggio rende la richiesta successiva più grande, più lenta e più costosa.
- Restare nel personaggio. I giocatori proveranno a rompere il system prompt in pochi minuti. Vedi come far restare in character gli NPC AI.
Percorso 2: lo stesso NPC con il plugin Neocortex
Con Neocortex, il personaggio si progetta in un editor nel browser, con una personalità, un mondo, una base di conoscenza, una voce e azioni, e il plugin Unreal ti dà i nodi Blueprint per il resto:
- Clona il plugin nella cartella
Pluginsdel progetto, abilitalo e aggiungi"Neocortex"al tuoBuild.cs. - Incolla la tua chiave API in Project Settings > Game > Neocortex.
- Aggiungi un componente Neocortex Smart Agent all'NPC e imposta il suo Project Id.
- Chiama Send Message For Audio con la battuta del giocatore.
- Collega On Chat per il testo, l'emozione e l'azione, e On Audio per una Sound Wave che riproduci con Set Sound e Play.
Per l'input vocale, il componente Neocortex Microphone Recorder registra e trascrive il giocatore, quindi un pulsante push to talk sono tre nodi Blueprint. La procedura completa è in come aggiungere NPC AI a Unreal Engine 5.
Confronto diretto
| API OpenAI da C++ | Plugin Unreal di Neocortex | |
|---|---|---|
| Prima risposta | Un componente C++ e l'analisi JSON | Nodi Blueprint |
| Voce in entrata e in uscita | Da costruire a te | Componente registratore, Sound Wave in uscita |
| Emozione | Prompt e analisi | Su ogni risposta |
| Azioni | Chiedere un JSON nel prompt e validarlo | Definite nell'editor, inviate come parola chiave |
| Cronologia della conversazione | Il tuo array, che cresce | Conservata in una sessione per personaggio |
| Protezione della chiave | Il tuo server | Limiti per giocatore e per personaggio su ogni chiave |
| Design del personaggio | Un system prompt | Editor visuale con test nel browser |
Domande comuni sul percorso fai-da-te
- "La richiesta non torna mai." Controlla che il modulo
HTTPsia nel tuoBuild.cse che la richiesta non venga raccolta dal garbage collector: tieni la chiamata dentro un componente che vive quanto l'NPC. - "Il JSON si rompe con le virgolette." Costruisci il corpo con
FJsonObject, come sopra, invece di formattare le stringhe a mano. I giocatori digitano apostrofi e virgolette di continuo. - "Posso chiamarlo da progetti solo Blueprint?" Non senza C++ o un plugin HTTP di terze parti.
Prossimi passi
Per il lato del design, leggi come dare agli NPC personalità uniche e come far agire gli NPC AI su ciò che dicono. Ogni tutorial è nella guida alla creazione di NPC AI.
Verificato a novembre 2026. Neocortex non è affiliato a OpenAI né a Epic Games.
Domande frequenti
Posso usare ChatGPT nei Blueprint di Unreal Engine?
Non con i nodi integrati. Unreal non ha un nodo Blueprint per le richieste HTTP, quindi scrivi una piccola funzione C++ con il modulo HTTP e la esponi ai Blueprint, oppure installi un plugin. Il plugin Neocortex ti dà un personaggio AI completo con nodi Blueprint e voce.
Mi serve il C++ per chiamare un LLM da Unreal?
Per una chiamata API diretta, poche righe di C++ o un plugin HTTP di terze parti. Con Neocortex il progetto deve essere un progetto C++ perché il plugin compili, ma tutto ciò che usi è un nodo Blueprint.
È sicuro mettere una chiave API OpenAI in un gioco Unreal?
No. Tutto ciò che viene impacchettato con il gioco può essere estratto, e una chiave OpenAI dà pieno accesso alla spesa del tuo account. Fai passare le chiamate dal tuo server. Le chiavi Neocortex possono avere limiti di utilizzo per giocatore e per personaggio che i nostri server applicano, e puoi disattivare una chiave dalla dashboard.
Come do una voce a un NPC ChatGPT in Unreal?
Aggiungeresti speech to text per il giocatore e text to speech per la risposta, poi trasformeresti l'audio in una Sound Wave. Il plugin Neocortex restituisce la risposta come Sound Wave riproducibile, e registra e trascrive la voce del giocatore.






