Puzzles Lib — Minecraft Java Edition 1.21.1

Puzzles Lib, geliştirici Fuzs tarafından oluşturulmuş, Minecraft modları için temel bir teknik kütüphanedir. Mod, oyun dünyasına doğrudan yeni bloklar, eşyalar, moblar veya oynanış mekanikleri eklemez. Asıl işlevi, Forge, Fabric ve NeoForge'a özgü kodu soyutlayarak diğer modifikasyonların farklı yükleyicilerde aynı şekilde kararlı çalışmasını sağlayan ortak bir programlama arayüzü (API) sunmaktır. Puzzles Lib modunu yalnızca ilişkili eklentilerin çalışmasını sağlamak amacıyla indirmek gerekir.

Bağımlı modifikasyonların ekosistemi

Bu kütüphane, otuzdan fazla farklı projeyi çalıştırmak için zorunlu bir gerekliliktir. Olayların işlenmesi, modellerin işlenmesi (rendering) ve istemci ile sunucu arasında veri senkronizasyonu için ortak kod içerir.

Bu çerçeveyi kullanan en popüler Minecraft teknik modları:

• Arayüz ve blok değişiklikleri: Easy Magic, Easy Anvils, Visual Workbench. Kütüphane, bu blokların envanterlerindeki eşyaların kapatıldıktan sonra korunmasından ve ganimetin doğrudan bloğun dokusunda görselleştirilmesinden sorumludur.

• Büyü ve ticaret eklentileri: Enchanting Infuser, Trading Post, Universal Enchants. Puzzles Lib, bu modların vanilya rastgele sayı üreteci ve köylü ticareti üretme algoritmalarıyla etkileşim mantığını sağlar.

• İstemci eklentileri: pusulalar, saatler ve diğer bilgilendirici eklentiler; bunlarda API, verilerin FPS düşüşü olmadan ekrana yansıtılmasını yönetir.

Fuzs modlarının yapılandırması

Ayar biçimlerinin tek tipleştirilmesi, bu kütüphanenin temel görevidir. Geliştirici, Fabric için JSON ve Forge için TOML desteklemek yerine tek bir standart getirdi.

Puzzles Lib, kendisine bağımlı tüm modları zorla .toml biçimini kullanmaya geçirir. Kütüphanenin kendisinin de config klasöründe puzzleslib-client.toml adında kendi ayar dosyası vardır.

checkIncompatibleMods

enableOptifineWarning

forceResourcePacks

Başlatma sorunlarının çözümü ve çakışmalar

Puzzles Lib platformlar arası olduğundan, istemci derlemesi sırasında hatalar sık görülür. Günlük analizleri, bu kütüphaneyle ilgili olarak oyunun çökmesine (crash) yol açan üç ana neden ortaya koyuyor.

Fabric'te yapılandırma portunun bulunmaması

İlk yükleme aşamasında oyunun anında kapanmasına yol açan bir hata. Fabric, Forge'un yapılandırma sistemini (TOML biçimi) yerel olarak desteklemediğinden, Puzzles Lib ayar dosyalarını okuyamaz. Durumu düzeltmek için mods klasörüne yardımcı mod olan Forge Config API Port'u yüklemek gerekir.

Yükleyici sürümlerinin uyumsuzluğu

Oyuncular çoğu zaman Forge için olan Puzzles Lib .jar dosyasını bir Fabric derlemesine kopyalar, ya da tam tersini yapar. CurseForge ve Modrinth platformlarındaki dosyalarda ilgili etiketler bulunur (adında fabric, forge, neoforge). Başka bir yükleyici için olan dosyayı çalıştırmak kesinlikle Mod resolution failed veya java.lang.NoClassDefFoundError hatasını verir.

Sunucu etiketlerinin senkronizasyon bozukluğu

Kütüphane sunucuya kurulu ancak istemcide yoksa (veya sürümler farklıysa), oyuncu bağlanmaya çalışırken Connection closed - mismatched mod channel list hatasını alır. Puzzles Lib, her iki tarafta da dosyanın aynı sürümüyle kurulmasını gerektirir.

Uyumluluk

• Zorunlu bağımlılıklar: Fabric/Quilt'te oynamak için Fabric API ve Forge Config API Port kesinlikle gereklidir. Forge/NeoForge için ek dosya indirmeye gerek yoktur — sınıflar yükleyiciye gömülüdür.

• Uyumsuzluk: OptiFine ile entegrasyon, rendering hattındaki çakışmalar nedeniyle kararsız çalışır. Geliştirici, alternatif olarak Sodium veya Embeddium kullanılmasını önerir.

Sonuç

Puzzles Lib, geliştirmeyi optimize eden ve geniş bir modifikasyon listesinin tüm güncel yükleyicilerde aynı anda güncellenmesine olanak tanıyan tamamen teknik bir araçtır. Architectury API gibi büyük çaplı çerçevelerle karşılaştırıldığında bu mod dar odaklıdır ve yalnızca tek bir yazarın ekosistemine hizmet eder. Bir sınırlaması, üçüncü taraf yapılandırma portları indirmek zorunda kalan Fabric oyuncuları için biraz fazla yüklü olan bağımlılık yapısıdır. Bu mod, Fuzs araçlarını kullanarak teknik veya RPG modpack'leri hazırlayan herkes için zorunludur.