Garry's Mod AI NPC Eklentisi: Akıllı NPC'ler ve Yarışma
Lua ile bir Garry's Mod AI NPC eklentisi yapın: sandbox ve roleplay sunucuları için akıllı NPC'ler, liderlik tablolu çok oyunculu bir bilgi yarışması sunucusu ve sesli komutlar.
Neocortex TeamThe team behind Neocortex
· 6 dk okuma

Garry's Mod AI NPC eklentisi, oyuncuların söylediklerini oyunun yerleşik HTTP() fonksiyonuyla bir AI karakterine gönderen ve cevaba göre hareket eden bir Lua eklentisidir. Garry's Mod sunucuları oyuncuların uydurduğu şeylerle yaşar; sadece orada duran NPC'ler boşa giden bir fırsattır.
Neocortex ile sandbox ve roleplay sunucuları gerçekten konuşan karakterler kazanır: pazarlık yapan bir dükkâncı, tüm sunucu için oyun yöneten bir yarışma sunucusu ve sesli komutları takip eden yardımcılar. Neocortex AI karakterlerini, Conversation Flow'ları, yarışma motorunu ve cihaz üzerindeki sesli komutları sağlar; Lua ise bunları sunucunuza bağlar.
Ekran görüntüsü: Garry's Mod © Valve
Sunucuda ne çalışır, istemcide ne çalışır
Garry's Mod eklentileri, garrysmod/addons klasörüne kurulan ya da Steam Workshop üzerinden abone olunan Lua betikleri ve içerik klasörleridir. Lua iki alemde çalışır ve bir AI NPC eklentisi bunlar arasında temiz bir şekilde bölünür. Garry's Mod wiki her fonksiyonu belgeliyor.
| İş | Alem | Araç |
|---|---|---|
| NPC'ler, varlıklar, oyun mantığı | Sunucu | Lua varlıkları |
| Neocortex'i çağırmak, API anahtarını tutmak | Sunucu | HTTP(), http.Fetch, http.Post |
| Cevapları oyunculara göndermek | Sunucudan istemciye | net kütüphanesi |
| Altyazılar ve HUD | İstemci | chat.AddText veya özel bir HUD paneli |
| Ses oynatma | İstemci | sound.PlayURL |
| Sesli komutlar | İstemci | Oyuncunun bilgisayarındaki Neocortex Voice Commands |
Birkaç ayrıntı önemli. HTTP(), bir URL, yöntem, başlıklar, gövde ve geri çağrılarla asenkron bir istek başlatır; http.Fetch ve http.Post basit durumlar için bunu sarar. Başarı geri çağrısı hata durum kodları için de tetiklenir, bu yüzden kodu her zaman kontrol edin. sound.PlayURL harici ses dosyalarını oynatır; bu yüzden üretilen sesi kendi kontrol ettiğiniz küçük bir uç noktadan sunun, böylece istemciler API anahtarını hiç görmeden akışla dinleyebilir. Yerel modüller (sunucu için gmsv_, istemci için gmcl_) garrysmod/lua/bin klasörüne konur ve require ile yüklenir, ama bir Workshop eklentisiyle kurulamazlar; bu yüzden yerel her şey oyuncular ya da sunucu sahipleri için ayrı bir kurulumdur.
Oyuncuların konuşabileceği roleplay NPC'leri
Bir roleplay sunucusunda şehre bir kadro verin: pazarlık yapan ve kendisini kimin dolandırdığını hatırlayan bir dükkâncı, sunucunun lore'unu bilen bir barmen, oyuncuların bildirdiklerine tepki veren bir polis telsiz görevlisi. Her karaktere Neocortex editöründe bir Personality, bir Emotion ayarı ve bir Knowledge tabanı verilir; örneğin sunucu kurallarınız, haritanın yerleri ve ekonominiz.
Oyuncular NPC'ye "use" tuşuna basar ve sohbete yazar. Eklentiniz mesajı yakındaki nesnelerle (dükkân tezgâhı, otomat, hapishane kapısı) ve yakın zamandaki olaylarla ("bir oyuncu tutuklandı", "banka alarmı çalıyor") birlikte gönderir. Karakter her satırda bir duygu etiketiyle ve { "name": "OPEN_DOOR", "targetId": "jail_door" } gibi eylemlerle cevap verir; eklenti bunları sunucuda çalıştırır.
Grup sohbeti (Pro ve Team planları) tek bir konuşmaya altıya kadar karakter koyar; böylece bir NPC çetesi bir oyuncuyla aynı anda tartışabilir. Bir Conversation Flow, bir roleplay soygun brifingi gibi uzun bir sahneyi yönlendirebilir ve eklentinin tepki verdiği kontrol noktası anahtar kelimelerini (flowState) döndürebilir.
Bir yarışma gecesi düzenlemek
Yarışma motoru (Team planı), bir sahneyi, birkaç zil düğmesini ve bir skor tablosunu sunucu etkinliğine dönüştürür:
- Neocortex panelinde soru setini hazırlarsınız: sunucu bilgi yarışması, yeni roleplayerlar için lore sınavı ya da yeni oyuncuların bir iş almadan önce geçtiği kural kontrolü.
- Sahnedeki sunucu NPC'si turu açar.
- Oyuncular sohbette cevap verir ve eklenti her cevabı
/v3/quizüzerinden yarışma motoruna yönlendirir. - Sunucu kimin doğru bildiğini duyurur; yarışma motoru puanlamayı ve liderlik tablosunu yönetir.
- Turlar arasında eklentiniz sıralamayı bir HUD panelinde gösterir.
Ekran görüntüsü: Garry's Mod © Valve
Sesli komutları takip eden yardımcılar
Her oyuncuya dinleyen bir yardımcı NPC verin: "beni takip et", "burada bekle", "kapıyı koru", "iki sandık getir". Neocortex panelinde bir komut setini aktörler, eylemler ve nesneler olarak tasarlarsınız: aktör "helper", eylemler "follow", "wait", "guard" ve "bring", nesneler "me", "door" ve "crate".
Oyuncular doğal konuşur; eklenti eşleşen komutları anında alır, tek bir cümlede birden fazla eylem ve miktarı da dahil. Bastır-konuş ya da sürekli dinleme ile, birden fazla dilde ve bulut gidiş-dönüşü olmadan çalışır. Oyuncunun makinesinde çalıştığı için istemci tarafı eşleşen komutları sunucuya gönderir.
Voice Commands lisanslı bir SDK'dır: Voice Commands lisansı için bizimle iletişime geçin.
Garry's Mod AI NPC eklentisinin kodu
API'ye dokunan her şey sunucu tarafında çalışır. Sunucu oyun durumunu okur ve oyuncunun mesajıyla birlikte /v3/chat üzerinden bir Neocortex karakterine gönderir, cevabı altyazı olarak gösterir, sesi /v3/audio/generate veya /v3/audio/stream üzerinden oynatır ve karakterin döndürdüğü eylemleri çalıştırır:
-- 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
})
endAI NPC'ler için ev kuralları
Garry's Mod sunucuları kendi kurallarını koyar; bu yüzden AI NPC eklentilerini yalnızca size ait olan veya sahibi onaylayan sunucularda çalıştırın ve oyunculara bir AI ile konuştuklarını söyleyin. Yayımlarken Steam Workshop kurallarını izleyin ve her sunucu sahibinin kendi Neocortex API anahtarını kullandığından emin olun. Tek bir oyuncunun NPC'yi spamlamasını önlemek için oyuncu başına bir bekleme süresi ekleyin.
Sunucu sahipleri için sonuç
Boş bir klasörden konuşan bir NPC'ye beş adımda geçersiniz:
- Bir eklenti klasörü oluşturun; içinde sunucu tarafı bir Lua dosyası ve çağrılabilir bir NPC varlığı olsun.
- Karakterlerinizi Neocortex panelinde tasarlayın: bir dükkâncı, soru setli bir quiz sunucusu ve yardımcılar için bir komut seti.
- Sunucudan
HTTP()ile/v3/chatve/v3/quizçağırın ve cevaplarınetkütüphanesiyle oyunculara gönderin. - API anahtarını sunucu tarafındaki bir yapılandırma dosyasında tutun, asla istemci Lua'sında ya da bir Workshop yüklemesinde değil.
- Genel bir sunucuda çalıştırmadan önce yerel bir listen sunucusunda bir arkadaşınızla test edin.
Dükkâncıyla başlayın. Bir karakter, bir HTTP() çağrısı ve bir sohbet kancası, oyuncularınıza bir Neocortex NPC'sinin neler yapabildiğini göstermek için yeterli; quiz sunucusu da aynı sunucu kodunun üzerine kurulur. Sesli komutların oyuncunun makinesinde nasıl çalıştığını öğrenmek için oyun modları için cihaz üzerinde sesli komutlar yazısını okuyun. Source motoru modları için Half-Life 2 AI NPC modu rehberimize bakın.
Araç sürümleri ve bağlantılar Ekim 2026'da kontrol edildi. Mod araçları sık değişir; en güncel sürüm için her projenin sayfasına bakın.
Sık sorulan sorular
Garry's Mod'a AI NPC ekleyebilir miyim?
Evet. Garry's Mod eklentileri Lua ile yazılır ve oyunun yerleşik bir HTTP() fonksiyonu vardır; bu yüzden sunucu tarafı bir eklenti oyuncuların söylediklerini bir AI karakterine gönderebilir ve cevaba göre hareket edebilir. Neocortex karakteri, sesini ve döndürdüğü eylemleri sağlar.
Bir Garry's Mod eklentisi web API'sini çağırabilir mi?
Evet. Genel HTTP() fonksiyonu ile http.Fetch ve http.Post yardımcıları, sunucudan veya istemciden asenkron istekler yapar. AI NPC eklentisinde çağrıları sunucuda yapın ki Neocortex API anahtarınız hiçbir zaman oyunculara ulaşmasın.
Bir Garry's Mod sunucusunda bilgi yarışması nasıl yapılır?
Bir sunucu NPC'si yerleştirin, oyuncuların sohbet cevaplarını bir yarışma motoruna yönlendirin ve skorları bir HUD panelinde gösterin. Neocortex yarışma motoru soruları, puanlamayı ve liderlik tablosunu çalıştırır; eklentiniz yalnızca sahneyi ve sohbeti yönetir.
Garry's Mod NPC'leri sesli komutları takip edebilir mi?
Evet, istemci tarafı bir bileşenle. Neocortex Voice Commands her oyuncunun PC'sinde çalışır ve "follow me" ya da "guard the door" gibi ifadeleri, eklentinizin anında ve çevrimdışı alacağı komutlara dönüştürür. Oyuncunun makinesinde çalıştığı için oyuncular ses bileşenini Workshop eklentisiyle birlikte kurar.
Bir Garry's Mod sunucusunda API anahtarını nerede tutarım?
Yalnızca sunucuda; örneğin eklentinizin başlangıçta okuduğu sunucu veri klasöründeki bir dosyada. Anahtarı istemci Lua'sına ya da bir Workshop yüklemesine asla koymayın, çünkü her oyuncu bu dosyaları indirir.






