Godot'ta Yapay Zeka NPC'leri Nasıl Yapılır | 2026 Rehberi
2026'da Godot'ta yapay zeka NPC'leri nasıl yapılır: HTTPRequest ve bir model API'si, Neocortex Godot SDK'sı, NobodyWho ile yerel model ve Player2 eklentisi.
Sercan AltundasFounder of Neocortex
· 9 dk okuma

Godot'ta bir yapay zeka NPC'si, oyuncunun söylediklerini bir dil modeline göndererek ve yanıtı gösterip seslendirerek yapılır: Godot'un kendi HTTPRequest düğümü ve bir model API'si üzerinden, bir karakter SDK'sı üzerinden ya da oyuncunun makinesinde bir modeli çalıştıran bir eklenti üzerinden. Godot'un kendi yapay zeka karakter özelliği yoktur; bu yüzden her yol GDScript ya da bir eklenti ekler.
Bu rehber, karakterlerin diyalog ağacından değil kendi sözcükleriyle yanıt vermesini isteyen Godot 4 geliştiricileri içindir. Dört yolu anlatır: model API'siyle HTTPRequest, Neocortex Godot SDK'sı, NobodyWho ile yerel model ve Player2 yapay zeka NPC eklentisi. Her birinin adımları, neye ihtiyaç duyduğu ve maliyeti; ardından bir karşılaştırma tablosu, her yöntem için ipuçları ve sık sorulan sorular gelir.
Godot'ta yapay zeka NPC'leri yapmanın 4 yolu
Dördü de sahnenizde karakteri temsil eden bir düğümle ve oyuncu için bir girişle başlar: bir LineEdit ya da bir mikrofon. Aralarındaki fark, modelin nerede çalıştığı, maliyetini kimin ödediği ve ne kadar GDScript yazdığınızdır.
Yöntem 1: HTTPRequest ve bir model API'si
Bu yol yalnızca Godot ile gelenleri kullanır. HTTPRequest düğümü "HTTP isteği gönderme yeteneğine sahip bir düğüm"dür; bu yüzden bir betik oyuncunun satırını bir model sağlayıcısına gönderebilir ve yanıtı okuyabilir. Örnek olarak OpenAI Responses API'sini kullanıyoruz.
İhtiyacınız olanlar: bir model sağlayıcısından bir API anahtarı ve biraz GDScript.
- Bir API anahtarı oluşturun. OpenAI için bunu platform.openai.com/api-keys adresinde oluşturun.
- Bir HTTPRequest düğümü ekleyin. NPC sahnenizin alt düğümü yapın ve
request_completedsinyalini NPC betiğindeki bir fonksiyona bağlayın. - Karakteri yazın. Karakterin adını, rolünü, tonunu ve sınırlarını içeren bir sistem talimatı metni tutun.
- Satırı gönderin. Modeli, talimatları ve oyuncunun mesajını içeren bir JSON gövdesi oluşturun; ardından
https://api.openai.com/v1/responsesadresine,Authorization: Bearer <key>veContent-Type: application/jsonbaşlıklarıyla, POST yöntemi ve gövdeylerequest()çağırın. - Yanıtı okuyun.
request_completedişleyicisinde gövdeyi JSON olarak ayrıştırın ve metni NPC'nin üstündeki bir Label ya da RichTextLabel'e koyun. - Geçmişi tutun. Son turları bir Array'de saklayın ve her istekle birlikte gönderin; model çağrılar arasında her şeyi unutur.
- Ekstraları kurun. Ses, lip sync ve eylemler sizin işinizdir: konuşma için daha fazla API çağrısı ve yanıtları oyun mekaniğine çevirmek için kendi kurallarınız.
- Anahtarı güvende tutun. Godot'un belgeleri TLS önerir ve hassas bilgi göndermeye karşı uyarır. Dışa aktarılmış bir oyundaki anahtar okunabilir, bu yüzden yayımlamadan önce sağlayıcının önüne kendi sunucunuzu koyun.
Maliyet: Godot ücretsizdir. Sağlayıcının token başına ücretlerini ödersiniz.
Eksikleri: bellek, ses, eylemler, güvenlik ve anahtar sunucusunun tamamını kendiniz kurup sürdürürsünüz.
Yöntem 2: Neocortex Godot SDK'sı
Neocortex bizim ürünümüzdür; bu bölümü bunu aklınızda tutarak okuyun. Karakteri tarayıcıdaki görsel bir editörde tasarlarsınız, ardından Godot'ta açık kaynaklı bir eklenti (Apache 2.0) üzerinden kullanırsınız. Kişilik, bilgi, duygular, ses ve eylemler editörde düğümlerdir; Godot'ta hazır düğümleri eklersiniz. Tam liste için Godot yapay zeka NPC sayfası bölümüne bakın.
İhtiyacınız olanlar: Godot 4.7 ya da daha yeni bir sürüm ve bir API anahtarı olan bir Neocortex hesabı.
- Karakteri oluşturun. Kontrol panelinde Characters'ı açın, Create New Character'a tıklayın, bir ad girin ve Create'e tıklayın. Karakteri düğüm editöründe kurun.
- Tarayıcıda deneyin. Editörün sağ üstündeki Play'e tıklayın.
- Bir API anahtarı oluşturun. Kontrol panelinde API Keys'i açın.
- Eklentiyi kurun. Sürümlerin en yenisini
https://github.com/neocortex-link/neocortex-godot-sdk/releases/latestadresinden indirin veaddons/neocortex-godot-sdkklasörünü projenizinaddonsklasörüne kopyalayın. - Etkinleştirin. Project > Project Settings > Plugins yolunu açın ve Neocortex'i etkinleştirin. API anahtarınızı Neocortex panelinde yapıştırın.
- Tek adımda bir sohbet ekleyin. Project > Tools > Neocortex > Complete Text Chat ya da Complete Voice Chat seçin. Bu, sahneye çalışan bir sohbet ekler; Inspector açılır listesinden karakteri seçin.
- Oyununuza bağlayın. Karakter için
NeocortexSmartAgentdüğümünü, mikrofon içinNeocortexAudioReceiverdüğümünü, ARKit tarzı blend shape'ler üzerinde lip sync içinNeocortexFaceAnimatordüğümünü, karakterin bilmesi gereken nesneler içinNeocortexInteractabledüğümünü ve olan olaylar içinNeocortexEventLoggerdüğümünü kullanın. Editördeki eylem düğümleri, GDScript'inizin işleyebileceği eylem adları gönderir. - Örnekleri açın. Neocortex panelinden açılan yedi örnek sahne vardır: Text Chat, Audio Chat, Actions, Interactables, Group Chat, Usage Gating ve Quiz Show.
Bilinmesi gereken sınırlar: kayıt 29 saniyede durur, 0,15 saniyeden kısa sesler gönderilmez ve sohbet istekleri 30 saniye sonra zaman aşımına uğrar.
Maliyet: Starter 9 €, Pro 29 € ve Team 99 € (yıllık faturalandırmayla aylık); ya da aylık faturalandırmayla 11 €, 35 € ve 119 €. Ticari kullanım Pro ya da Team gerektirir. Bkz. fiyatlandırma.
Eksikleri: karakterler bizim bulutumuzda çalışır, bu yüzden oyunun bağlantıya ihtiyacı vardır. Dışa aktarılmış bir oyun API anahtarını taşır, bu yüzden ona kullanım limitleri koyun. Grup sohbeti Pro ya da Team, quiz Team gerektirir ve belgelerimiz her dışa aktarma hedefini listelemez.
Yöntem 3: NobodyWho ile yerel model
NobodyWho, dil modellerini oyuncunun makinesinde çalıştıran, Godot eklentisi olan açık kaynaklı bir çıkarım motorudur. Readme'sine göre "API anahtarı gerektirmez" ve gizli ücreti yoktur.
İhtiyacınız olanlar: Godot 4.6 ya da daha yeni bir sürüm (Godot belgelerine göre) ve GGUF biçiminde bir model.
- Kurun. Godot'ta AssetLib sekmesini açın, NobodyWho'yu arayın, indirin ve Ignore asset root kutusu işaretli olarak içe aktarın. Ya da bir sürümden
addons/nobodywhoklasörünü projenize kopyalayın. Düzenleyiciyi yeniden başlatın ya da yeniden yükleyin. - Bir model seçin. Herhangi bir GGUF modeli çalışır. Readme, başlamak için Qwen3 0.6B öneriyor; uzak modeller ilk kullanımda indirilir ve önbelleğe alınır.
- Sohbeti oluşturun. Bir betikte
await NobodyWhoChat.create(<model path>, {})çağırın. - Bir soru sorun.
chat.ask(<player text>)çağırın ve sonucuncompleted()değeriniawaitile bekleyin. Belgeler, döndürülen değeri her zaman hemen await etmenizi söyler. - Rolü yazın. Sohbete karakterin talimatlarını verin; NobodyWho belgelerindeki Chat bölümünü izleyin.
- Hedeflerinizi kontrol edin. NobodyWho Godot masaüstü ve Android'i destekler. iOS ya da web dışa aktarımı yoktur.
Maliyet: EUPL-1.2 altında ticari kullanım için ücretsiz. NobodyWho'nun kendi kodunu değiştirirseniz, bu değişikliklerin açık kaynak yapılması gerekir.
Eksikleri: yanıt hızı ve kalitesi oyuncunun donanımına ve model boyutuna bağlıdır; model indirmeye ek yük getirir. Ses özellikleri motor için listelenmiştir; bunlara güvenmeden önce Godot bağlamasının onlara sahip olup olmadığını kontrol edin.
Yöntem 4: Player2 yapay zeka NPC eklentisi
Player2, oyunlar ve modlar için yerel API'leri olan bir masaüstü uygulamasıdır. Godot eklentisi "Player2 uygulamasının ücretsiz yapay zeka API'lerini kullanır" ve uygulama açıkken bağlanır.
İhtiyacınız olanlar: Godot 4.5 (Asset Library'de listelendiği gibi), bir Player2 geliştirici istemci kimliği ve Player2 uygulaması.
- Eklentiyi kurun. Godot Asset Library'den ya da GitHub'dan alın ve
addonsklasörünü projenize sürükleyin. - İstemci kimliğinizi ekleyin. player2.game/profile/developer adresinde bir tane oluşturun ve Project Settings > Player2 > Game Key altına girin.
- NPC düğümünü ekleyin. Sahneye bir Player2 AI NPC düğümü ekleyin ve ajanın açıklamasını düzenleyin.
- Sohbeti bağlayın. Düğümün
chatfonksiyonunu oyuncunun metniyle çağırın ve yanıtları göstermek içinchat_receivedsinyalini bağlayın. Dünya olaylarını ajana bildirmek içinnotifyçağırın. - Ses ekleyin. Character Config'te bir Voice ID ayarlayın ya da bir
Player2TTSdüğümü ekleyin; konuşma girişi içinPlayer2STTekleyin ve Project Settings > Audio altında ses girişini etkinleştirin. - Player2'yi çalıştırın. Player2 uygulamasını açın; eklenti otomatik olarak bağlanır.
Maliyet: Player2'nin sayfalarına göre geliştiriciler için ücretsiz. Eklenti GPLv3 lisanslıdır.
Eksikleri: Player2'nin sitesi yerel API'lerinin uygulama açıkken çalıştığını söyler; bu yüzden uygulaması olmayan oyuncuların ne göreceğini planlayın. GPLv3 lisansını projenizle karşılaştırın.
Dört yöntemin karşılaştırması
| Etken | HTTPRequest ve bir API | Neocortex SDK | NobodyWho | Player2 eklentisi |
|---|---|---|---|---|
| Karakterin tanımlandığı yer | GDScript içindeki metinler | Tarayıcıdaki görsel düğüm editörü | Kendi GDScript'iniz | Godot'taki düğüm açıklaması |
| Modelin çalıştığı yer | Sağlayıcının bulutu | Neocortex bulutu | Oyuncunun cihazı | Player2 uygulaması üzerinden |
| Godot sürümü | HTTPRequest ile 4.x | 4.7 ya da daha yeni | 4.6 ya da daha yeni | Listelenen 4.5 |
| Ses | Kendiniz kurun | Lip sync ile birlikte dahil | Motor için listelenir | TTS ve STT düğümleri |
| Eklentinin lisansı | Gerekmez | Apache 2.0 | EUPL-1.2 | GPLv3 |
| Başlangıç maliyeti | Sağlayıcının token ücretleri | Aylık 9 €'dan | Ücretsiz | Geliştiriciler için ücretsiz |
| Gereken beceri | GDScript, HTTP, bir sunucu | Bir eklenti kopyalamak, düğüm eklemek | GDScript, model seçimi | Bir düğüm eklemek |
HTTPRequest en çok kodla tam kontrol sağlar. NobodyWho çevrimdışı yoldur ve oyuncunun donanımına bağlıdır. Neocortex, karakterleri ses, lip sync ve örneklerle birlikte barındırılan bir editörde tutar. Player2, eklenmesi en hızlı düğümdür ve uygulamasına bağlıdır.
Godot'ta daha iyi sonuçlar için ipuçları
Bu alışkanlıklar her yöntemde işe yarar.
- Anahtarları dışa aktarımların dışında tutun. Dışa aktarılmış bir projedeki her şey okunabilir. Anahtar içeren ayar dosyalarını sürüm kontrolünün dışında tutun ve oyuncu ve karakter başına bir sunucu ya da kullanım limitleri kullanın.
- NPC'nin oyuncuyu duyduğunu gösterin. İstek başladığı anda "düşünüyor" animasyonuna geçin ya da bir etiket gösterin; böylece yanıtı beklerken oyun asla donmuş gibi görünmez.
- Karaktere sahneyi anlatın. Her mesajla birlikte yakındaki nesneleri ve son olayları gönderin; böylece NPC içinde durduğu odadan söz eder.
- Eylemlerde son kararı GDScript versin. Bir karakterin isteyebileceği kısa bir eylem listesi tutun ve her birini çalışmadan önce kodda kontrol edin.
- Olay örgüsü için bir diyalog ağacı kullanın. Hikâyeyi ilerleten satırları betik tabanlı bir diyalog eklentisinde tutun ve çevresindeki her şey için yapay zeka karakterini kullanın. Betik kısmı için eklentileri listeleyen Godot eklentileri yazımıza bakın.
Godot için doğru yöntemi seçmek
HTTPRequest ve bir model API'si, hiçbir eklenti istemiyorsanız, her isteği tam kontrol etmek istiyorsanız ve anahtar için küçük bir sunucu çalıştırabiliyorsanız size uyar.
Neocortex SDK'sı, karakterleri görsel olarak tasarlamak, tarayıcıda test etmek ve Godot 4.7'de ses, lip sync, eylemler ve örnekleri almak istiyorsanız size uyar; aynı karakter Unity ve Unreal Engine'de de kullanılabilir.
NobodyWho, oyunun çevrimdışı çalışması gerektiğinde, sıfır işletme maliyetiyle, masaüstü ya da Android'de size uyar.
Player2 eklentisi, oyuncularınız zaten Player2 uygulamasını kullanıyorsa ya da hızlıca prototip yapıp en az adımı istiyorsanız size uyar.
Daha fazla seçenek için Godot için en iyi yapay zeka NPC araçları yazısına, hâlâ bir motor seçiyorsanız Godot ile Unity karşılaştırmasına bakın.
Sık sorulan sorular
Godot'ta yapay zeka NPC'lerini ücretsiz yapabilir miyim?
Evet. NobodyWho ücretsizdir ve modeli yerel olarak çalıştırır; Player2 geliştiriciler için ücretsizdir. Kendiniz çağırdığınız bir model API'si token başına ücret alır.
Godot'un yerleşik yapay zeka NPC'leri var mı?
Hayır. Godot, web çağrıları için HTTPRequest düğümünü verir, ama dil modeli ya da karakter sistemi vermez. Godot yapay zekası yazımız motorun çevresinde ne olduğunu anlatır.
Hangi Godot sürümüne ihtiyacım var?
Neocortex Godot 4.7 veya daha yeni, NobodyWho 4.6 veya daha yeni ister; Player2 eklentisi 4.5'i listeler. HTTPRequest, Godot 4'ün bir parçasıdır.
Godot yapay zeka NPC'si çevrimdışı çalışabilir mi?
Evet; masaüstü ya da Android'de NobodyWho gibi yerel bir modelle. Neocortex dahil bulut yolları bir bağlantı gerektirir.
Neocortex Godot SDK'sı açık kaynak mı?
Evet. Apache 2.0 altında yayımlanmıştır ve kaynağı GitHub'da neocortex-link/neocortex-godot-sdk adresindedir. Hata raporları ve fikirler orada memnuniyetle karşılanır.
Godot yapay zeka NPC'leri web dışa aktarımlarında çalışır mı?
Yola bağlıdır. NobodyWho'nun web dışa aktarımı yoktur. Godot dışındaki tarayıcı oyunları için Neocortex'in bir Web SDK da vardır.






