Как использовать ChatGPT в Blueprints Unreal Engine
Используйте ChatGPT в Blueprints Unreal Engine: вызывайте OpenAI API из узла на C++, открывайте его для Blueprints и сравните с озвученным NPC из плагина Neocortex.
Sercan AltundasFounder of Neocortex
· 9 мин чтения

«Как использовать ChatGPT в Blueprints Unreal?» обычно означает: дать игрокам говорить с NPC, а языковой модели - отвечать. В Unreal нет узла Blueprint для веб-запросов, поэтому первый шаг - немного C++. Это руководство собирает узел ChatGPT, который можно вызывать из Blueprint, с помощью HTTP-модуля Unreal, затем показывает, что нужно для выпуска игры, и как тот же NPC выглядит с плагином Neocortex.
Вариант 1: узел ChatGPT для Blueprints
Нужны проект на C++, ключ API OpenAI и модули HTTP и Json, добавленные в PublicDependencyModuleNames в вашем Build.cs. Этот компонент отправляет одну реплику игрока на эндпоинт chat completions и вызывает событие Blueprint с ответом:
// 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();
}Добавьте компонент к NPC, задайте SystemPrompt («Ты - Brannoch, сварливый кузнец...») и ключ, а в Blueprints вызовите Ask и привяжите On Reply к вашему виджету диалога. Замените MODEL_NAME актуальной моделью из документации OpenAI. Ответ приходит в игровом потоке, поэтому обновлять интерфейс из события безопасно.
Это отправляет по одной реплике за раз. Для разговора храните массив сообщений и отправляйте все их с каждым запросом.
Что остаётся на вашей стороне
- Ключ. Ключ, упакованный с игрой, можно извлечь, и он расходует весь ваш аккаунт OpenAI. Между игрой и API нужен собственный сервер.
- Голос. Речь в текст для игрока, текст в речь для ответа, декодирование аудио в Sound Wave и короткое ожидание. См. как устроен конвейер голоса ИИ-NPC.
- Эмоции и действия. Ответ - простой текст. Чтобы управлять анимацией и игровой логикой, вы просите JSON и разбираете его, а затем обрабатываете случаи, когда он составлен неверно.
- История и стоимость. Каждое сообщение делает следующий запрос больше, медленнее и дороже.
- Оставаться в образе. Игроки попытаются сломать системный промпт в течение нескольких минут. См. как удерживать ИИ-NPC в образе.
Вариант 2: тот же NPC с плагином Neocortex
С Neocortex персонаж проектируется в браузерном редакторе: с личностью, миром, базой знаний, голосом и действиями. Плагин Unreal даёт узлы Blueprint для остального:
- Клонируйте плагин в папку
Pluginsвашего проекта, включите его и добавьте"Neocortex"вBuild.cs. - Вставьте ключ API в Project Settings > Game > Neocortex.
- Добавьте компонент Neocortex Smart Agent к NPC и задайте его Project Id.
- Вызовите Send Message For Audio с репликой игрока.
- Привяжите On Chat для текста, эмоции и действия, а On Audio - для Sound Wave, которую проигрываете через Set Sound и Play.
Для голосового ввода компонент Neocortex Microphone Recorder записывает и расшифровывает игрока, поэтому кнопка push to talk - это три узла Blueprint. Подробная инструкция есть в посте как добавить ИИ-NPC в Unreal Engine 5.
Бок о бок
| OpenAI API из C++ | Плагин Neocortex для Unreal | |
|---|---|---|
| Первый ответ | Компонент на C++ и разбор JSON | Узлы Blueprint |
| Голос на входе и выходе | Сделать самостоятельно | Компонент записи, Sound Wave на выходе |
| Эмоции | Промпт и разбор | В каждом ответе |
| Действия | Промпт для JSON и проверка | Заданы в редакторе, отправляются как ключевое слово |
| История разговора | Ваш массив, растущий | Хранится в сессии для каждого персонажа |
| Защита ключа | Ваш собственный сервер | Лимиты на каждого игрока и каждого персонажа для каждого ключа |
| Дизайн персонажа | Системный промпт | Визуальный редактор с тестированием в браузере |
Частые вопросы по варианту «сделай сам»
- «Запрос никогда не возвращается». Проверьте, что модуль
HTTPесть в вашемBuild.cs, и что запрос не уничтожается сборщиком мусора: держите вызов внутри компонента, который живёт столько же, сколько NPC. - «JSON ломается на кавычках». Собирайте тело через
FJsonObject, как выше, а не форматируйте строки вручную. Игроки постоянно печатают апострофы и кавычки. - «Можно ли вызывать это в проектах только на Blueprint?» Нет, без C++ или стороннего HTTP-плагина нельзя.
Что дальше
Для дизайна читайте как дать NPC уникальные личности и как заставить ИИ-NPC действовать по сказанному. Все руководства собраны в гайде по созданию ИИ-NPC.
Проверено в ноябре 2026 года. Neocortex не связан с OpenAI и Epic Games.
Частые вопросы
Можно ли использовать ChatGPT в Blueprints Unreal Engine?
Не встроенными узлами. В Unreal нет узла Blueprint для HTTP-запросов, поэтому вы пишете небольшую функцию на C++ с HTTP-модулем и открываете её для Blueprints, или ставите плагин. Плагин Neocortex даёт полноценного ИИ-персонажа с узлами Blueprint и голосом.
Нужен ли C++, чтобы вызывать LLM из Unreal?
Для прямого вызова API - несколько строк C++ или сторонний HTTP-плагин. С Neocortex проект должен быть проектом на C++, чтобы плагин компилировался, но всё, что вы используете, - это узлы Blueprint.
Безопасно ли вписывать ключ API OpenAI в игру на Unreal?
Нет. Всё, что упаковано с игрой, можно извлечь, а ключ OpenAI даёт полный доступ к расходам вашего аккаунта. Направляйте вызовы через собственный сервер. Ключи Neocortex могут иметь лимиты использования для каждого игрока и каждого персонажа, которые наши серверы соблюдают, а ключ можно деактивировать в панели.
Как дать ChatGPT-NPC голос в Unreal?
Нужно добавить речь в текст для игрока и текст в речь для ответа, а затем превратить аудио в Sound Wave. Плагин Neocortex возвращает ответ как Sound Wave, которую можно проиграть, и записывает и расшифровывает голос игрока.






