GeckoLib (Forge/Fabric/NeoForge) – Kurulum, Sürüm Seçimi, Hata Çözümleri

GeckoLib, Minecraft modları için geliştirilmiş bir animasyon ve render (çizim) motorudur. Özellikle entity (mob), item, block ve armor gibi şeylere 3D keyframe animasyon eklemek isteyen mod yapımcılarının kullandığı bir “kütüphane mod” olarak çalışır. Yani çoğu oyuncu GeckoLib’i “tek başına içerik eklediği için” değil, başka bir mod GeckoLib’e ihtiyaç duyduğu için kurar. 🧩

Mod Ne İşe Yarar?

• Modların; mob, item, zırh, blok gibi şeylere daha gelişmiş animasyonlar eklemesini sağlar.
• Keyframe animasyonlar, easing (yumuşatma) geçişleri ve aynı anda birden fazla animasyon gibi sistemleri destekler.
• Birçok modun “animasyonlu yaratık/ekipman” özellikleri GeckoLib’e bağlıdır; kurulu değilse mod açılmaz veya crash verir.

Özellikler

• 3D keyframe tabanlı animasyon desteği (daha sinematik hareketler).
• 30+ easing (animasyon geçişlerini yumuşatma seçenekleri).
• Concurrent animations: aynı anda birden fazla animasyon çalıştırma.
• Ses / partikül / event keyframe desteği (mod geliştiricileri için).
• Farklı mod yükleyicilerinde (örn. Forge / Fabric / NeoForge) sürüme göre dosyaları bulunur.

Kurulum (Adım Adım)

1) Mod loader’ını doğru seç (çok önemli!)

• Oynadığın modpack Forge ise: Forge sürümünü indir.
• Modpack Fabric ise: Fabric sürümünü indir.
• Modpack NeoForge ise: NeoForge sürümünü indir.

2) Doğru Minecraft sürümünü seç

CurseForge sayfasında Files bölümünden, oynadığın Minecraft sürümüyle (ör. 1.20.1 / 1.21.1 / 1.21.11 vb.) uyumlu GeckoLib dosyasını seç.

3) Dosyayı mods klasörüne at

1. GeckoLib .jar dosyasını indir.
2. Şu klasöre kopyala:
   • .minecraft/mods/
3. Oyunu başlat.

4) Modpack kullanıyorsan (önerilen)

CurseForge App / Prism Launcher gibi bir launcher ile modpack kuruyorsan GeckoLib çoğu zaman otomatik “dependency” olarak yüklenir. Yine de mod açılmıyorsa, GeckoLib’in kurulu olup olmadığını kontrol et.

Nasıl Kullanılır? 🕹️

Oyuncu için: GeckoLib genelde “ayar menüsü olan bir içerik modu” gibi çalışmaz. Kurarsın ve ona ihtiyaç duyan modlar daha düzgün çalışmaya başlar.

Mod geliştiricisi için (çok kısa): GeckoLib, model/animasyon dosyalarıyla (Geo model + animasyon tanımları) çalışan bir animasyon altyapısı sunar. Bu rehber oyuncu odaklı olduğu için kod tarafına girmeden temel mantığı bilmen yeterli.

Teknikler & Kombinasyon Mantığı 🧠

• “Dependency mod” mantığı: GeckoLib’i, onu isteyen modlarla birlikte kullanırsın. Tek başına kurunca yeni mob/biome eklemesini bekleme.
• Sürüm eşleştirme: Crash’lerin büyük kısmı yanlış Minecraft sürümü veya yanlış loader seçmekten gelir.
• Modpack stabilitesi: Modpack hangi sürümde test edildiyse, GeckoLib’i de o sürüm aralığında tutmak daha sağlıklıdır (rastgele “en yeni” her zaman en iyi değildir).

Komutlar / Yaratıcı Mod Kullanımı ⌨️

• GeckoLib genelde oyuncu tarafında özel komut eklemez.
• Test etmek için, GeckoLib’e ihtiyaç duyan animasyonlu bir mod kurup oyunda o mob/armor/item’i görmen yeterlidir.

İpuçları 💡

• Oyunun açılmıyorsa: %90 ihtimalle GeckoLib’in loader’ı yanlış (Forge yerine Fabric gibi) veya Minecraft sürümü uyuşmuyor.
• Mod “GeckoLib required” diyorsa: GeckoLib’i kurmadan o mod çalışmaz.
• Güncelleme yaparken: Modpack’te bir sürü mod GeckoLib’e bağlı olabilir; büyük sürüm sıçramalarında (ör. 1.20.1 → 1.21.x) önce dünyanı yedekle.
• Çakışma arıyorsan: Önce sadece modpack + GeckoLib ile aç, sonra eklediğin diğer modları tek tek test et.