Forge Config API Port — Minecraft Java Edition

Vanilla Minecraft, oyun veya mod ayarlarını uygun bir şekilde yapılandırmak için yerleşik araçlar içermez, bu da geliştiricileri kendi ayar kaydetme sistemlerini oluşturmaya zorlar. Forge mod yükleyicisi, kendi yapılandırma sistemi şeklinde hazır bir çözüm sunar, ancak Fabric tarihsel olarak bunun için tek bir standarda sahip değildir. Bu nedenle, çapraz platform modlarının yaratıcıları her yükleyici için ayrı ayar kodu yazmak zorunda kalır ve bu süreçte çok fazla zaman harcarlar. Forge Config API Port kütüphanesi, Forge'un zaman içinde test edilmiş yapılandırma arayüzünü Fabric ve Quilt'e taşıyarak bu sorunu çözer.

Kütüphanenin çalışma prensibi

Forge Config API Port, mod kodu ile oyunun dosya sistemi arasında bir aracı görevi görür. Fabric ortamında orijinal net.minecraftforge.common.ForgeConfigSpec ve net.neoforged.fml.config paketlerini tamamen yeniden üretir. Geliştirici, standart Forge sözdizimini kullanarak yapılandırma açıklamasını yalnızca bir kez yazar ve kütüphane otomatik olarak diskte uygun dosyaları oluşturur ve yüklenmelerini yönetir.

TOML yapılandırma dosya biçimi

Kütüphane tüm ayarları TOML formatında kaydeder. Bu format, normal bir metin düzenleyici kullanarak okumak ve düzenlemek için uygun bir yapı sunar. Her parametre yorumları, varsayılan değerleri ve ayrıca izin verilen değerlerin net sınırlarını (minimum ve maksimum sayı) içerebilir. Yapılandırma dosyaları, modun ilk başlatılmasından sonra oyunun kök dizinindeki config klasöründe otomatik olarak görünür. Mod geliştiricisi tarafından belirtilen bir ada ve .toml uzantısına sahiptirler.

Otomatik senkronizasyon ve dinamik yeniden yükleme

Forge Config API Port'un en önemli özelliklerinden biri, yapılandırma senkronizasyonu ve dinamik yeniden yükleme için yerleşik desteğidir:

• Sunucu ve istemci arasındaki senkronizasyon (Sync): Bir oyuncu sunucuya bağlandığında, sunucu otomatik olarak kendi ayarlarını istemciye gönderir. Bu, sunucudaki oyuncular arasında farklı yapılandırma sürümleri nedeniyle çatışmaların oluşmasını önler.

• Dinamik yeniden yükleme (Reload): Kütüphane, TOML dosyalarındaki değişiklikleri gerçek zamanlı olarak izler. Oyun sırasında bir yapılandırma dosyasını düzenler ve kaydederseniz, Forge Config API Port, Minecraft istemcisini yeniden başlatmaya gerek kalmadan bellekteki parametreleri hemen güncelleyecektir.

Bu mekanizmalar otomatik olarak çalışarak geliştiricilerin yapılandırma değerlerini senkronize etmek için ağ etkileşimini kendilerinin kodlaması ihtiyacını ortadan kaldırır.

Oyuncular ve geliştiriciler için önemi

Sıradan oyuncular için Forge Config API Port gözle görülür herhangi bir içerik, yeni blok veya eşya eklemez. Rolü, diğer modların çalışmasını sağlamaktır. Diğer modlar bu kütüphanenin sınıflarına atıfta bulunuyorsa, bu kütüphane kurulmadan oyun kesinlikle başlamayacaktır. Forge ve NeoForge varsayılan olarak bu özelliklere sahip olduğundan, bu moda çoğunlukla Fabric kullanıcıları tarafından ihtiyaç duyulur.

Geliştiriciler için kütüphane, çapraz platform projeleri oluştururken vazgeçilmez bir araçtır. Şunları sağlar:

1. Daha önce farklı yükleyiciler için ayrı ayar kaydetme mantığı geliştirmeye harcanan yüzlerce satır koddan tasarruf etmenizi sağlar.

2. Yapılandırma dosyaları Fabric ve Forge'da aynı yapıya sahip olduğundan, son kullanıcılar için aynı mod yönetim deneyimini sunar.

3. Kullanıcının hatalı girdilerini otomatik olarak düzelten ve çökmeler sırasında parametreleri varsayılan değerlere döndüren Forge'un güçlü değer doğrulama araçlarını kullanmanızı sağlar.

Popüler bağımlı modlar

Fuzs (veya Fuzs_) adıyla bilinen kütüphanenin geliştiricisi, bunu tüm popüler modlarında kullanıyor. İşte birkaç ünlü örnek:

• Easy Magic: Büyü masası mekaniğini değiştiren, eşyaların masanın envanterinde tutulmasına izin veren ve büyüleri güçlendirmek için yeni yollar ekleyen bir mod.

• Trading Post: Etraftaki tüm köylülerin takas tekliflerini tek bir arayüzde birleştiren bir blok.

• Visuality: Çeşitli canavar eylemlerinden gerçekçi kir parçacıkları, kıvılcımlar ve su sıçramaları ekleyen görsel bir efekt modu.

• Easy Shulker Boxes: Shulker kutularını yere koymadan doğrudan envanterden onlarla etkileşime girmenizi sağlar.

Fuzs'un projelerine ek olarak, yüzlerce başka geliştirici çalışmalarını Forge'dan Fabric'e taşımak için Forge Config API Port'u kullanıyor ve oyuncuların çok büyük bir yüksek kaliteli içerik kütüphanesine erişmesini sağlıyor.