Mod NPC AI Half-Life 2: Skuad dan Pendamping dengan Perintah Suara
Rencanakan mod NPC AI Half-Life 2 di Source SDK 2013: skuad pemberontak yang Anda komando dengan suara, pendamping yang membalas bicara, adegan cerita di safehouse dan terminal kuis.
Neocortex TeamThe team behind Neocortex
· 6 menit baca

Half-Life 2 punya AI skuad yang hanya merespons tombol yang ditekan, dan dunia yang penuh orang yang hanya mengatakan apa yang diizinkan skrip. Pemberontak mengikuti Anda, tetapi Anda tidak bisa memberi mereka instruksi; warga sipil berbicara, tetapi tidak pernah tentang apa yang baru saja terjadi. Mod NPC AI Half-Life 2 memperbaiki keduanya: pemberontak yang merespons perintah Anda dengan suara, pendamping yang membicarakan pertempuran yang baru saja Anda lewati, dan adegan cerita yang berubah sesuai pilihan pemain. Neocortex menambahkan karakter AI, Conversation Flows, kuis, dan perintah suara di perangkat, sedangkan Source SDK 2013 memberi Anda kode untuk menghubungkannya.
Tangkapan layar: Half-Life 2 © Valve
Perintah suara untuk skuad pemberontak
Half-Life 2 sudah memungkinkan Anda mengirim skuad ke suatu titik dan memanggil mereka kembali. Perintah suara menggantikan penekanan tombol dengan ucapan: "maju", "tahan di sini", "ambil perlindungan di belakang mobil", "kumpul di aku".
Di dashboard Neocortex, Anda merancang kumpulan perintah sebagai aktor, aksi dan objek: aktor "squad", aksi "move", "hold" dan "cover", objek seperti "me", "car" dan "door". Pemain berbicara dengan alami, dan mod menerima perintah yang cocok seketika, termasuk beberapa aksi dan jumlah dalam satu kalimat: "dua dari kalian jaga pintu, sisanya ikut aku". Kode Anda memetakannya ke kode skuad yang sudah ada.
Fitur ini bekerja dengan push-to-talk atau selalu mendengarkan, dalam banyak bahasa, dan berjalan di mesin pemain, sehingga perintah sampai di tengah baku tembak tanpa perjalanan pulang-pergi ke cloud.
Voice Commands adalah SDK berlisensi: hubungi kami untuk lisensi Voice Commands.
Contoh kerja: Mara Venn dan safehouse
Pendampingnya. Buat pendamping orisinal, misalnya Mara Venn, mantan medis lapangan yang bergabung dengan perlawanan setelah kliniknya ditutup. Mod Anda mengirim pertanyaan pemain bersama apa yang diketahui game: objek terdekat (barikade, peti amunisi, radio) dan kejadian terbaru ("dua anggota skuad tumbang", "pemain mengambil terowongan kiri", "health di bawah 30"). Mara menjawab dengan suara dan tag emosi pada setiap baris, dan bisa mengembalikan aksi seperti menyerahkan medkit atau membuka gerbang yang diminta pemain.
Skuad ikut berdebat. Group chat (paket Pro dan Team) memungkinkan hingga enam karakter berbagi satu percakapan, sehingga seluruh skuad bisa berdebat tentang langkah berikutnya.
Ruang bawah tanah. Mara memimpin pemain ke safehouse di ruang bawah tanah, tempat mereka harus mendapatkan kepercayaan seorang pemimpin sel yang waspada sebelum ia membagikan rute keluar kota. Conversation Flow mendefinisikan beat-beatnya: perkenalan, membuktikan di pihak mana Anda berdiri, kesepakatan, dan rute. Karakter mengarahkan percakapan melewati beat-beat itu apa pun cara pemain mengucapkannya, dan API mengembalikan kata kunci checkpoint seperti TRUST_EARNED atau ROUTE_SHARED. Mod Anda bereaksi dengan membuka pintu tersembunyi atau memunculkan pemandu yang menuntun Anda keluar.
Terminalnya. Di sudut ruangan, sebuah terminal melatih rekrut baru: unit musuh mana yang harus dihindari, cara memberi sinyal kepada skuad, perbekalan apa yang harus dibawa. Mesin kuis Neocortex (paket Team) menjalankan pertanyaan dan penilaian, dan rangkaian jawaban benar bisa memberi pemain amunisi atau jalan pintas.
Tangkapan layar: Half-Life 2 © Valve
Cabang Source SDK 2013 untuk mod NPC AI Half-Life 2
Half-Life 2 berjalan di Source. Sebuah mod adalah folder dengan gameinfo.txt-nya sendiri, konten, dan dua library C++ yang dibangun dari kode Valve: DLL server untuk AI NPC, skuad, dan logika game, serta DLL klien untuk HUD, panel VGUI, dan efek lokal. Pilih basis sebelum hal lainnya:
| Basis | Isinya | Status |
|---|---|---|
Cabang singleplayer Source SDK 2013 | Kode singleplayer Half-Life 2 | Tidak ada pembaruan kode sejak 2015; berjalan di Source SDK Base 2013 Singleplayer 32-bit |
Cabang master Source SDK 2013 | Kode multiplayer | Diperbarui pada Februari 2025 dengan kode game Team Fortress 2 dan build 64-bit; Valve masih berkomitmen padanya |
| Mapbase | Basis yang dikelola komunitas untuk mod singleplayer | Versi 8.0 dirilis pada Juli 2025, menambahkan entitas baru, perbaikan, dan implementasi VScript untuk skrip peta |
Untuk mod cerita seperti safehouse di atas, mulailah dari cabang singleplayer atau Mapbase.
Memanggil Neocortex dari DLL Source
Header SDK menyertakan antarmuka HTTP Steamworks, dan banyak modder menambahkan libcurl sebagai gantinya. Apa pun pilihannya, jalankan permintaan di worker thread dan kembalikan hasilnya ke game loop. Berikut panggilan chat dari DLL klien atau server, menggunakan libcurl:
// bodyJson: {"characterIds":["CHARACTER_ID"],"message":"Where now?","playerId":"player-1",
// "sessionId":"","events":[{"priority":1,"content":"Two squad members down"}]}
std::string AskCompanion(const std::string& apiKey, const std::string& bodyJson)
{
std::string response;
CURL* curl = curl_easy_init();
curl_slist* headers = curl_slist_append(nullptr, "Content-Type: application/json");
headers = curl_slist_append(headers, ("x-api-key: " + apiKey).c_str());
curl_easy_setopt(curl, CURLOPT_URL, "https://api.neocortex.link/v3/chat");
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, bodyJson.c_str());
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, AppendToString); // appends bytes to response
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
curl_easy_perform(curl);
curl_slist_free_all(headers);
curl_easy_cleanup(curl);
return response; // sessionId, lines with emotions, actions and flowState
}Mod membaca status game dan mengirimkannya bersama pesan pemain ke karakter Neocortex melalui /v3/chat, menampilkan balasan sebagai subtitle, memutar suara dari /v3/audio/generate atau /v3/audio/stream, dan menjalankan aksi yang dikembalikan karakter. Conversation Flows mengembalikan kata kunci checkpoint (flowState) dalam balasan yang sama, mesin kuis berjalan melalui /v3/quiz, dan perintah suara di perangkat mengubah frasa yang diucapkan menjadi aksi game tanpa perjalanan pulang-pergi ke cloud, dengan Neocortex Voice Commands berjalan di mesin pemain.
Untuk UI, panel VGUI di DLL klien bisa menampilkan subtitle dan layar kuis. Closed captions dan soundscripts milik Source dibuat untuk baris yang sudah ditulis sebelumnya, jadi balasan AI langsung biasanya mendapat panel subtitle tersendiri, dengan audio yang dihasilkan disimpan ke file dan diputar melalui engine.
Sebelum rilis: lisensi Source 1 SDK
Lisensi Source 1 SDK hanya mengizinkan distribusi mod secara gratis; mod gratis boleh diterbitkan di Steam. Jaga agar mod NPC AI tetap singleplayer, jangan pernah memakainya di server multiplayer yang melanggar aturannya, dan minta setiap pemain memakai API key Neocortex miliknya sendiri.
Dari peta kosong ke skuad yang berbicara
- Siapkan Source SDK 2013. Pilih cabang
singleplayeratau Mapbase untuk mod cerita, bangun, lalu luncurkan peta uji kosong. - Rancang karakter Anda di dashboard Neocortex: pendamping, pemimpin sel dengan Conversation Flow, kuis untuk terminal, dan kumpulan perintah untuk skuad.
- Panggil API dari DLL game di worker thread dan gunakan kembali
sessionIddari setiap balasan. - Simpan API key di file konfigurasi yang diisi pemain, jangan pernah ditulis langsung di mod yang Anda bagikan.
- Hubungkan subtitle, suara dan aksi, lalu petakan perintah suara ke kode skuad yang sudah ada.
- Uji dalam singleplayer pada satu peta sebelum memperluas ke kampanye penuh.
Untuk melihat cara perintah suara bekerja dalam mod, baca perintah suara di perangkat untuk mod game. Untuk GoldSrc, lihat panduan mod NPC AI Half-Life kami, dan untuk server sandbox Source, lihat postingan addon NPC AI dan kuis Garry's Mod. Mara dan skuadnya bisa diuji di editor browser Neocortex hari ini, jauh sebelum peta pertama selesai dikompilasi.
Versi alat dan tautan diperiksa Oktober 2026. Alat modding sering berubah; periksa halaman setiap proyek untuk rilis terbaru.
Pertanyaan yang sering diajukan
Bisakah menambahkan NPC AI ke Half-Life 2?
Bisa. Mod Half-Life 2 dibangun dari Source SDK 2013 milik Valve, yang memberikan kode game C++ lengkap, sehingga sebuah mod bisa memanggil web API dan bertindak berdasarkan balasannya. Neocortex menyediakan karakter AI, suaranya, dan aksi yang dikembalikannya, sedangkan mod Anda yang menjalankannya.
Sebaiknya memakai cabang singleplayer atau multiplayer dari Source SDK 2013?
Mod cerita biasanya dimulai dari cabang singleplayer atau basis komunitas yang dibangun di atasnya, seperti Mapbase. Cabang multiplayer mendapat pembaruan besar dengan dukungan 64-bit pada 2025 dan masih dikelola, tetapi kodenya ditujukan untuk game multiplayer. Neocortex bisa dipakai dengan keduanya, karena ia adalah web API biasa.
Bisakah saya memberi perintah kepada pemberontak Half-Life 2 dengan suara?
Bisa, dengan sebuah mod. Half-Life 2 sudah punya kode perintah skuad, dan mod bisa memicunya dari ucapan. Neocortex Voice Commands mencocokkan frasa alami di PC pemain, sehingga "maju", "tahan di sini" dan "kumpul" sampai ke kode Anda seketika dan secara offline.
Bisakah saya menjual mod Half-Life 2 dengan karakter AI?
Tidak. Lisensi Source 1 SDK hanya mengizinkan distribusi mod secara gratis, meskipun mod gratis boleh diterbitkan di Steam. Anda bisa membangun dan menguji sisi Neocortex dari mod gratis di editor browser.






