Neocortex Logo

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

Pakai ChatGPT di Blueprint Unreal Engine: panggil API OpenAI dari node C++, buka ke Blueprint, dan bandingkan dengan NPC bersuara dari plugin Neocortex.

"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:

  1. Salin plugin ke folder Plugins proyek Anda, aktifkan, dan tambahkan "Neocortex" ke Build.cs Anda.
  2. Tempelkan API key Anda di Project Settings > Game > Neocortex.
  3. Tambahkan komponen Neocortex Smart Agent ke NPC dan atur Project Id-nya.
  4. Panggil Send Message For Audio dengan baris pemain.
  5. 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 pertamaKomponen C++ dan parsing JSONNode Blueprint
Suara masuk dan keluarBangun sendiriKomponen recorder, Sound Wave keluar
EmosiPrompt lalu parseAda di setiap balasan
AksiPrompt untuk JSON lalu validasiDidefinisikan di editor, dikirim sebagai kata kunci
Riwayat percakapanArray Anda, terus membesarDisimpan dalam sesi per karakter
Perlindungan keyServer Anda sendiriBatas per pemain dan per karakter untuk setiap key
Desain karakterSystem promptEditor visual dengan pengujian di browser

Pertanyaan umum untuk jalur buatan sendiri

  • "Permintaannya tidak pernah kembali." Pastikan modul HTTP ada di Build.cs Anda 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.

Artikel serupa

Baca juga