Fabric Geliştirme Ortamını Kurulumu Nasıl Yapılır

Fabric modlama ortamını ayarlamak dört adımdan oluşur: bir Java Development Kit kurun, resmi örnek mod şablonundan başlayın, Yarn eşlemelerini yapılandırın ve ardından Gradle'ı çalıştırın. Fabric build eklentisi Minecraft'ı indirir ve geri kalanını bağlar. JDK'nizi ve Minecraft sürümünüzü önceden eşleştirin, sistem geri kalanını halleder.

İlk olarak ihtiyacınız olanlar

Kod yazmadan önce:

• Minecraft sürümünüze uygun bir JDK. Daha yeni Minecraft sürümleri daha yeni JDK'ler gerektirir. Kurulum yapmadan önce hedef sürümünüzün gereksinimlerini kontrol edin.
• Bir IDE. IntelliJ IDEA Community (ücretsiz) veya Eclipse ikisi de iyi çalışır. Çoğu Fabric geliştiricisi Gradle entegrasyonu daha sorunsuz olduğu için IntelliJ kullanır.
• Git. Şablon deposunu klonlayacak ve kendi kodunuzu yöneteceksiniz.

Gradle'ı kurmanıza gerek YOK. Şablon, ilk çalıştırmada doğru sürümü indiren bir wrapper betiği içerir.

Adım adım

1. Bir JDK kurun

   Hedef Minecraft sürümünüzle eşleşen Adoptium veya Oracle'dan bir JDK indirin. Minecraft 1.21 için Java 21'i yükleyin. IDE'nizin ayarlarında bu JDK'yi belirtin.

2. Örnek mod şablonunu alın

   Resmi Fabric GitHub örnek mod deposuna gidin ve onu klonlayın veya bir şablon olarak kullanın. Paket ve mod kimliğini kendi değerlerinizle yeniden adlandırın.

3. Sürümleri gradle.properties dosyasında ayarla

   Gradle.properties dosyasını açın ve üç satırı güncelleyin:

   • minecraft_version — hedef Minecraft sürümünüz (örneğin, 1.21)
   • loader_version — Minecraft derlemenize uygun Fabric loader sürümü
   • yarn_mappings — Minecraft sürümünüz için Yarn sürümü

   Bu üç değerin eşleşmesi ZORUNLU, aksi takdirde proje derlenmez.

4. IDE'nizde açın ve senkronize edin

   IDE'nizde proje klasörünü açın. Gradle'ın ilk senkronizasyonunu yapmasını bekleyin (bağımlılıkları indirir, çalıştırma yapılandırmalarını oluşturur).

5. Derlenmiş kaynak kodunu oluştur

   IDE'nizin Gradle paneli içinde genSources'u çalıştırın. Bu, Minecraft'ı Yarn isimleriyle derlemesini geri alarak oyunun kodunu okuyabilmenizi sağlar.

6. Test bir istemciyi başlat

   runClient'i çalıştırarak modunuz yüklü olarak Minecraft'ı başlatın. Geliştirme istemcisi, tam hata ayıklama özelliklerine sahiptir.

İşte bu kadar. Artık çalışan bir Fabric geliştirme ortamınız var.

gradle.properties dosyasını anlama

Bu dosya tüm derlemenizi yapılandırır. Üç sürüm senkronize kalmalıdır:

minecraft_version=1.21
loader_version=0.15.11
yarn_mappings=1.21+build.32

Minecraft 1.21, Yarn ise 1.20.1 ise, Gradle senkronizasyonu anlaşılmaz bir hata ile başarısız olur. Her zaman fabricmc.net/use adresinden veya örnek şablondan eşleşen sürümleri alın.

Yapı eklentisi ne yapar

Fabric Gradle eklentisi build.gradle içinde yapılandırılır ve şunları yönetir:

• Minecraft'ı indirme
• Seçtiğiniz eşlemeleri kullanarak derleme
• Kodunuzu uyumluluk için ara katmana yeniden eşleme
• IDE çalıştırma yapılandırmalarını oluşturma

Bunu yalnızca bir kez yapılandırırsınız; geri kalanını otomatikleştirir. İşte şablonun neden önemli olmasının nedeni—zaten her şey doğru şekilde bağlanmış durumda.

Eşlemeler açıklanıyor

Minecraft karartılmış olarak gönderilir (sınıf adları gibi a, b, c). Eşlemeler bunları okunabilir adlara çevirir.

• Yarn: Fabric'in varsayılanı. Belgeler içerir. Okuması kolaydır.
• Mojang Eşlemeleri: Resmi ancak daha az belgelenmiş. Daha anlaşılması güç adlar.

Şablon Yarn kullanır. genSources komutunu çalıştırdığınızda, Minecraft Yarn adlarını kullanarak derlenir, böylece gerçek kodu okuyabilirsiniz. Derleme sırasında Fabric, modun herhangi bir eşleşen Minecraft sürümünde çalışması için onu ara katmana (altında yer alan kararlı bir katman) yeniden eşler.

Yaygın kurulum sorunları

• ✓Gradle senkronizasyonu hemen başarısız oluyor: gradle.properties dosyasını kontrol edin. Minecraft, yükleyici ve Yarn sürümleri eşleşmelidir. Fabric web sitesinden bilinen bir kombinasyon kullanın.
• ✓Derleyici hatası: Java sürümüyle ilgili bir sorun var: JDK'nuz Minecraft sürümü için çok eski. Daha yeni bir JDK yükleyin ve IDE'nizi ona yönlendirin.
• ✓Minecraft kaynak kodunu okuyamıyorum: Gradle paneli içinde genSources'u çalıştırın ve yeniden yükleyin. İlk çalıştırma yavaştır çünkü tüm oyunu derliyor.
• ✓runClient hiçbir şey yapmaz: ilk Gradle senkronizasyonunun tamamlanmasını bekleyin. Çalıştırılacak yapılandırmalar senkronizasyon sırasında oluşturulur.
• ✓IDE projenizi içe aktaramıyor: IDE'nin ayarlarında JDK seçili olduğundan emin olun, JRE değil.

Kurulumdan Sonraki Adımlar

Ortamınız çalıştıktan sonra:

1. Örnek mod sınıflarını silin veya yeniden adlandırın
2. Kendi mod paketinizi oluşturun
3. Basit bir özellik uygulayın (bir blok, öğe veya olay dinleyicisi)
4. runClient'ı çalıştırın ve geliştirme istemcisinde test edin
5. Yineleyin

Geliştirme istemcisi, yinelemeyi hızlandıran tam hata ayıklama ve sıcak yeniden yükleme desteği içerir.

IDE'ye Özel Notlar

IntelliJ IDEA:

• Gradle projesi (sadece bir klasör değil) olarak içe aktarın
• Herhangi bir görevi çalıştırmadan önce Gradle'ın tamamen senkronize olmasını bekleyin
• Çalıştır yapılandırmaları, çalışma açılır menüsündeki "Gradle" altında görünür

Eclipse:

• Mevcut bir Gradle projesi olarak içe aktarın
• Projeye sağ tıklayın → Gradle → Senkronizasyondan sonra Gradle Projesini Yenile
• Gradle görevleri Gradle Görevleri görünümünde görünür

Sıkça Sorulan Sorular