Fabric Loader, Fabric modlarını başlatır; Fabric API ise ek bir mod kütüphanesidir. Yeni bir Loader, eksik bir API'nin ya da yanlış Minecraft sürümüne ait bir mod dosyasının yerini tutmaz. mcfreehost üzerindeki bir Fabric sunucusunda bu yüzden önce sürümlerin tamamını ve somut başlatma mesajını kontrol edersin. Ancak ondan sonra etkilenen bileşeni değiştirir ve uygun bir istemciyle test edersin.
İçerik olarak kontrol edildi: 7 Ekim 2026. Bu rehber Fabric ile Java Edition'ı ele alır. Paper eklentileri, Forge/NeoForge dosyaları ve yerel Bedrock sunucuları farklı yazılım yollarıdır. Her paket için uygun olduğu söylenen belirli bir Loader sürümü önerilmez.
Minecraft, Loader ve API üç ayrı bilgidir
| Bileşen | Neyi belirler | Nerede karşılaştırırsın |
|---|---|---|
| Minecraft | Oyun sürümü ve dünyanın veri temeli | Sunucu başlatma logu ve fiilen başlatılan istemci örneği |
| Fabric Loader | Modların yüklenmesi ve bildirilen gereksinimlerin kontrolü | Başlatma logu, yazılım yönetimi ve paket gereksinimleri |
| Fabric API | Kendisine ihtiyaç duyan modlar için kütüphane işlevleri | mods klasöründeki mod dosyası ve indirme meta verileri |
| Modpack ve tek tek modlar | İçerikler, bağımlılıklar ve gereken taraf | Paket sürümü, sunucu paketi, dosya/proje bilgileri |
| Java | Minecraft'ın ve modların çalıştığı çalışma ortamı | Başlatma/çökme logu ve seçilen oyun sürümünün gereksinimi |
Üç yapı taşı, paketinin gereksinimlerine uymalıdır. Bir kütüphanenin en yeni sürümü, üçü için ortak bir sürüm numarası anlamına gelmez.
Fabric, mod kurulumu sayfasında oyun sürümünü, Loader ailesini ve Java sürümünü kontrol etmen gerektiğini açıklar. Başka bir Minecraft dalı için hazırlanmış bir Fabric API dosyası sadece yeniden adlandırılarak uyumlu hale gelmez. Aynı şekilde bir Forge modunu Fabric klasörüne koymak onu Fabric modu yapmaz.
1. Fiili sürüm setini kaydet
Herhangi bir müdahaleden önce şu bilgileri sunucu ve kullandığın istemci örneği için not al:
Minecraft: tam oyun sürümü
Fabric Loader: gerçekten yüklenen sürüm
Fabric API: dosya adı ve yayınlanan sürüm
Modpack: ad ve belirli paket sürümü
Java: başlangıç logunda kullanılan çalışma ortamı
Son değişiklik: son başarılı başlatmadan bu yana nelerin farklı olduğu
Bu, notların için bir şablondur; hazır ve uyumlu bir sürüm seti değildir. Özellikle birden fazla başlatıcı örneği varsa, doğru sürümün bir yerde kurulu olması yetmez: tam olarak o örneği başlatmalısın. Bir başlatıcı güncellemesi, bir paket sürümü ve bir Minecraft güncellemesi birbirinden farklı değişikliklerdir.
Hazır bir modpack kullanıyorsan, belgelenmiş sunucu paketi ve öngörülen istemci sürümüyle başla. Her modu tek tek "en yeni" sürüme getirme. Paketin bileşimi bilerek daha eski bir dosya kullanıyor olabilir. Asıl istemci indirmesi ve katılım için Modpack katılım rehberi (en) yardımcı olur.
2. Doğru API dosyasını ve mod tarafını seç
Resmi Fabric API projesinin dosya listesini aç ve Minecraft sürümüne göre filtrele. Ardından seçtiğin dosyanın paketin ve etkilenen modların gereksinimlerini karşılayıp karşılamadığını kontrol et. Yayın tarihi tek başına bu soruyu yanıtlamaz; yeni bir sürüm başka bir oyun dalı için hazırlanmış olabilir.
Diğer her dosya için şunları kontrol et:
- Fabric için yayımlanmış mı ve senin Minecraft sürümün için onaylanmış mı?
- İstemciye mi, dedicated sunucuya mı, yoksa her iki tarafa mı ait?
- Bu sürüm tam olarak hangi ek kütüphaneleri istiyor?
- Sunucu klasöründe aynı modun daha eski bir sürümü hâlâ duruyor mu?
Eski dosyanın yanına ikinci bir API dosyası koymak temiz bir değişim değildir. Uygun sürümü yerleştirmeden önce mevcut dosyayı aktif mods klasörünün dışına yedekle. Rastgele yeniden adlandırılmış bir JAR yine de yüklenebilir; eski aktif dosyayı gerçekten bu klasörden kaldır.
Saf grafik veya kullanım modlarına çoğu zaman yalnızca istemcide ihtiyaç duyarsın. Bu yüzden tüm istemci klasörünü kontrol etmeden sunucuya kopyalama. Fabric mod meta verileri client, server ve * ortamlarını birbirinden ayırır. Projenin veya sunucu paketinin bilgileri bağlayıcı olmaya devam eder; yanlış bildirilmiş bir mod yine de ancak daha sonra çökebilir.
3. Mesajı doğru oku
Sunucu yönetiminde başlatma çıktısını aç. Başlatma Incompatible mods found! gibi bir bağımlılık listesiyle kesiliyorsa şunları not et: hangi mod, hangi gereksinim ve hangi mevcut sürüm belirtiliyor.
| Gözlem | Anlamı | Hedefli sonraki adım |
|---|---|---|
| Gerekli bir mod eksik | Zorunlu bir bağımlılık karşılanmıyor | Eksik kütüphaneyi aynı Minecraft dalı için temin et |
| Mevcut API çok eski | Mod, farklı bir API sürümü veya sürüm aralığı istiyor | Bunun için onaylanmış bir API dosyası seç; eski aktif sürümü değiştir |
| Bir mod farklı bir Minecraft sürümü istiyor | İndirilen mod dosyası oyun dalına uymuyor | Uygun mod sürümünü ara; bunun için mevcut dünyayı körlemesine güncelleme |
| Loader gereksinimi karşılamıyor | Yüklenen Loader sürümü paket gereksinimine uymuyor | Loader değişikliğini başlatma yazılımında bir değişiklik olarak hazırla |
| Aynı mod tanımlayıcısı birden çok kez görünüyor | İki aktif dosya aynı modu sunuyor olabilir | Dosya listesinde ve paket içeriğinde yinelenen sürümleri kontrol et |
| Başlatma ilerliyor ve ancak bir Exception ile başarısız oluyor | Bağımlılık kontrolü hatayı tam olarak açıklamıyor | Başlatma/çökme raporunu ve son değişikliği incele |
Liste, birbiriyle bağlantılı birden fazla gereksinim içerebilir. Belirtilen çakışmayı birbirine ait bir set olarak çöz; en üstteki satır otomatik olarak tek neden değildir. Ardından eski mesajı takip etmek yerine yeni başlatma çıktısını kontrol et.
Bir Mixin hatası veya NoClassDefFoundError, tek başına eksik bir Fabric API'nin kanıtı değildir. Fabric'in çökme raporları kılavuzu ilgili hata zincirlerini, sistem verilerini ve mod listesini açıklar. İlk adı geçen mod olaya karışmış olabilir, ancak tek başına sorumlu olmayabilir. Sunucu hiç başlamıyorsa Başlatma hatası rehberi (en) sürüm seçimi dışındaki nedenleri de daraltmana yardımcı olur.
4. mcfreehost üzerinde değiştir ve geri dönüş yoluyla test et
Önce dünyayı, yapılandırmayı ve mevcut sürüm setini yedekle. Dünya dönüştürüldükten sonra geri dönmek için yalnızca mod dosyalarının kopyası yetmez. Değişikliği grubunun oynamadığı bir zamana planla ve sunucuyu yönetim panelinden düzgünce durdur.
Loader, başlatma yazılımının bir parçasıdır. Bunun için sunucunun öngörülen yazılım/sürüm yolunu kullan; sözde API olarak bir Loader JAR'ını mods içine koyma. Değiştirirken ya da yeniden kurarken gösterilen veri koruma notunu oku. Henüz eksiksiz bir yedek yoksa onaylamadan önce dur. API ve diğer mod kütüphaneleri ise uygun mod dosyaları olarak mods içine aittir.
Yönetilen bir modpack kullanıyorsan onun güncelleme ve kurulum yoluna uy. Sonraki bir paket güncellemesi, elle yaptığın dosya değişimini yeniden ezebilir. Bu yüzden kendi değişikliklerini not et ve bunların istediğin paket sürümüyle uyumlu olup olmadığını netleştir. Otomatik güncellemeleri nasıl kontrol edeceğini Güncelleme rehberi (en) anlatır.
Değişiklikten sonra sırayla şunları kontrol edersin:
- Sunucu çalışmaya hazır duruma ulaşıyor; yeni başlatma logu beklenen oyun ve Loader durumunu gösteriyor.
- Öngörülen paket sürümüne sahip bir istemci gerçekten katılabiliyor.
- Grubunuz için önemli bir mod işlevi doğru dünyada çalışıyor.
- Temiz bir yeniden başlatmadan sonra dünya ve ayarlar korunuyor.
Başarılı bir başlatma, henüz başarılı bir modpack katılımını doğrulamaz. Tersine, daha yeni bir API RAM eksikliğini gidermez. Başlatma sorunsuzsa ve sunucuyu ancak yeni chunk'lar veya çok sayıda entity zorluyorsa, bu kaynak sorununu sürüm hatasından ayır. Ücretsiz sunucular için ücretsiz başlangıcın sınırları geçerlidir; ek bir kütüphane kullanılabilir RAM'i artırmaz.
Yeni durum başarısız olursa başka değişiklik yapma ve belgelenmiş eski yazılım durumunu değişiklikten önceki yedekle birlikte geri yükle. Zaten daha yeni bir Minecraft ile yüklenmiş bir dünyayı, eski yazılımla doğaçlama bir düşürme olarak başlatma. Yardım için paket sürümünü, son değişikliği ve ilgili log satırlarını not et; logları paylaşmadan önce erişim bilgileri açısından kontrol et.
FAQ
Fabric Loader'ı her zaman en yeni sürüme getirebilir miyim?
Bir Loader birden fazla oyun sürümünü destekler, ancak bu her paket bileşimi için bir garanti değildir. Paketin ve modların gereksinimlerini kontrol et, mevcut durumu yedekle ve değişikliği test et. Bir Loader güncellemesi, yanlış seçilmiş bir mod dosyasının yerini tutmaz.
Fabric API'nin Minecraft ile aynı sürüm numarasına sahip olması gerekir mi?
Hayır. Fabric API'nin kendi sürüm numarası vardır. Belirleyici olan, o dosya için belirtilen Minecraft sürümleri ve onu kullanan modların gereksinimleridir.
Fabric API hem sunucuda hem istemcide bulunmak zorunda mı?
Bu, ilgili taraftaki modlara bağlıdır. Modlar Fabric API'ye ihtiyaç duyuyorsa orada uygun bir sürüm bulunmalıdır. Paket ve proje bilgileri, hangi dosyaların istemci, hangilerinin sunucu için öngörüldüğünü söyler.
İstemci ve sunucunun aynı Loader'a sahip olması gerekir mi?
Katılımı tek başına Loader numarası belirlemez. Her iki taraf da mod gereksinimlerini karşılamalıdır. Hazır bir paket için iki tarafta da onun öngördüğü sürümü kullanır ve Minecraft sürümünü uyumlu tutarsın; Loader'ı paketten bağımsız olarak değiştirme.
Eksik bir zorunlu bağımlılığı basitçe devre dışı bırakabilir miyim?
Bağımlılık kontrolünü devre dışı bırakmak, eksik işlevleri kullanılabilir hale getirmez. Uygun dosyayı ara ya da çalışan paket durumuna geri dön. Meta veri dosyasında değişiklik yapmak, bu rehber için normal bir onarım yolu değildir.
Sunucu başarıyla başladığı halde neden yine de katılamıyorum?
Sunucu başlatma yalnızca kendi ortamını kontrol eder. Yanlış başlatılmış bir istemci örneği, farklı bir paket sürümü ya da eksik ortak içerikler ancak katılım sırasında fark edilebilir. O zaman fiili sürümleri ve somut istemci hata mesajını karşılaştır.
Kaynaklar ve kontrol temeli
- Fabric: Modları kurma — Oyun sürümü, Loader ailesi ve kurulum.
- Fabric: Kurulum ve sunucu başlatıcısı — Başlatma kurulumunun parçası olarak Loader.
- Fabric API: yayımlanmış dosyalar — Oyun sürümleriyle eşleştirme.
- Fabric: Mod meta verileri — Ortamlar ve bildirilen bağımlılıklar.
- Fabric: Çökme raporlarını okuma — Hata zincirleri ve sistem/mod bilgileri.
Kaynaklar 7 Ekim 2026 tarihinde kontrol edildi. Somut bir sürüm seti, paketin için verilecek bir karar olarak kalır; bu makale, kendi dünyan için yeni bir başlatma veya katılım testi yapıldığını iddia etmez.