
Minecraft Oynayan Yapay Zeka: mc_aiplayer Rehberi
zoyluoblue/mc_aiplayer
Minecraft'ı kendi başına oynayan otonom yapay zeka ajanı - DeepSeek / OpenAI uyumlu bir LLM'nin gerçek bir oyuncuyu madencilik, inşaat, çiftçilik, savaş ve hayatta kalma görevlerinde doğal dil komutlarıyla yönetebildiği sunucu tarafı Fabric mod'u (MC 1.21.3). LLM plan yapar, belirleyici görevler yürütülür.
GitHub'da Görüntüle ↗Sinir bozucu Minecraft görevlerini her biri için özel bir komut dosyası yazmadan otomatikleştirmek istemez misiniz? mc_aiplayer, doğal dil komutlarını anlayabilen ve karmaşık çok adımlı görevleri otonom olarak yürütebilen gerçek bir sunucu tarafı yapay zeka oyuncusunu ortaya çıkaran bir Fabric modu'dur - sabit kodlu talimatlar olmadan madencilik, inşaat, çiftçilik, savaş ve hayatta kalma görevleri.
Bu Proje Ne Yapar
mc_aiplayer, otonom bir yapay zeka ajanını dünyanıza getiren Minecraft 1.21.3 için sunucu tarafı bir Fabric modu'dur. Ona düz İngilizce olarak bir hedef verirsiniz - "3 elmas madenciliği yap" veya "bir ev inşa et" - ve mod'un entegre edilen LLM'i (varsayılan olarak DeepSeek veya herhangi bir OpenAI uyumlu model) bu hedefi bir plana böler, ardından adım adım yürütür. Bu bir istemci tarafı mod veya hile değildir, normal oyun kurallarını takip eden ve gerçek bir kişi gibi dünyayla etkileşim kuran meşru bir sahte oyuncu ortaya çıkarır.
Mimari çok zekice tasarlanmıştır. Yapay zekanın rastgele Minecraft eylemleri hallüsine kapılmasına izin vermek yerine (ki bu kaos olurdu), sistem karar vermeyi yürütmeden ayırır. LLM, 62 yerleşik araçtan seçim yaparak yapılacak işleri (*ne* yapacağını) karar verir ve belirleyici bir görev motoru (*nasıl* güvenilir bir şekilde yapılacağını) yönetir. Bunu belirsiz talimatları anlayabilen ve ayrıntıları kendileri çözebilen çok zeki bir işçi kiralamak olarak düşünün.
Java'da yazılmış, 211 GitHub yıldızı ve MIT lisansı olan, sunucu operatörleri ve uzlaşı olmayan otomasyon isteyen modpack yaratıcıları için tasarlanmıştır.
Bunu Ne Zaman Kullanırdınız
Pratik kullanım durumları birkaç kategoriye ayrılır:
- Sıkıcı kaynak toplama. Ona 64 meşe ağacı veya 5 taş yığını toplamak için söyleyin ve daha sonra geri dönün. Yapı malzemeleri için taş öğütme? Bot bunu yönetirken siz ilginç bir şey yapın.
- Canavar çiftliği hata ayıklaması. Bir çiftlik kur, yapay zekanın içinde durmasını ve düşenleri toplamasını ister, oranların gerçekten iyi olup olmadığını test ederken. Sıkıcı beklemeden gerçek dünya doğrulaması.
- Dünya inşa etme yardımı. Bot'a tekrarlayan görevleri yürütmesini sağlayın - arazi düzleştirme, köprü inşa etme, otomatik mahsul dikme - böylece siz tasarım ve yerleştirmeye odaklanabilirsiniz.
- SMP sunucusu otomasyonu. Bir topluluk sunucusu işletiyorsanız, bu otomatik etkinlikler, kaynak üretimi veya hatta oyuncu komutlarına yanıt veren NPC benzeri davranışlar için olasılıklar açar.
- Test ve içerik oluşturma. YouTuberlar ve modpack geliştiricileri bunu, her adımı manuel olarak oynamadan uçtan uca iş akışlarını hızlı bir şekilde göstermek veya mod etkileşimlerini test etmek için kullanabilirler.
Bu, oyun kendisini oynarken AFK'da kalmak isteyen oyuncular için değildir (bu Minecraft'ın amacını etkisiz hale getirir). Bu, oyunun belirli işleri yönetmesini istedikleri, böylece yaratıcı veya stratejik kısımlara odaklanabilecekleri insanlar için.
Kapak Altında Nasıl Çalışır
İşte mc_aiplayer'ın ilginç hale geldiği yer. Bir komut yayınladığınızda, LLM sizin hedeflerinizi ve bot'un mevcut dünya durumunu (yakındaki bloklar, envanter, sağlık vb.) alır, ardından 62 önceden tanımlanmış görev arasından seçim yapmak için araç çağrısını kullanır: taş madenciliği, masa oluşturma, blok yerleştirme, hayvan üretme ve benzeri. LLM keyfi eylemler üretmez, sınırlı bir araç seti içinde çalışır, bu da işleri istikrarlı tutar.
LLM bir dizi planladığında, ayrı bir görev yöneticisi bunu yürütür. Yani komutunuz "bir ev inşa et" olsaydı, plan şöyle olabilirdi: 50 ağaç hasadı yapma - tahta oluşturma - ahşap kazma yapma - taş madenciliği - oluşturma tablosu yapma - blokları dikdörtgen şeklinde yerleştirme - çatı ekleme. Her adım güvenilirdir çünkü yönetici bu şeyleri nasıl yapacağını *bilir*, LLM sadece sırayı ve bağlamı belirledi.
Mod, bot'un takılmasını veya aptalca ölmesini durdurmak için beş güvenlik katmanı içerir: sağlığı izler, hataları günlüğe kaydeder, başarısız görevleri yeniden dener, kafa karıştığında bilir ve gerçekten bir şey ters giderse insan yardımı isteyebilir. Ayrıca hangi araçlara erişebileceğini yapılandırabilir, daha sıkı kontrol istiyorsanız bunu belirli görevlerle sınırlayabilirsiniz.
Ve sunucu tarafı olduğu için, kısıtlı sunucularda istemci enjeksiyonu, VAC riski yoktur (ancak sunucu şartlarınızı kontrol etmelisiniz) ve birden fazla oyuncu aynı dünyada bot'la birlikte var olabilir.
Kurulum ve Ayarlanması
Dürüst olmam gerekirse, bu noktada: mc_aiplayer sunucu operatörlerine yönelik teknik bir proje, sıradan oyuncular için değildir. Daha önce hiç Fabric modu kurmadıysanız, bu bir öğrenme eğrisi olacaktır.

Neye ihtiyacınız olacak:
- Minecraft 1.21.3 sürümünde Fabric loader 0.18.4+ çalıştıran bir Minecraft sunucusu
- Sunucuda yüklü Java 21
- DeepSeek, OpenAI veya uyumlu bir LLM sağlayıcısından bir API anahtarı
- Temel komut satırı rahatlığı
Zaten Fabric'e sahipseniz, gerçek kurulum basittir: mc_aiplayer JAR dosyasını GitHub sürümlerinden indirin, sunucunuzun `mods/` klasörüne koyun, yeniden başlatın ve mod'un yapılandırma dosyasında LLM API kimlik bilgilerinizi yapılandırın. README bunu açıklar ve mod ilk çalışmada varsayılan bir yapılandırma oluşturur.
Canlı olduktan sonra, bot'la oyun içi komutlar aracılığıyla etkileşim kurarsınız. Şöyle bir şey:
/aibot brain say Bob mine 3 diamondsBu, bot'a (varsayılan olarak "Bob" takma adıyla) 3 elmas madenciliğini anlamak ve yürütmek için söyler. Bot mevcut durumunu değerlendirir, diziyi planlar ve işe başlar. Açıkçası, ayrıca envanterini kontrol etmesini, durması veya görevin ortasında durum bildirmesini isteyebilirsiniz.
Kaldırmak temizdir: Mod JAR dosyasını silin, sunucuyu yeniden başlatın ve vanilla'ya geri dönersiniz. Dünyanıza veya yapılandırmalarınıza kalıcı değişiklik yok.
İnsanları Neyin Şaşırttığı
Bilmeye değer birkaç sorun:
LLM gecikmesi ve maliyetleri. Her komut DeepSeek veya OpenAI'ye (veya seçtiğiniz sağlayıcıya) bir istek gönderir, bu birkaç saniye sürer ve API maliyetlerine neden olur. Günde düzinelerce komut yayınlıyorsanız, faturanızı göz önünde bulundurun. DeepSeek, GPT-4'ten daha uygun fiyatlı, bunu dikkate almaya değer.
Bot'un telepati yeteneği yok. Ihtiyaç duyduğu bir kaynağı göremiyorsa, onu nerede bulacağını sihirli olarak bilemez. "64 elmas madenciliği yap" işe yarar çünkü elmaslar öngörülebilir bir dağılım takip eder, "kayıp evimi bul" daha iyi bir bağlam vermediğiniz sürece işe yaramaz.
Çok kelimeli komutlar dikkatli ifadeler gerektirir. "3 elmas madenciliği yap" işe yarar. "Git elmas bul ve geri getir" daha muğlak ve planlanan şekilde çalışmayabilir. LLM deneyecektir, ancak özgüllük her zaman yardımcı olur.
Bot etkin durumdayken sunucu performansı biraz düşer (başka bir oyuncu varlığı yol bulma ve etkileşimleri çalıştırır), bu nedenle yoğun yüklenmiş sunucularda, kesilme fark edebilirsiniz. Yıkıcı değil, ancak önce kendi donanımınızda test etmeye değer.
LLM API'si çökerse veya kimlik bilgileriniz yanlışsa, bot anında durur. Komut dosyası davranışına geri dönüş yok - sadece bekler veya hata verir. Kurulum sırasında API kimlik bilgilerinizin doğru olduğundan emin olun.
Bu Ne Değildir (ve Ne Yapamaz)
mc_aiplayer güçlüdür, ancak gerçek sınırları vardır. Wither veya Ender Dragon'la güvenilir bir şekilde savaşamaz - yetersiz olması nedeniyle değil, bu savaşlar kaotik ve bot'un duyusal modeli sınırlıdır. Sonuç, tüm gün madencilik, inşaat ve çiftçilik yapabilir, ancak boss saldırıları? Henüz değil.
Ayrıca ortaya çıkan oyunu anlamaz. Daha yapılandırılmış talimatlar olmadan ona "keşfederek eğlen" veya "harika bir yapı oluştur" soramazsınız. Bu, bilinen görevleri otomatikleştirmek için bir araçtır, yaratıcı bir işbirlikçi değil (en azından henüz değil).
Ve AFK madenciliğini eğlenceli hale getirmek veya anti-cheat'e sahip bir PvP sunucusunda meşru yapmak için bir yol arıyorsanız, bu değildir. Birçok sunucu bot davranışını tespit eden eklentilere sahiptir ve bunu izinsiz kullanmak sizi yasaklanmaya neden olur. Sunucu kurallarınızı önce kontrol edin. Sunucu tarafı ve teknik olarak meşru olmasına rağmen, herkes buna izin vermez.
Bilmeye Değer Alternatifler
Eğer mc_aiplayer ihtiyaçlarınıza uymazsa, birkaç başka proje benzer sorunları çözer. Carpet modu, belirli komutlarla komut dosyası yapabileceğiniz bir sahte oyuncu sistemine sahiptir, ancak Carpet'in etki alanı dilini öğrenmeyi gerektirir - doğal dilden daha az esnek, ancak daha istikrarlı. Ayrıca Malilib ve diğer istemci tarafı otomasyon araçları vardır, ancak bunlar daha fazla sunucu uyumluluğu riski taşırlar. Ve saf kaynak öğütmek için, vanilla çiftlik tasarımları ve canavar öğütücüler her zaman herhangi bir bot'tan daha iyi performans gösterecektir (bazen en basit çözüm daha iyidir).
Ancak doğal dili anlayan ve kod değişiklikleri olmadan yeni görevlere uyum sağlayabilen bir yapay zeka istiyorsanız, mc_aiplayer gerçekten benzersizdir.
Başlamadan önce, Minecraft versiyonunuzun güncel olduğundan emin olun. Server altyapısını yönetiyorsanız, Minecraft Sunucu Durumu Kontrolcümüz ve Nether Portal Hesaplayıcısı gibi araçlar gibi diğer sunucu yardımcı programlarını ele aldık.
Lead writer at minecraft.how. Long-time Minecraft player running a small SMP server, testing every build, mod, and seed before writing about it.


