Minecraft'ta Yapay Zekâ Oyun Arkadaşı: AIRI Nedir, Nasıl Çalışır?

Minecraft’ta Yapay Zekâ Oyun Arkadaşı: AIRI Nedir, Nasıl Çalışır?

Minecraft’a girdin. Yanında bir karakter var. Ona “Beni takip et” diyorsun. Ama diğer tarafta klavye başında oturan bir arkadaşın yok.

Peki bu oyuncunun arkasında bir yapay zekâ olsaydı?

AIRI, konuşabilen sanal karakterleri oyun etkileşimiyle buluşturan açık kaynaklı bir proje. Minecraft bağlantısı da bu fikrin en dikkat çekici parçalarından biri. Fakat önemli ayrım şu: AIRI’yi açmak ile Minecraft’ta çalışan bir oyun arkadaşı kurmak aynı şey değil. [1][2]

Bu yazıya eşlik eden Kod Denizi videosundaki oyun ve karakter sahneleri temsili animasyondur. Görüntüler, bizim gerçekleştirdiğimiz bir AIRI/Minecraft oynanış testinin kaydı değildir.

AIRI nedir?

AIRI; sohbet, sesli etkileşim ve dijital karakter sunumunu bir araya getiren bir sistem. Yalnızca mesaj yazdığın bir kutu yerine, ekranda bir karakterle etkileşim kurma fikrine odaklanıyor. Projenin web ve masaüstü seçenekleri bulunuyor. [1][2]

Burada iki farklı “model” olduğunu bilmek işini kolaylaştırır: Dil modeli yanıt üretmek için kullanılır; karakter modeli ise ekrandaki görünümü belirler. AIRI’nin karakter tarafında Live2D ve VRM seçenekleri vardır. Görünümü değiştirmek, Minecraft bağlantısını tek başına kurmaz. [3][4]

AIRI Minecraft’ta gerçekten oynayabiliyor mu?

Projenin Minecraft bileşeni, bir botun sunucuya bağlanmasını ve oyun dünyasında eylemler gerçekleştirmesini sağlayacak şekilde tasarlanmış. Erişilebilen servis belgesi, Mineflayer tabanlı yapıyı ve kaynak toplama ile inşa adımlarını içeren bir görev akışını anlatıyor. [5]

Bunu “Her söylediğini kusursuz yapan oyuncu” diye okumamak gerekiyor. Belgelerdeki örnek akış, her kurulumda elde edilmiş bir başarı kaydı değildir.

Bizim başlangıç önerimiz, doğrudan “Bana büyük bir ev yap” demek yerine küçük bir hedef seçmek. Önce bağlantının kurulduğunu kontrol et; ardından takip etme gibi basit bir isteği dene. Verilen yanıtla oyunda gerçekten olan şeyi ayrı ayrı değerlendir.

Başlamak için hangi parçalar gerekiyor?

AIRI tarafında bir sohbet sağlayıcısı ve dil modeli seçilir. Sağlayıcının gerektirdiği API anahtarı veya yerel servis adresi girilir. Sesli kullanım için konuşmayı algılama ve ses üretme ayarları da ayrıca ele alınır. Minecraft ise ek bot/entegrasyon bileşenine ihtiyaç duyar. [3][6]

Başka bir deyişle: Karakteri görmek, konuşmayı çalıştırmak ve oyuna bağlanmak üç ayrı kontrol noktasıdır.

Kendi AI oyun arkadaşın için başlangıç yolu

Bu bölüm, resmî belgelerden derlenen bir başlangıç planıdır; uçtan uca çalıştırıp doğruladığımız bir kurulum testi değildir. Menüler ve entegrasyon dosyaları sürüme göre değişebilir.

1. Önce AIRI’nin sohbet tarafını aç

Resmî siteden web sürümünü inceleyebilir veya GitHub’daki sürümler bölümünden cihazına uygun masaüstü seçeneğine ulaşabilirsin. İlk hedefin, karakterle basit bir yazılı konuşma başlatmak olsun. [2][6]

2. Sağlayıcıyı ve dil modelini seç

Masaüstü başlangıç rehberi; sağlayıcı seçme, gerekli API anahtarını ya da yerel bağlantı bilgisini girme ve bir sohbet modeli belirleme adımlarını tarif ediyor. Önce bu bağlantıyı doğrula. Yanıt alamıyorsan oyun entegrasyonuna geçmeden burada dur. [3]

3. Karakter ve ses ayarlarını ayrı kontrol et

Karakter modeli bölümünden görünümü seç. Sesli etkileşim için mikrofon girişini, konuşmayı yazıya dönüştüren hizmeti ve ses üretim ayarlarını incele. Bunları aynı anda değiştirmek yerine sırayla denemek, sorunun hangi aşamada olduğunu anlamayı kolaylaştırır. [4][6]

4. Minecraft entegrasyonunu kendi sürümüne göre hazırla

Depodaki Minecraft bileşeninin belgelerini aç. Botun AIRI’ye, seçilen model hizmetine ve Minecraft sunucusuna nasıl bağlandığını kendi sürümünün yönergelerinden kontrol et. Normal sohbet ekranının çalışması, oyun bağlantısının da hazır olduğu anlamına gelmez. [3][5][6]

Bu yazıda tek bir başlatma komutunu bütün sürümler için geçerliymiş gibi vermiyoruz. Kaynak koddan ilerliyorsan kullandığın sürümün README dosyası belirleyici olmalı.

5. Küçük bir görevle dene

İlk denemen için önerimiz şu: Ayrı bir test dünyası kullan, botun bağlantısını gözle, kısa bir istekte bulun ve sonucu kaydet.

Başarılı bir yanıt cümlesi görmekle görevin gerçekten tamamlanması aynı şey değil. Asıl ilgi çekici kısım da burada: Yapay zekânın söylediklerini, oyun içindeki davranışıyla karşılaştırmak.

Ücretsiz mi?

AIRI’nin açık kaynaklı olması, seçtiğin bütün model ve ses hizmetlerinin de ücretsiz olduğu anlamına gelmez. Resmî kullanım kılavuzunda yerel/bulut ve ücretsiz/ücretli hizmet seçenekleri ayrılıyor. Bir sağlayıcı bağlamadan önce kendi kullanım koşullarını ve ücretlendirmesini kontrol et. [2][6]

Güvenlik konusunda neye dikkat etmelisin?

Minecraft servisinin erişilebilen README’si, botu güvenilmeyen açık sunuculara bağlamamayı özellikle söylüyor. Oluşturulan eylem planları yerel bir süreç üzerinden çalışıyor; bu yüzden sunucu güvenini önemsemek gerekiyor. [5]

API anahtarlarını paylaşma. Ekran kaydı alırken anahtarların, sunucu kimlik bilgilerinin ve kişisel bilgilerin görünmediğini kontrol et. API anahtarlarını gizli tutma uyarısı resmî kullanım kılavuzunda da yer alıyor. [6]

Denemeye değer mi?

Minecraft’ı seviyorsan ve yapay zekânın yalnızca konuşmasını değil, bir ortamda eyleme geçmesini de merak ediyorsan AIRI’yi incelemek ilginç bir başlangıç olabilir.

Bizce en iyi yaklaşım, kusursuz bir dijital takım arkadaşı beklemek değil; küçük bir görev verip sistemi gözlemlemek. Neyi başardı? Neyi yanlış anladı? Bir sonraki denemede neyi değiştirmelisin?

Önce sohbeti çalıştır, sonra sesi, en son oyun bağlantısını ekle. Böylece tek seferde her şeyi çözmeye çalışmak yerine adım adım ilerlersin.

Instagram’dan geldiysen yorum anahtar kelimemiz airi. Yazı yayımlandıktan ve kod eşleşmesi yapıldıktan sonra Kod Denizi’nin /kod sayfasından bu kodla rehbere ulaşabilirsin.

Resmî kaynaklar

[1] AIRI — GitHub deposu (https://github.com/moeru-ai/airi)

[2] AIRI — Projeye giriş (https://airi.moeru.ai/docs/en/docs/overview/)

[3] AIRI — Masaüstü hızlı başlangıç (https://airi.moeru.ai/docs/en/docs/manual/tamagotchi/)

[4] AIRI — Karakter yapılandırma rehberi (https://airi.moeru.ai/docs/en/docs/manual/config/)

[5] AIRI — Erişilebilen Minecraft servis belgesi (https://raw.githubusercontent.com/moeru-ai/airi/main/services/minecraft/README.md)

[6] AIRI — Kurulum ve kullanım kılavuzu (https://airi.moeru.ai/docs/en/docs/manual/tamagotchi/setup-and-use/)

Editoryal kontrol: 25 Ekim 2026. Bazı Minecraft belge yolları erişilemiyor; bu yüzden sürüme bağlı dosya yolları ve tek komutla kurulum vaadi verilmedi. Oyun bağlantısını kendi ortamımızda çalıştırarak doğrulamadık.