Architectury API: Minecraft'ta çapraz platform modları için köprü kütüphaneye genel bakış

Minecraft'ta birden fazla yükleyici için mod geliştirmek, genellikle geliştiricileri Fabric, Forge ve NeoForge için ayrı kod tabanları yazmaya ve bunları sürdürmeye zorlar. Architectury API kütüphanesi, mod kodu ile yükleyiciye özgü API'ler arasında aracı bir soyutlama katmanı sunarak bu sorunu çözer. Geliştiricilerin, kodun büyük bölümünün ortak olduğu ve her ortam için derlemenin otomatik gerçekleştiği çapraz platform modlar yazmasına olanak tanır. Oyuncular için bu kütüphane, düzinelerce popüler eklentiyi çalıştırabilmek adına zorunlu bir bağımlılıktır.

Architectury API'nin Konsepti ve Teknik Avantajları

Architectury API'nin temel amacı, mod geliştirme sürecinde tekrarlayan kodu en aza indirmektir. Yazarlar, Fabric ve Forge'un ayrı olay ve kayıt sistemlerini öğrenip kullanmak yerine, birleşik aracı sınıflarla çalışır.

Kütüphanenin geliştiricilere sunduğu temel mekanizmalar:

• Birleşik kayıt sistemi: yeni blokların, eşyaların, biyomların veya varlıkların, kütüphanenin ardından ilgili yükleyicinin gereksinimlerine kendiliğinden uyarlayacağı tek bir ortak arayüz üzerinden kaydedilmesini sağlar.

• Ağ iletişimi: Forge ve Fabric'e özgü ağ protokollerini birleştirerek istemci ile sunucu arasında özel veri paketleri gönderimini basitleştirir.

• Olay yönetimi: bir blokla etkileşim, bir canavarın ölümü veya bir menünün açılması gibi ortak bir oyun olayları listesi sunarak, geliştiricinin her sistem için ayrı olay dinleyicileri yazmasına gerek bırakmaz.

• Derleme otomasyonu: geliştirme ortamı için özel bir Gradle uzantısı, ortak koddan yola çıkarak her yükleyici için nihai .jar dosyalarını otomatik olarak üretir.

Uyumluluğa Etkisi ve Popüler Bağımlı Modlar

Architectury API'nin kullanımı, geliştiricilerin yalnızca kütüphanenin kendisini güncellemesi yeterli olduğundan ve kendi eklentilerinin mantığını yeniden yazmalarına gerek kalmadığından, modların yeni Minecraft sürümlerine uyarlanmasını ve güncellenmesini büyük ölçüde kolaylaştırır. Bu da Architectury API'yi birçok büyük ölçekli projenin temel taşı hâline getirir.

Bu kütüphaneyi gerektiren tanınmış modlara örnekler:

• Cloth Config API: yapılandırma ekranları oluşturmak için popüler bir kütüphane olup ayar menülerini çizmek için Architectury'nin araçlarını kullanır.

• Rough Enough Items (REI): çapraz platform ağ paketlerine ve kayıt sistemlerine dayanan popüler bir tarif görüntüleme arayüzüdür.

• Lighty: hem Fabric hem de Forge üzerinde render olaylarını izlemek için Architectury'ye ihtiyaç duyan bir ışık seviyesi görselleştirme modudur.

• Better Archeology: ortak kayıt araçlarını kullanarak farklı yükleyicilerde yeni arkeoloji yapıları, eşyalar ve bloklar ekleyen bir eklentidir.

Bir oyuncu, karşılık gelen Architectury API sürümünü önceden kurmadan bu modlardan herhangi birini çalıştırmaya çalışırsa, oyun istemcisi yüklemeyi hemen durdurur ve kütüphanenin eklenmesini talep eden bir hata mesajı gösterir.

Uyumluluk Özellikleri ve Kurulum Gereksinimleri

Geliştirici ekibi, Architectury API'yi tamamen teknik bir eklenti olarak yayınlar. Oyuncunun, oyun sürümüne ve seçtiği yükleyiciye (Fabric, Forge veya NeoForge) tam olarak uyan kütüphane dosyasını indirmesi gerekir.

Kurulum standart şemaya göre gerçekleşir — .jar dosyasının mods klasörüne taşınmasıyla. Kütüphane, ayarları doğrudan bağımlı modlara entegre edildiğinden config klasöründe kendi yapılandırma dosyalarını oluşturmaz. Arka planda çalışır ve ayarlara herhangi bir manuel müdahale gerektirmez; bu da yanlış yapılandırmadan kaynaklanan çökme riskini ortadan kaldırır.

Sonuç

Farklı yükleyiciler için birden fazla ayrı proje oluşturup sürdürmekle kıyaslandığında, Architectury API geliştiricilerin tek bir ortak proje üzerinde çalışmasına olanak tanır. Kütüphanenin başlıca kısıtlaması, yazarların iç araçlarını öğrenmek için harcamaları gereken ek zamandır. Bu mod, modpack'lerinde modern ve teknik açıdan gelişmiş modlar kullanmak isteyen oyuncular için zorunlu bir kurulumdur.