So nutzen Sie ChatGPT in Unreal-Engine-Blueprints
ChatGPT in Unreal-Engine-Blueprints nutzen: die OpenAI-API aus einem C++-Knoten aufrufen, für Blueprints verfügbar machen und mit einem vertonten NPC aus dem Neocortex-Plugin vergleichen.
Sercan AltundasFounder of Neocortex
· 9 Min. Lesezeit

"Wie nutze ich ChatGPT in Unreal-Blueprints?" bedeutet meist: Spieler sollen mit einem NPC sprechen, und ein Sprachmodell soll antworten. Unreal hat keinen Blueprint-Knoten für Webanfragen, deshalb braucht der erste Schritt ein wenig C++. Dieser Leitfaden baut einen von Blueprints aufrufbaren ChatGPT-Knoten mit dem HTTP-Modul von Unreal und zeigt dann, was es braucht, um ihn auszuliefern, und wie derselbe NPC mit dem Neocortex-Plugin aussieht.
Weg 1: ein ChatGPT-Knoten für Blueprints
Sie brauchen ein C++-Projekt, einen OpenAI-API-Schlüssel und die Module HTTP und Json, die in Ihrer Build.cs zu PublicDependencyModuleNames hinzugefügt werden. Diese Komponente sendet eine Zeile des Spielers an den Endpunkt für Chat Completions und löst ein Blueprint-Ereignis mit der Antwort aus:
// 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();
}Fügen Sie die Komponente Ihrem NPC hinzu, setzen Sie SystemPrompt ("You are Brannoch, a gruff blacksmith...") und den Schlüssel, und rufen Sie in Blueprints Ask auf und binden Sie On Reply an Ihr Dialog-Widget. Ersetzen Sie MODEL_NAME durch ein aktuelles Modell aus der Dokumentation von OpenAI. Die Antwort kommt im Game-Thread an, deshalb ist es sicher, die Oberfläche aus dem Ereignis heraus zu aktualisieren.
Das sendet jeweils eine Zeile. Für ein Gespräch halten Sie ein Array von Nachrichten und senden alle bei jeder Anfrage mit.
Was Sie selbst bauen müssen
- Den Schlüssel. Ein Schlüssel, der im Spiel verpackt ist, lässt sich auslesen und verbraucht Ihr gesamtes OpenAI-Konto. Sie brauchen einen eigenen Server zwischen Spiel und API.
- Die Stimme. Sprache-zu-Text für den Spieler, Text-to-Speech für die Antwort, das Dekodieren des Audios in eine Sound Wave und eine kurze Wartezeit. Siehe wie die Sprachpipeline für KI-NPCs funktioniert.
- Emotion und Aktionen. Die Antwort ist reiner Text. Um Animation und Spielmechanik zu steuern, fordern Sie JSON an, parsen es und behandeln die Fälle, in denen es fehlerhaft ist.
- Verlauf und Kosten. Jede Nachricht macht die nächste Anfrage größer, langsamer und teurer.
- Die Figur halten. Spieler werden innerhalb von Minuten versuchen, einen System-Prompt zu brechen. Siehe wie Sie KI-NPCs in ihrer Rolle halten.
Weg 2: derselbe NPC mit dem Neocortex-Plugin
Mit Neocortex wird die Figur in einem Browser-Editor entworfen, mit Persönlichkeit, Welt, Wissensbasis, Stimme und Aktionen, und das Unreal-Plugin stellt Ihnen für den Rest Blueprint-Knoten bereit:
- Klonen Sie das Plugin in den Ordner
PluginsIhres Projekts, aktivieren Sie es und fügen Sie"Neocortex"zu IhrerBuild.cshinzu. - Fügen Sie Ihren API-Schlüssel unter Project Settings > Game > Neocortex ein.
- Fügen Sie dem NPC eine Komponente Neocortex Smart Agent hinzu und setzen Sie ihre Project Id.
- Rufen Sie Send Message For Audio mit der Zeile des Spielers auf.
- Binden Sie On Chat für Text, Emotion und Aktion und On Audio für eine Sound Wave, die Sie mit Set Sound und Play abspielen.
Für Spracheingabe nimmt die Komponente Neocortex Microphone Recorder den Spieler auf und transkribiert ihn, sodass eine Push-to-Talk-Taste aus drei Blueprint-Knoten besteht. Die vollständige Anleitung steht unter wie Sie KI-NPCs zu Unreal Engine 5 hinzufügen.
Im direkten Vergleich
| OpenAI-API aus C++ | Neocortex-Unreal-Plugin | |
|---|---|---|
| Erste Antwort | Eine C++-Komponente und JSON-Parsing | Blueprint-Knoten |
| Stimme ein und aus | Selbst bauen | Recorder-Komponente, Sound Wave heraus |
| Emotion | Prompt und Parsing | Bei jeder Antwort |
| Aktionen | JSON anfordern und prüfen | Im Editor definiert, als Schlüsselwort gesendet |
| Gesprächsverlauf | Ihr Array, das wächst | In einer Sitzung pro Figur gehalten |
| Schutz des Schlüssels | Ihr eigener Server | Limits pro Spieler und pro Figur für jeden Schlüssel |
| Figurendesign | Ein System-Prompt | Visueller Editor mit Test im Browser |
Häufige Fragen zum Selbermachen
- „Die Anfrage kommt nie zurück.“ Prüfen Sie, ob das
HTTP-Modul in IhrerBuild.cssteht und die Anfrage nicht vom Garbage Collector eingesammelt wird: Halten Sie den Aufruf in einer Komponente, die so lange lebt wie der NPC. - „Das JSON bricht bei Anführungszeichen.“ Bauen Sie den Body mit
FJsonObjectauf, wie oben, statt Zeichenketten von Hand zusammenzusetzen. Spieler tippen ständig Apostrophe und Anführungszeichen. - „Kann ich das in reinen Blueprint-Projekten nutzen?“ Nicht ohne C++ oder ein HTTP-Plugin eines Drittanbieters.
Nächste Schritte
Für die Gestaltung lesen Sie wie Sie NPCs eigene Persönlichkeiten geben und wie KI-NPCs auf das handeln, was sie sagen. Alle Anleitungen finden Sie im Leitfaden zum Bau von KI-NPCs.
Geprüft im November 2026. Neocortex ist nicht mit OpenAI oder Epic Games verbunden.
Häufig gestellte Fragen
Kann ich ChatGPT in Unreal-Engine-Blueprints nutzen?
Nicht mit eingebauten Knoten. Unreal hat keinen Blueprint-Knoten für HTTP-Anfragen, deshalb schreiben Sie eine kleine C++-Funktion mit dem HTTP-Modul und machen sie für Blueprints verfügbar, oder Sie installieren ein Plugin. Das Neocortex-Plugin bietet eine vollständige KI-Figur mit Blueprint-Knoten und Stimme.
Brauche ich C++, um aus Unreal ein Sprachmodell aufzurufen?
Für einen direkten API-Aufruf reichen ein paar Zeilen C++ oder ein HTTP-Plugin eines Drittanbieters. Bei Neocortex muss das Projekt ein C++-Projekt sein, damit das Plugin kompiliert, aber alles, was Sie nutzen, ist ein Blueprint-Knoten.
Ist es sicher, einen OpenAI-API-Schlüssel in ein Unreal-Spiel zu legen?
Nein. Alles, was mit dem Spiel ausgeliefert wird, lässt sich auslesen, und ein OpenAI-Schlüssel gibt vollen Zugriff auf die Ausgaben Ihres Kontos. Leiten Sie Aufrufe über Ihren eigenen Server. Neocortex-Schlüssel können Nutzungsgrenzen pro Spieler und pro Figur tragen, die unsere Server durchsetzen, und Sie können einen Schlüssel im Dashboard deaktivieren.
Wie gebe ich einer ChatGPT-NPC in Unreal eine Stimme?
Sie würden Sprache-zu-Text für den Spieler und Text-to-Speech für die Antwort hinzufügen und das Audio dann in eine Sound Wave umwandeln. Das Neocortex-Plugin liefert die Antwort als Sound Wave, die Sie abspielen können, und nimmt die Stimme des Spielers auf und transkribiert sie.






