Jak używać ChatGPT w Blueprints w Unreal Engine
Używaj ChatGPT w Blueprints Unreal Engine: wywołaj API OpenAI z węzła C++, udostępnij go w Blueprints i porównaj z mówiącym NPC z wtyczki Neocortex.
Sercan AltundasFounder of Neocortex
· 9 min czytania

"Jak użyć ChatGPT w Blueprints Unreal?" zwykle oznacza: pozwolić graczom rozmawiać z NPC, a model językowy ma odpowiadać. Unreal nie ma węzła Blueprint do żądań sieciowych, więc pierwszym krokiem jest odrobina C++. Ten przewodnik buduje węzeł ChatGPT wywoływalny z Blueprints, używając modułu HTTP Unreala, potem pokazuje, co trzeba zrobić, by go wydać, i jak ten sam NPC wygląda z wtyczką Neocortex.
Droga 1: węzeł ChatGPT dla Blueprints
Potrzebujesz projektu C++, klucza API OpenAI oraz modułów HTTP i Json dodanych do PublicDependencyModuleNames w pliku Build.cs. Ten komponent wysyła jedną linię gracza do endpointu chat completions i wywołuje zdarzenie Blueprint z odpowiedzią:
// 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();
}Dodaj komponent do swojego NPC, ustaw SystemPrompt ("You are Brannoch, a gruff blacksmith...") i klucz, a w Blueprints wywołaj Ask i podłącz On Reply do swojego widgetu dialogowego. Zamień MODEL_NAME na aktualny model z dokumentacji OpenAI. Odpowiedź przychodzi w wątku gry, więc aktualizowanie interfejsu z tego zdarzenia jest bezpieczne.
To wysyła jedną linię naraz. Przy rozmowie trzymaj tablicę wiadomości i wysyłaj wszystkie w każdym żądaniu.
Co zostaje do zbudowania
- Klucz. Klucz spakowany z grą można wyciągnąć i wydać nim cały Twój rachunek OpenAI. Potrzebujesz własnego serwera między grą a API.
- Głos. Zamiana mowy na tekst dla gracza, zamiana tekstu na mowę dla odpowiedzi, dekodowanie audio do Sound Wave i utrzymanie krótkiego czekania. Zobacz jak działa potok głosu NPC AI.
- Emocje i akcje. Odpowiedź to zwykły tekst. Aby sterować animacją i rozgrywką, musisz prosić o JSON, parsować go i obsługiwać przypadki, gdy jest źle sformatowany.
- Historia i koszt. Każda wiadomość sprawia, że następne żądanie jest większe, wolniejsze i droższe.
- Trzymanie się postaci. Gracze spróbują złamać prompt systemowy w ciągu kilku minut. Zobacz jak utrzymać NPC AI w roli.
Droga 2: ten sam NPC z wtyczką Neocortex
W Neocortex postać projektuje się w edytorze w przeglądarce, z osobowością, światem, bazą wiedzy, głosem i akcjami, a wtyczka Unreal daje węzły Blueprint do reszty:
- Sklonuj wtyczkę do folderu
Pluginsprojektu, włącz ją i dodaj"Neocortex"doBuild.cs. - Wklej swój klucz API w Project Settings > Game > Neocortex.
- Dodaj komponent Neocortex Smart Agent do NPC i ustaw jego Project Id.
- Wywołaj Send Message For Audio z linią gracza.
- Podłącz On Chat dla tekstu, emocji i akcji oraz On Audio dla Sound Wave, który odtworzysz przez Set Sound i Play.
Do wejścia głosowego komponent Neocortex Microphone Recorder nagrywa i transkrybuje gracza, więc przycisk push to talk to trzy węzły Blueprint. Pełne omówienie znajdziesz w jak dodać NPC AI do Unreal Engine 5.
Obok siebie
| API OpenAI z C++ | Wtyczka Neocortex dla Unreal | |
|---|---|---|
| Pierwsza odpowiedź | Komponent C++ i parsowanie JSON | Węzły Blueprint |
| Głos na wejściu i wyjściu | Zbuduj sam | Komponent nagrywania, Sound Wave na wyjściu |
| Emocje | Prompt i parsowanie | Przy każdej odpowiedzi |
| Akcje | Prompt o JSON i walidacja | Zdefiniowane w edytorze, wysyłane jako słowo kluczowe |
| Historia rozmowy | Twoja tablica, rosnąca | Przechowywana w sesji dla każdej postaci |
| Ochrona klucza | Własny serwer | Limity na gracza i na postać dla każdego klucza |
| Projektowanie postaci | Prompt systemowy | Wizualny edytor z testowaniem w przeglądarce |
Częste pytania o drogę zrób-to-sam
- "Żądanie nigdy nie wraca." Sprawdź, czy moduł
HTTPjest wBuild.csi czy żądanie nie jest usuwane przez garbage collection: trzymaj wywołanie w komponencie, który żyje tak długo jak NPC. - "JSON psuje się przy cudzysłowach." Buduj treść przez
FJsonObject, jak wyżej, zamiast składać stringi ręcznie. Gracze cały czas wpisują apostrofy i cudzysłowy. - "Czy mogę to wywołać w projekcie tylko z Blueprintów?" Nie bez C++ albo wtyczki HTTP od firmy trzeciej.
Dalsze kroki
Od strony projektowej przeczytaj jak nadać NPC unikalne osobowości i jak sprawić, by NPC AI działały na to, co mówią. Wszystkie samouczki znajdziesz w przewodniku po budowaniu NPC AI.
Sprawdzono w listopadzie 2026. Neocortex nie jest powiązany z OpenAI ani Epic Games.
Najczęściej zadawane pytania
Czy mogę używać ChatGPT w Blueprints Unreal Engine?
Nie wbudowanymi węzłami. Unreal nie ma węzła Blueprint do żądań HTTP, więc piszesz małą funkcję C++ z modułem HTTP i udostępniasz ją Blueprints albo instalujesz wtyczkę. Wtyczka Neocortex daje pełną postać AI z węzłami Blueprint i głosem.
Czy do wywołania LLM z Unreal potrzebuję C++?
Do bezpośredniego wywołania API kilka linijek C++ albo wtyczka HTTP od firmy trzeciej. Przy Neocortex projekt musi być projektem C++, żeby wtyczka się skompilowała, ale wszystko, czego używasz, to węzły Blueprint.
Czy bezpiecznie jest umieścić klucz API OpenAI w grze Unreal?
Nie. Wszystko spakowane z grą można wyciągnąć, a klucz OpenAI daje pełny dostęp do wydatków Twojego konta. Kieruj wywołania przez własny serwer. Klucze Neocortex mogą mieć limity użycia na gracza i na postać, które egzekwują nasze serwery, a klucz można wyłączyć z panelu.
Jak nadać głos NPC ChatGPT w Unreal?
Dodałbyś zamianę mowy na tekst dla gracza i zamianę tekstu na mowę dla odpowiedzi, a potem zamieniłbyś audio w Sound Wave. Wtyczka Neocortex zwraca odpowiedź jako Sound Wave, który można odtworzyć, a także nagrywa i transkrybuje głos gracza.






