Half-Life 2 AI NPC Modu: Sesle Komutlu Ekipler ve Yoldaşlar
Source SDK 2013 üzerinde bir Half-Life 2 AI NPC modu planlayın: sesle komut verdiğiniz bir isyancı ekibi, size geri konuşan bir yoldaş, sığınak hikâye sahneleri ve bir quiz terminali.
Neocortex TeamThe team behind Neocortex
· 6 dk okuma

Half-Life 2'nin ekip AI'ı tuş basışlarını dinler; dünyası ise yalnızca senaryonun izin verdiğini söyleyen insanlarla doludur. İsyancılar sizi takip eder ama onlara bir şey söyleyemezsiniz; sakinler konuşur ama az önce olanlar hakkında asla konuşmazlar. Bir Half-Life 2 AI NPC modu ikisini de düzeltir: emirlerinize sesli olarak tepki veren isyancılar, az önce atlattığınız çatışma hakkında konuşan bir yoldaş ve oyuncunun seçimlerine göre şekillenen hikâye sahneleri. Neocortex AI karakterlerini, Konuşma Akışlarını, quizleri ve cihaz üzerinde çalışan ses komutlarını ekler; Source SDK 2013 ise bunları bağlamak için gereken kodu verir.
Ekran görüntüsü: Half-Life 2 © Valve
İsyancı ekibine sesli emirler
Half-Life 2, ekibinizi bir noktaya göndermenize ve geri çağırmanıza zaten izin verir. Ses komutları tuş basışının yerine konuşmayı koyar: "yukarı ilerle", "burada bekle", "arabanın arkasına siper al", "bana doğru toplan".
Neocortex dashboard'unda komut setini aktörler, eylemler ve nesneler olarak tasarlarsınız: aktör "squad", eylemler "move", "hold" ve "cover", nesneler "me", "car" ve "door" gibi. Oyuncular doğal şekilde konuşur ve mod, eşleşen komutları anında alır; tek bir cümlede birden fazla eylem ve miktar dahil: "ikiniz kapıyı izleyin, geri kalanlar beni takip etsin". Sizin kodunuz bunları mevcut ekip koduna eşler.
Bastır-konuş ya da sürekli dinleme ile çalışır, birden fazla dilde destekler ve oyuncunun makinesinde çalışır; bu yüzden emirler bir bulut gidiş-dönüşü olmadan, çatışmanın ortasında ulaşır.
Voice Commands lisanslı bir SDK'dır: Voice Commands lisansı için bizimle iletişime geçin.
Örnek: Mara Venn ve sığınak
Yoldaş. Özgün bir yoldaş yaratın, örneğin Mara Venn; kliniği kapatıldıktan sonra direnişe katılmış eski bir saha sağlıkçısı. Modunuz oyuncunun sorusunu, oyunun bildiği şeylerle birlikte gönderir: yakındaki nesneler (barikat, cephane sandığı, telsiz) ve yeni olaylar ("iki ekip üyesi düştü", "oyuncu sol tünele girdi", "sağlık 30'un altında"). Mara her satırda bir duygu etiketiyle sesli cevap verir ve bir tıbbi çanta vermek ya da oyuncunun istediği kapıyı açmak gibi eylemleri döndürebilir.
Ekip karşılık verir. Grup sohbeti (Pro ve Team planları) en fazla altı karakterin tek bir konuşmayı paylaşmasını sağlar; böylece tüm ekip bir sonraki hamle hakkında tartışabilir.
Bodrum. Mara oyuncuyu bir bodrum sığınağına götürür; burada, kentten çıkış rotasını paylaşmadan önce temkinli bir hücre liderinin güvenini kazanmanız gerekir. Bir Konuşma Akışı bu adımları tanımlar: tanışmalar, hangi tarafta olduğunuzu kanıtlamak, anlaşma, rota. Karakter, oyuncu ifadeyi nasıl kurarsa kursun konuşmayı bu adımlardan geçirir; API ise TRUST_EARNED ya da ROUTE_SHARED gibi kontrol noktası anahtar sözcüklerini döndürür. Modunuz gizli kapıyı açarak ya da sizi dışarı çıkaracak rehberi doğurarak tepki verir.
Terminal. Köşede bir terminal yeni askerleri çalıştırır: hangi düşman birimlerinden kaçınılacağı, ekibe nasıl işaret verileceği, hangi malzemelerin taşınacağı. Neocortex quiz motoru (Team planı) soruları ve puanlamayı yönetir; doğru cevap serisi oyuncuya cephane ya da bir kısayol kazandırabilir.
Ekran görüntüsü: Half-Life 2 © Valve
Half-Life 2 AI NPC modu için Source SDK 2013 dalları
Half-Life 2, Source üzerinde çalışır. Bir mod, kendi gameinfo.txt dosyasına, içeriğine ve Valve'ın kodundan derlenen iki C++ kütüphanesine sahip bir klasördür: NPC AI, ekipler ve oyun mantığı için bir sunucu DLL'i ve HUD, VGUI panelleri ile yerel efektler için bir istemci DLL'i. Başka her şeyden önce temeli seçin:
| Temel | İçeriği | Durum |
|---|---|---|
Source SDK 2013 singleplayer dalı | Half-Life 2 tek oyunculu kodu | 2015'ten beri kod güncellemesi yok; 32 bit Source SDK Base 2013 Singleplayer üzerinde çalışır |
Source SDK 2013 master dalı | Çok oyunculu kod | Şubat 2025'te Team Fortress 2 oyun kodu ve 64 bit derlemelerle güncellendi; Valve hâlâ buna commit atıyor |
| Mapbase | Topluluk tarafından sürdürülen tek oyunculu modlar için bir temel | Sürüm 8.0 Temmuz 2025'te çıktı; yeni varlıklar, düzeltmeler ve harita betikleri için bir VScript uygulaması ekledi |
Yukarıdaki sığınak gibi bir hikâye modu için singleplayer dalından ya da Mapbase'den başlayın.
Bir Source DLL'inden Neocortex'i çağırmak
SDK başlıkları Steamworks HTTP arayüzünü içerir, birçok modder ise bunun yerine libcurl ekler. Hangisini kullanırsanız kullanın, istekleri bir çalışan iş parçacığında çalıştırın ve sonuçları oyun döngüsüne geri verin. İstemci ya da sunucu DLL'inden libcurl ile bir sohbet çağrısı:
// 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, oyun durumunu okur ve bunu oyuncunun mesajıyla birlikte /v3/chat üzerinden bir Neocortex karakterine gönderir, yanıtı altyazı olarak gösterir, sesi /v3/audio/generate ya da /v3/audio/stream üzerinden oynatır ve karakterin döndürdüğü eylemleri çalıştırır. Konuşma Akışları aynı yanıtta kontrol noktası anahtar sözcüklerini (flowState) döndürür, quiz motoru /v3/quiz üzerinden çalışır ve cihaz üzerindeki ses komutları, Neocortex Voice Commands oyuncunun makinesinde çalışarak konuşulan ifadeleri bir bulut gidiş-dönüşü olmadan oyun eylemlerine çevirir.
Arayüz için, istemci DLL'indeki VGUI panelleri altyazı ve bir quiz ekranı gösterebilir. Source'un kapalı altyazıları ve soundscript'leri önceden yazılmış satırlar için tasarlanmıştır; bu yüzden canlı AI yanıtları genellikle kendi altyazı paneline sahip olur ve üretilen ses bir dosyaya kaydedilip motor üzerinden çalınır.
Yayınlamadan önce: Source 1 SDK lisansı
Source 1 SDK lisansı, modları yalnızca ücretsiz dağıtmanıza izin verir; ücretsiz modlar Steam'de yayınlanabilir. AI NPC modlarını tek oyunculu tutun, kuralları çiğneyerek çok oyunculu sunucularda kullanmayın ve her oyuncunun kendi Neocortex API anahtarını kullanmasını sağlayın.
Boş bir haritadan konuşan bir ekibe
- Source SDK 2013'ü kurun. Bir hikâye modu için
singleplayerdalını ya da Mapbase'i seçin, derleyin ve boş bir test haritası başlatın. - Karakterlerinizi Neocortex dashboard'unda tasarlayın: bir yoldaş, bir Konuşma Akışlı hücre lideri, terminal için bir quiz ve ekip için bir komut seti.
- API'yi oyun DLL'inizden bir çalışan iş parçacığında çağırın ve her yanıttan gelen
sessionId'yi yeniden kullanın. - API anahtarını bir yapılandırma dosyasında tutun; oyuncu doldursun, paylaştığınız bir modda asla sabit kodlamayın.
- Altyazıyı, sesi ve eylemleri bağlayın, ardından ses komutlarını mevcut ekip koduna eşleyin.
- Tek bir haritada tek oyunculu test edin; tam bir kampanyaya geçmeden önce.
Bir modda ses komutlarının nasıl çalıştığını görmek için oyun modları için cihaz üzerinde ses komutları yazısını okuyun. GoldSrc için Half-Life AI NPC modu rehberimize, Source sandbox sunucuları için ise Garry's Mod AI NPC ve quiz eklentisi yazısına bakın. Mara ve ekibi, ilk harita derlenmeden çok önce Neocortex tarayıcı düzenleyicisinde bugün test edilebilir.
Araç sürümleri ve bağlantılar Ekim 2026'da kontrol edildi. Modlama 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
Half-Life 2'ye AI NPC ekleyebilir misiniz?
Evet. Half-Life 2 modları, tam C++ oyun kodunu veren Valve'ın Source SDK 2013'ü ile yapılır; bu yüzden bir mod bir web API'sini çağırabilir ve yanıta göre hareket edebilir. Neocortex AI karakterini, sesini ve döndürdüğü eylemleri sağlar; modunuz bunları çalıştırır.
Source SDK 2013'ün tek oyunculu mu çok oyunculu dalını mı kullanmalıyım?
Hikâye modları genellikle tek oyunculu dalla ya da Mapbase gibi onun üzerine kurulu bir topluluk temeliyle başlar. Çok oyunculu dal 2025'te 64 bit desteğiyle büyük bir güncelleme aldı ve hâlâ bakımda, ancak kodu çok oyunculu oyunları hedefler. Neocortex ikisiyle de çalışır, çünkü düz bir web API'sidir.
Half-Life 2 isyancılarına sesle komut verebilir miyim?
Evet, bir modla. Half-Life 2'nin zaten bir ekip komut kodu vardır ve bir mod bunu konuşmadan tetikleyebilir. Neocortex Voice Commands, doğal ifadeleri oyuncunun PC'sinde eşler; böylece "yukarı ilerle", "burada bekle" ve "toplan" kodunuza anında ve çevrimdışı ulaşır.
AI karakterli bir Half-Life 2 modunu satabilir miyim?
Hayır. Source 1 SDK lisansı, modları yalnızca ücretsiz dağıtmanıza izin verir; ücretsiz modlar Steam'de yayınlanabilir. Ücretsiz bir modun Neocortex tarafını tarayıcı düzenleyicisinde oluşturup test edebilirsiniz.






