Cara Pakai ChatGPT di Blueprint Unreal Engine
Pakai ChatGPT di Blueprint Unreal Engine: panggil API OpenAI dari node C++, buka ke Blueprint, dan bandingkan dengan NPC bersuara dari plugin Neocortex.
Sercan AltundasFounder of Neocortex
· 9 menit baca

"Bagaimana cara memakai ChatGPT di Blueprint Unreal?" biasanya berarti: biarkan pemain berbicara dengan NPC dan biarkan model bahasa yang menjawab. Unreal tidak punya node Blueprint untuk permintaan web, jadi langkah pertama adalah sedikit C++. Panduan ini membangun node ChatGPT yang bisa dipanggil dari Blueprint dengan modul HTTP milik Unreal, lalu menunjukkan apa saja yang dibutuhkan untuk merilisnya dan bagaimana NPC yang sama terlihat dengan plugin Neocortex.
Jalur 1: node ChatGPT untuk Blueprint
Anda membutuhkan proyek C++, API key OpenAI, dan modul HTTP serta Json yang ditambahkan ke PublicDependencyModuleNames di Build.cs Anda. Komponen ini mengirim satu baris pemain ke endpoint chat completions dan memunculkan event Blueprint dengan jawabannya:
// 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();
}Tambahkan komponen ke NPC Anda, atur SystemPrompt ("Anda adalah Brannoch, pandai besi yang kasar...") dan key-nya, lalu di Blueprint panggil Ask dan bind On Reply ke widget dialog Anda. Ganti MODEL_NAME dengan model terkini dari dokumentasi OpenAI. Respons tiba di game thread, jadi aman untuk memperbarui UI dari event tersebut.
Ini hanya mengirim satu baris dalam satu waktu. Untuk percakapan, simpan array pesan dan kirim semuanya di setiap permintaan.
Yang masih harus Anda bangun
- Key-nya. Key yang dikemas bersama game bisa diekstrak dan menghabiskan seluruh akun OpenAI Anda. Anda membutuhkan server sendiri di antara game dan API.
- Suara. Speech-to-text untuk pemain, text-to-speech untuk balasan, mendekode audio menjadi Sound Wave, dan menjaga agar waktu tunggu tetap singkat. Lihat cara kerja pipeline suara NPC AI.
- Emosi dan aksi. Balasannya berupa teks biasa. Untuk menggerakkan animasi dan gameplay, Anda meminta prompt menghasilkan JSON lalu mem-parsing-nya, dan menangani saat hasilnya rusak.
- Riwayat dan biaya. Setiap pesan membuat permintaan berikutnya lebih besar, lebih lambat, dan lebih mahal.
- Tetap dalam karakter. Pemain akan mencoba merusak system prompt dalam hitungan menit. Lihat cara menjaga NPC AI tetap dalam karakter.
Jalur 2: NPC yang sama dengan plugin Neocortex
Dengan Neocortex, karakter dirancang di editor browser, dengan kepribadian, dunia, basis pengetahuan, suara, dan aksi, dan plugin Unreal memberi Anda node Blueprint untuk sisanya:
- Salin plugin ke folder
Pluginsproyek Anda, aktifkan, dan tambahkan"Neocortex"keBuild.csAnda. - Tempelkan API key Anda di Project Settings > Game > Neocortex.
- Tambahkan komponen Neocortex Smart Agent ke NPC dan atur Project Id-nya.
- Panggil Send Message For Audio dengan baris pemain.
- Bind On Chat untuk teks, emosi, dan aksi, serta On Audio untuk Sound Wave yang Anda putar dengan Set Sound dan Play.
Untuk input suara, komponen Neocortex Microphone Recorder merekam dan mentranskripsikan pemain, sehingga tombol push-to-talk cukup tiga node Blueprint. Panduan lengkapnya ada di cara menambahkan NPC AI ke Unreal Engine 5.
Berdampingan
| OpenAI API dari C++ | Plugin Unreal Neocortex | |
|---|---|---|
| Balasan pertama | Komponen C++ dan parsing JSON | Node Blueprint |
| Suara masuk dan keluar | Bangun sendiri | Komponen recorder, Sound Wave keluar |
| Emosi | Prompt lalu parse | Ada di setiap balasan |
| Aksi | Prompt untuk JSON lalu validasi | Didefinisikan di editor, dikirim sebagai kata kunci |
| Riwayat percakapan | Array Anda, terus membesar | Disimpan dalam sesi per karakter |
| Perlindungan key | Server Anda sendiri | Batas per pemain dan per karakter untuk setiap key |
| Desain karakter | System prompt | Editor visual dengan pengujian di browser |
Pertanyaan umum untuk jalur buatan sendiri
- "Permintaannya tidak pernah kembali." Pastikan modul
HTTPada diBuild.csAnda dan permintaan tidak dibersihkan oleh garbage collector: simpan pemanggilan di dalam komponen yang berumur sama dengan NPC. - "JSON-nya rusak karena tanda kutip." Bangun body dengan
FJsonObject, seperti di atas, alih-alih memformat string dengan tangan. Pemain terus-menerus mengetik apostrof dan tanda kutip. - "Bisakah saya memanggilnya dari proyek yang hanya memakai Blueprint?" Tidak, kecuali dengan C++ atau plugin HTTP pihak ketiga.
Langkah berikutnya
Untuk sisi desainnya, baca cara memberi NPC kepribadian yang unik dan cara membuat NPC AI bertindak atas apa yang mereka katakan. Setiap tutorial ada di panduan membangun NPC AI.
Diperiksa November 2026. Neocortex tidak berafiliasi dengan OpenAI atau Epic Games.
Pertanyaan yang sering diajukan
Bisakah saya memakai ChatGPT di Blueprint Unreal Engine?
Tidak dengan node bawaan. Unreal tidak punya node Blueprint untuk permintaan HTTP, jadi Anda menulis fungsi C++ kecil dengan modul HTTP dan membukanya ke Blueprint, atau memasang plugin. Plugin Neocortex memberi Anda karakter AI lengkap dengan node Blueprint dan suara.
Apakah saya perlu C++ untuk memanggil LLM dari Unreal?
Untuk pemanggilan API langsung, beberapa baris C++ atau plugin HTTP pihak ketiga. Dengan Neocortex, proyeknya harus berupa proyek C++ agar plugin bisa dikompilasi, tetapi semua yang Anda pakai adalah node Blueprint.
Apakah aman meletakkan API key OpenAI di dalam game Unreal?
Tidak. Apa pun yang dikemas bersama game bisa diekstrak, dan key OpenAI memberi akses penuh ke pengeluaran akun Anda. Arahkan pemanggilan lewat server Anda sendiri. Key Neocortex dapat membawa batas pemakaian per pemain dan per karakter yang ditegakkan server kami, dan Anda bisa menonaktifkan key dari dasbor.
Bagaimana cara memberi suara pada NPC ChatGPT di Unreal?
Anda menambahkan speech-to-text untuk pemain dan text-to-speech untuk balasan, lalu mengubah audionya menjadi Sound Wave. Plugin Neocortex mengembalikan balasan sebagai Sound Wave yang bisa Anda putar, dan ia merekam serta mentranskripsikan suara pemain.






