JamLib — Diğer Minecraft Modları İçin Teknik Bir Kütüphane

JamLib — Diğer Minecraft Modları İçin Teknik Bir Kütüphane

JamLib, kendi başına oyuna herhangi bir eşya, blok, yaratık veya yapı eklemeyen bir Minecraft kütüphane modudur. Diğer mod yazarlarına şunları sağlayan bir yardımcı sarmalayıcıdır: yükleyiciler arasında bir platform soyutlaması, hazır bir yapılandırma dosyası sistemi ve yeniden paketlenmiş jar dosyası dedektörü. Bu kütüphane olmadan, onu gerektiren modlar basitçe başlamaz.

Mod Ne Yapar

Kütüphane, geliştirici için aynı anda üç görevi çözer:

• Architectury tabanlı platform soyutlamaları — aynı kod Fabric, Forge, NeoForge ve Quilt üzerinde ayrı dallar olmadan çalışır.

• Oyun içinde otomatik bir ayarlar ekranına sahip JSON5 formatında bir yapılandırma API'si.

• Bir modun jar dosyasının korsan «aynalardan» yeniden paketlenme belirtileri açısından kontrolü.

Oyuncu açısından kütüphane oynanışa hiçbir şey eklemez. Fark edilebilecek tek şey, ayarları için JamLib kullanan herhangi bir mod için mod menüsünde yeni bir girdinin belirmesidir. Pakette bu tür modlar varsa, ilgili pencerede kaydırıcılar, anahtarlar ve giriş alanları içeren, otomatik olarak oluşturulmuş bir sayfa görünecektir.

JSON5 Yapılandırmaları

Standart JSON, kod içinde yorumlara izin vermez. Kütüphanenin Jankson bağımlılığı üzerinden çalıştığı JSON5 buna izin verir. Pratikte bu, JamLib üzerine inşa edilmiş modların ayar dosyalarının .json5 gibi göründüğü ve her parametreyi varsayılan değeriyle birlikte hemen üstünde açıklayan yorumlar içerdiği anlamına gelir.

Dosyalar yeniden yazma sırasında kullanıcı düzenlemelerini korur: // ile başlayan kendi notunuzu eklerseniz, yapılandırma bir sonraki kaydedildiğinde yerinde kalır. Standart JSON kütüphaneleri bunu yapamaz.

Ayarlar ekranları ayrı olarak oluşturulur. Fabric ve Quilt'te arayüz standart mod menüsü üzerinden alınır, Forge ve NeoForge'da ise yükleyicinin yerleşik yapılandırma ekranı API'si üzerinden alınır. Mod yazarlarının elle bir GUI yazmasına gerek yoktur: JamLib, alanları yapılandırma sınıfından alır ve bunlar için doğrulamalı widget'lar oluşturur — sayı aralıkları, dizeler için düzenli ifade, oyunu yeniden başlatma ihtiyacına dair uyarılar.

Yeniden Paketlenmiş Mod Dedektörü

Ayrı bir özellik, yüklü modun .jar dosyasının resmi bir kaynaktan indirilip indirilmediğini kontrol eder. Bazı siteler modları kendi adları altında yeniden paketler ve bazen üçüncü taraf yazılımlar ekler. JamLib, dosyanın gerçek adını manifestindeki JamLib-File-Name alanıyla karşılaştırır. Eşleşmezlerse, dünya yüklendikten sonra sohbete bir uyarı yazdırılır. Mesaj, her şüpheli dosya için bir kez gösterilir ve ardından bu .jar dosyasının adı hatırlanır.

Bu kontrol yalnızca yazarları JamLib-File-Name'i manifestlerine bilerek eklemiş modlar için geçerlidir (yani aynı geliştiriciden gelen veya bu özelliği elle entegre etmiş modlar). Kütüphane, mods klasöründeki her .jar dosyasını virüs veya kötü amaçlı kod açısından taramaz — bu bir antivirüs değildir.

Sonuç

JamLib, bir mod geliştiricisini dört yükleyici için aynı anda elle bir yapılandırma sistemi ve platform soyutlaması yazmaktan kurtarır. JamLib'i kurmak yalnızca onu gerektiren bağımlı bir modla birlikte anlamlıdır. Bir pakette JamCoreModding'den veya bu kütüphaneye dayanan başka bir üçüncü taraf yazarından hiçbir mod yoksa, JamLib'in .jar dosyası mods klasöründe aktif bir rol olmadan basitçe duracaktır.