Addon AI NPC Garry's Mod: NPC Pintar dan Pembawa Kuis
Bangun addon AI NPC Garry's Mod dengan Lua: NPC pintar untuk server sandbox dan roleplay, pembawa acara kuis multipemain dengan papan skor, dan perintah suara.
Neocortex TeamThe team behind Neocortex
· 6 menit baca

Addon AI NPC Garry's Mod adalah addon Lua yang mengirim apa yang dikatakan pemain ke karakter AI melalui fungsi bawaan game HTTP(), lalu bertindak berdasarkan balasannya. Server Garry's Mod hidup dari hal-hal yang diciptakan pemain, dan NPC yang hanya berdiri diam adalah peluang yang terbuang.
Dengan Neocortex, server sandbox dan roleplay mendapat karakter yang benar-benar bisa bicara: pedagang yang menawar, pembawa acara kuis yang menjalankan permainan untuk seluruh server, dan pembantu yang mengikuti perintah suara. Neocortex menyediakan karakter AI, Conversation Flow, mesin kuis dan perintah suara di perangkat; Lua menghubungkannya ke server Anda.
Tangkapan layar: Garry's Mod © Valve
Apa yang berjalan di server dan apa yang berjalan di klien
Addon Garry's Mod adalah folder berisi skrip Lua dan konten, dipasang di garrysmod/addons atau dilanggani melalui Steam Workshop. Lua berjalan di dua ranah, dan addon AI NPC terbagi dengan rapi di antara keduanya. Wiki Garry's Mod mendokumentasikan setiap fungsi.
| Tugas | Ranah | Alat |
|---|---|---|
| NPC, entity, logika game | Server | Entity Lua |
| Memanggil Neocortex, menyimpan API key | Server | HTTP(), http.Fetch, http.Post |
| Mengirim balasan ke pemain | Server ke klien | Pustaka net |
| Subtitle dan HUD | Klien | chat.AddText atau panel HUD kustom |
| Pemutaran suara | Klien | sound.PlayURL |
| Perintah suara | Klien | Neocortex Voice Commands di mesin pemain |
Beberapa detail penting. HTTP() memulai permintaan asinkron dengan URL, metode, header, body dan callback, dan http.Fetch serta http.Post membungkusnya untuk kasus sederhana; callback sukses juga terpanggil untuk kode status error, jadi selalu periksa kodenya. sound.PlayURL memutar file suara eksternal, jadi sajikan suara yang dihasilkan dari endpoint kecil yang Anda kendalikan, dan klien bisa men-stream-nya tanpa pernah melihat API key. Modul native (gmsv_ untuk server, gmcl_ untuk klien) diletakkan di garrysmod/lua/bin dan dimuat dengan require, tetapi tidak bisa dipasang lewat addon Workshop, jadi apa pun yang native adalah instalasi terpisah bagi pemain atau pemilik server.
NPC roleplay yang bisa diajak bicara pemain
Di server roleplay, berikan kota itu para pemerannya: pedagang yang menawar dan mengingat siapa yang pernah mengecohnya, bartender yang mengenal lore server, penerima laporan polisi yang bereaksi terhadap apa yang dilaporkan pemain. Setiap karakter mendapat Personality, pengaturan Emotion dan basis Knowledge di editor Neocortex, seperti aturan server Anda, lokasi di peta, dan ekonomi Anda.
Pemain menekan use pada NPC dan mengetik di chat. Addon Anda mengirim pesan bersama objek di sekitar (meja kasir, mesin penjual otomatis, pintu penjara) dan kejadian terbaru ("seorang pemain ditangkap", "alarm bank berbunyi"). Karakter membalas dengan tag emosi di setiap baris dan aksi seperti { "name": "OPEN_DOOR", "targetId": "jail_door" } yang dijalankan addon di server.
Group chat (paket Pro dan Team) menempatkan hingga enam karakter dalam satu percakapan, sehingga sekelompok NPC bisa berdebat dengan seorang pemain sekaligus. Conversation Flow bisa mengarahkan adegan yang lebih panjang, seperti briefing perampokan roleplay, dan mengembalikan kata kunci checkpoint (flowState) yang direspons addon.
Menjalankan malam kuis
Mesin kuis (paket Team) mengubah panggung, beberapa bel dan papan skor menjadi event server:
- Anda menyusun set pertanyaan di dashboard Neocortex: malam trivia server, kuis lore untuk roleplayer baru, atau pemeriksaan aturan yang harus dilewati pemain baru sebelum mendapat pekerjaan.
- NPC pembawa acara di panggung membuka ronde.
- Pemain menjawab di chat, dan addon meneruskan setiap jawaban ke mesin kuis melalui
/v3/quiz. - Pembawa acara mengumumkan siapa yang benar, dan mesin kuis menangani penilaian serta papan skor.
- Di antara ronde, addon Anda menampilkan klasemen di panel HUD.
Tangkapan layar: Garry's Mod © Valve
Pembantu yang mengikuti perintah suara
Berikan setiap pemain satu NPC pembantu yang mendengarkan: "ikuti aku", "tunggu di sini", "jaga pintu", "bawa dua peti". Di dashboard Neocortex, Anda merancang kumpulan perintah sebagai actor, action dan object: actor "helper", action "follow", "wait", "guard" dan "bring", object "me", "door" dan "crate".
Pemain berbicara secara alami, dan addon menerima perintah yang cocok seketika, termasuk beberapa aksi dan jumlah dalam satu kalimat. Ini bekerja dengan push-to-talk atau mendengarkan terus-menerus, dalam beberapa bahasa, tanpa perjalanan bolak-balik ke cloud. Karena berjalan di mesin pemain, sisi klien yang mengirim perintah yang cocok ke server.
Voice Commands adalah SDK berlisensi: hubungi kami untuk lisensi Voice Commands.
Kode addon AI NPC Garry's Mod
Semua yang menyentuh API berjalan di sisi server. Server membaca status game dan mengirimkannya bersama pesan pemain ke karakter Neocortex melalui /v3/chat, lalu menampilkan balasan sebagai subtitle, memutar suara dari /v3/audio/generate atau /v3/audio/stream, dan menjalankan aksi yang dikembalikan karakter:
-- Server realm only: the key stays in garrysmod/data and never reaches players.
local apiKey = string.Trim(file.Read("neocortex_key.txt", "DATA") or "")
local function AskNPC(ply, text, sessionId, onReply)
HTTP({
url = "https://api.neocortex.link/v3/chat",
method = "POST", type = "application/json",
headers = { ["x-api-key"] = apiKey },
body = util.TableToJSON({
characterIds = { "CHARACTER_ID" },
message = text,
playerId = ply:SteamID64(),
sessionId = sessionId or ""
}),
success = function(code, body)
local data = util.JSONToTable(body)
if code == 200 and data then onReply(data) end -- data.sessionId, data.messages
end,
failed = function(reason) print("[Neocortex] " .. reason) end
})
endAturan rumah untuk NPC AI
Server Garry's Mod menetapkan aturannya sendiri, jadi jalankan addon AI NPC hanya di server yang Anda miliki atau yang pemiliknya setujui, dan beri tahu pemain bahwa mereka sedang berbicara dengan AI. Ikuti aturan Steam Workshop saat Anda menerbitkan, dan pastikan setiap pemilik server memakai API key Neocortex mereka sendiri. Tambahkan cooldown per pemain agar satu pemain tidak membanjiri NPC dengan pesan.
Kesimpulan untuk pemilik server
Lima langkah membawa Anda dari folder kosong ke NPC yang bisa bicara:
- Buat folder addon dengan file Lua sisi server dan entity NPC yang bisa dimunculkan.
- Rancang karakter Anda di dashboard Neocortex: pedagang, pembawa acara kuis dengan set pertanyaan, dan kumpulan perintah untuk pembantu.
- Panggil
/v3/chatdan/v3/quizdari server denganHTTP(), dan kirim balasan ke pemain dengan pustakanet. - Simpan API key di file konfigurasi sisi server, jangan pernah di Lua klien atau unggahan Workshop.
- Uji di listen server lokal bersama seorang teman sebelum Anda menjalankannya di server publik.
Mulailah dari pedagang. Satu karakter, satu panggilan HTTP() dan satu chat hook sudah cukup untuk menunjukkan kepada pemain apa yang bisa dilakukan NPC Neocortex, dan kuis dibangun di atas kode server yang sama. Untuk mempelajari cara perintah suara bekerja di mesin pemain, baca perintah suara di perangkat untuk mod game. Untuk mod Source di tingkat engine, lihat panduan kami mod AI NPC Half-Life 2.
Versi alat dan tautan diperiksa Oktober 2026. Alat modding sering berubah; periksa halaman setiap proyek untuk rilis terbaru.
Pertanyaan yang sering diajukan
Bisakah Anda menambahkan AI NPC ke Garry's Mod?
Bisa. Addon Garry's Mod ditulis dengan Lua dan game ini punya fungsi HTTP() bawaan, sehingga addon sisi server bisa mengirim apa yang dikatakan pemain ke karakter AI dan bertindak berdasarkan balasannya. Neocortex menyediakan karakter, suaranya, dan aksi yang dikembalikannya.
Bisakah addon Garry's Mod memanggil web API?
Bisa. Fungsi global HTTP() serta pembantu http.Fetch dan http.Post membuat permintaan asinkron dari server atau klien. Untuk addon AI NPC, lakukan panggilan di server agar API key Neocortex Anda tidak pernah sampai ke pemain.
Bagaimana cara menjalankan acara kuis di server Garry's Mod?
Munculkan NPC pembawa acara, arahkan jawaban chat pemain ke mesin kuis, dan tampilkan skor di panel HUD. Mesin kuis Neocortex menjalankan pertanyaan, penilaian dan papan skor, sehingga addon Anda hanya menangani panggung dan chat.
Bisakah NPC Garry's Mod mengikuti perintah suara?
Bisa, dengan komponen sisi klien. Neocortex Voice Commands berjalan di PC setiap pemain dan mengubah frasa seperti "follow me" atau "guard the door" menjadi perintah yang langsung diterima addon Anda, secara offline. Karena berjalan di mesin pemain, pemain memasang bagian suara bersama addon Workshop.
Di mana saya menyimpan API key di server Garry's Mod?
Hanya di server, misalnya di file dalam folder data server yang dibaca addon Anda saat startup. Jangan pernah menaruh key di Lua sisi klien atau unggahan Workshop, karena setiap pemain mengunduh file tersebut.






