Cloth Config API — Minecraft'ta ayar ekranları için mod

Cloth Config API — Minecraft'ta ayar ekranları için mod

Cloth Config API, Minecraft'taki onlarca modifikasyonun ayarlarını bir metin dosyası yerine oyun içinde bir menü biçiminde göstermek için ihtiyaç duyduğu bir kütüphanedir. Kendisi oyuna hiçbir şey eklemez: ne eşya, ne blok, ne de yeni mekanikler. Bu bir bağımlılıktır — onsuz, onu bağlayan modlar başlamaz ve modifikasyon listesinde bir hata gösterir.

Mod ne zaman gerekir

Kütüphane tek başına değil, diğer modifikasyonlarla birlikte kurulur. Belirli bir derleme için gerekip gerekmediğini iki yolla anlayabilirsiniz:

• Modun Modrinth veya CurseForge'daki açıklamasında, Dependencies listesinde Cloth Config API belirtilmiştir.

• Derleme başlatıldığında oyun kapanır ve günlükte (logs/latest.log) cloth-config veya cloth-config-2 eksikliğine dair bir ibare belirir.

Dahili ad cloth-config-2 aynı moda aittir — bu, kütüphanenin ikinci büyük sürümünden itibaren ortaya çıkan tanımlayıcıdır. Biri «cloth-config-2 gerekiyor» yazıyorsa, kastedilen Cloth Config API'nin modern sürümüdür.

Modun ayarları nasıl açılır

Forge ve NeoForge'da kurulu modifikasyonların listesi oyunun ana menüsüne yerleşiktir — Mods öğesi. Cloth Config'i bağlayan her modun yanında bir ayar simgesi belirir. Tıklama, tam olarak bu modifikasyonun tüm parametrelerini içeren ayrı bir ekran açar.

Fabric'te yükleyicide standart bir mod listesi bulunmadığından, Cloth Config ekranlarına erişim modifikasyonları görüntüleyen harici bir araçla sağlanır — kurulu olanların listesini gösterir ve istenen öğenin yanındaki düğmeye tıklamanıza olanak tanır.

Cloth Config yardımıyla modun ayarları 

Ekranın kendisi nasıl görünür

Modun tüm ekranları aynı şemaya göre kurulmuştur: solda — parametre kategorileri, ortada — parametrelerin kendisi, altta — Kaydet ve İptal düğmeleri. Her parametre, değerinin türüne karşılık gelen bir arayüz öğesiyle gösterilir. 

Ekranın üst kısmında, onlarca parametreli yapılandırmalar için bir arama alanı vardır — listeyi ada göre süzer. Modifikasyon yazarının açıklama tanımladığı parametrelerin yanında, imleç üzerine getirildiğinde açıklamayı içeren bir ipucu belirir.

İzin verilen aralığın dışında veya kabul edilemeyen bir biçimde bir değer girilirse, alan vurgulanır ve hata düzeltilene kadar kaydetme düğmesi etkin olmaz. Her parametrenin yanında bir sıfırlama düğmesi vardır — değeri, modifikasyon yazarının varsayılan olarak işaretlediği değere döndürür.

Sonuç

Cloth Config API altyapısal bir bağımlılıktır: onsuz modifikasyonların bir kısmı basitçe başlamaz, ancak modun kendisi başka bağlı modlar olmadan oyunda görünür hiçbir şey sunmaz. Görevi, Minecraft'taki farklı modifikasyonların ayarlarını, bir düzine farklı türde arayüz yerine ortak bir görsel standarda indirgemektir. Fabric'te ve çoklu platform derlemelerinde Cloth Config API en yaygın ortak standart olmaya devam eder.