Sorunun kaynağını doğru sınıflandırma

Minecraft Java’da bir mod ekledikten sonra istemci açılırken veya sunucuya bağlanırken “missing registry” ya da benzeri kayıt hataları görülebilir. Bu genellikle modun tamamen bozuk olduğu anlamına gelmez; istemci ve sunucuda farklı mod sürümleri bulunması, yanlış mod yükleyicisi kullanılması veya gerekli bağımlılığın eksik olması daha olasıdır. Bu adımlar Java sürümü içindir; Bedrock eklentilerindeki davranışlarla karıştırılmamalıdır.

Önce hata oluşan yeri belirleyin:

• Oyun menüye gelmeden kapanıyorsa sorun istemci profili, yükleyici veya bağımlılıklarla ilgilidir.
• İstemci açılıyor fakat sunucuya bağlanırken hata veriyorsa istemci-sunucu mod listelerini karşılaştırın.
• Sunucu başlarken hata veriyorsa sunucu klasöründeki mod, yükleyici ve bağımlılık sürümlerini kontrol edin.

Güvenli uyumluluk kontrolü

1. Oyunu ve sunucuyu kapatın. Dünyanın veya sunucu kayıtlarının yedeğini ayrı bir klasöre alın.
2. Kullandığınız yükleyicinin türünü doğrulayın. Fabric için hazırlanmış bir modu Forge ya da NeoForge profiline, Forge için hazırlanmış bir modu da Fabric profiline kopyalamayın.
3. Mod dosyasının desteklediği Minecraft sürümünü, yükleyici türünü ve gerekli API veya kütüphaneleri kontrol edin. Yalnızca dosya adındaki sürüm numarasına güvenmeyin; modun açıklamasındaki bağımlılık koşulları belirleyicidir.
4. İstemci ve sunucuda bulunması gereken modları karşılaştırın. İçerik, blok veya eşya ekleyen modlar çoğunlukla iki tarafta da uyumlu sürüm ister. Sadece istemcide çalışan arayüz veya performans modları ise sunucuya kopyalanmamalıdır.
5. Son eklediğiniz modu ve ona bağlı kütüphaneleri geçici olarak çıkarıp temiz bir test profiliyle başlatın. Hata kaybolursa modları tek tek geri ekleyerek hangi dosyanın tetiklediğini bulun.

Yükleme sırasını ve kayıtları değerlendirme

Bazı modlar belirli bir sıraya ihtiyaç duymaz; ancak bağımlılık dosyalarının mevcut olması ve aynı yükleyici tarafından tanınması gerekir. Modları rastgele yeniden adlandırmak veya “çakışır” diye rastgele silmek yerine hata kaydındaki mod kimliklerini inceleyin. Özellikle şu belirtiler önemlidir:

• “Requires” veya “depends on” satırı: Eksik ya da uyumsuz bağımlılığı gösterir.
• “Duplicate” satırı: Aynı modun iki farklı sürümünün klasörde bulunduğunu belirtir.
• “Registry” veya “unknown entry” satırı: İstemci ve sunucunun aynı içeriği tanımadığını ya da kayıtların sürümler arasında değiştiğini düşündürür.

Dünya, mod kaldırıldıktan sonra açılmıyorsa yedeğe dönün; kayıt dosyasını elle düzenlemeyin. Sorun çözülmeden mevcut dünyayı yeni mod listesiyle kaydetmek, geri dönüşü zorlaştırabilir. Son doğrulama için önce yeni ve boş bir test dünyası açın, ardından yedeklenmiş kayıt üzerinde deneyin. Böylece hatanın mod yüklemesinden mi yoksa mevcut dünyanın verilerinden mi kaynaklandığını güvenli biçimde ayırabilirsiniz.