Gradle'ı kendim mi yüklemem gerekiyor?

Hayır. Fabric örnek şablonu, ilk çalıştırmada doğru Gradle sürümünü çeken bir Gradle wrapper içerir. Sistem Gradle'ı yerine gradlew komut dosyasını kullanın.

Başlangıcı sıfırdan yapayım mı, yoksa şablonu kullayım mı?

Resmi örnek mod şablonunu kullanın. Yapı eklentisi, Yarn eşleştirmeleri ve çalıştırma görevleri zaten yapılandırıldığı için, karmaşık kurulumu atlayıp kod yazmaya başlayabilirsiniz.

Yarn eşlemelerini kullanmak zorunda mıyım?

Yarn, varsayılan Fabric seçeneğidir ve belgelenmiş isimlerle birlikte gelir, bu yüzden kolay bir seçimdir. Resmi Mojang eşlemelerine karşı da geliştirebilirsiniz, ancak şablon kutudan çıktığı haliyle Yarn için hazırlanmıştır.

Hangi JDK sürümünü yüklemeliyim?

Hedef Minecraft sürümünüzün gerektirdiği olanı. Yeni sürümler daha yeni JDK'ler gerektirir, bu yüzden yüklemeden önce sürümü kontrol edin ve IDE'nizi o JDK'ye yönlendirin.

GenSources ne iş yapar?

Minecraft'ı seçtiğiniz Yarn eşlemelerine göre derlemesini bozarak, oyunun kodunu okuyabilmenizi ve geliştirme sürecinde sınıflarını okunabilir isimlerle referanslayabilmenizi sağlar.

Fabric Geliştirme Ortamını Kurulumu (2026)

Key takeaways

Kurulum dört adımdan oluşur: bir JDK, örnek mod şablonu, kendi eşleştirmeleriniz ve ardından Gradle.
Fabric build eklentisi Minecraft'ı indirir ve sizin için çalıştırma görevlerini hazırlar.
Gradle'ı asla kendiniz yüklemezsiniz: şablonda bir wrapper bulunur.
gradle.properties dosyasındaki sürüm uyuşmazlığı, yeni bir projenin başarısız olmasının en yaygın nedenidir.

Fabric geliştirme ortamını ayarlamak dört adımdan oluşur: bir JDK kurun, resmi örnek mod şablonundan başlayın, haritalamalarınızı seçin (genellikle Yarn), ardından Minecraft'ı indiren ve bir test istemcisini başlatan Gradle görevlerini çalıştırın. Yapı eklentisi zorlu işleri halleder. JDK'nuzu ve Minecraft sürümünüzü baştan eşleştirin ve geri kalanı kendiliğinden gelir.

Opal Nerede Kullanılır

Opal, bir Fabric modudur ve GraalVM JavaScript betik çalıştırma motoruna sahiptir, bu nedenle tam bir mod araç zinciri kurmadan betiklerle genişletebilirsiniz. Sadece yüklemek ve çalıştırmak istiyorsanız, kurulum kılavuzunu izleyin; betik yazmaya başlamak için betik dokümanlarına bakın.

Öncelikle İhtiyacınız Olanlar

Kod yazmaya başlamadan önce üç şeye ihtiyacınız var: bir Java Development Kit, bir IDE ve Git.

Bir JDK. Hedeflediğiniz Minecraft sürümüne uygun olanı seçin. Daha yeni Minecraft sürümleri daha yeni bir JDK gerektirir, bu yüzden başlamadan önce sürümün gereksinimlerini kontrol edin.
Bir IDE. IntelliJ IDEA veya Eclipse ikisi de işe yarar. Çoğu Fabric geliştiricisi, Gradle ve decompiler entegrasyonu daha sorunsuz olduğu için IntelliJ kullanır.
Git. Şablon deposunu klonlayacak ve kendi değişikliklerinizi takip edeceksiniz.

Gradle’ı kendiniz yüklemeyeceksiniz. Şablon, ilk çalıştırmada doğru sürümü indiren bir Gradle wrapper betiğiyle birlikte gelir.

Adım Adım

Bir JDK kurun

Hedef Minecraft sürümünüzle uyumlu bir JDK yükleyin ve IDE'nizi ona yönlendirin

Örnek mod şablonunu alın

Fabric resmi bir başlangıç deposu yayınlıyor. Klonlayın veya şablon olarak kullanın, ardından paketi ve mod kimliğini kendi değerlerinize göre yeniden adlandırın

Haritalamayı seçin

Şablon, varsayılan olarak Yarn kullanır. Yarn, Minecraft'ın sınıfları ve metotları için okunabilir, belgelenmiş isimler sağlar. Minecraft sürümünü, yükleyici sürümünü ve Yarn eşleme sürümünü gradle.properties dosyasında ayarlayın

Kaynakları oluştur ve çalıştır

IDE'nizde projeyi açın, Gradle'ın senkronize olmasını bekleyin, ardından Yarn isimlerine göre Minecraft'ı decompile etmek için genSources komutunu çalıştırın. Modunuz yüklü olan bir geliştirme istemcisini başlatmak için runClient görevini çalıştırın

Yapı Eklentisi Size Neler Yapar

Fabric için Gradle yapı eklentisi, Minecraft'ı indirir, seçtiğiniz eşlemelere göre yeniden düzenler ve çalıştırma yapılandırmalarını bağlar. Bunu build.gradle içindeki küçük bir blok aracılığıyla yapılandırırsınız.

Siz Ayarlarsınız	Nerede	Ne Kontrol Eder
Minecraft sürümü	`gradle.properties`	Hangi oyun sürümüne karşı derleme yaptığınız
Yükleyici sürümü	`gradle.properties`	Modunuzun çalıştığı Fabric yükleyicisi
Yarn sürümü	`gradle.properties`	Kaynak kodunuzda kullanılan eşleme adları
Bağımlılıklar	`build.gradle`	Fabric API ve herhangi bir kütüphane

Üç sürümü de gradle.properties içinde tutarlı tutun. Minecraft sürümü ile Yarn eşleme sürümü arasındaki uyumsuzluk, yeni bir projenin senkronize olmaması için en yaygın nedendir.

Eşlemelerin Burada Neden Önemli Olduğu

Minecraft karartılmış olarak gelir, bu nedenle sınıflarının adları a.a.a gibi olur. Yarn, bu adları okunabilir adlara eşler ve kararlı intermediary katmanının üzerine oturur. genSources komutunu çalıştırdığınızda, yapı eklentisi, Yarn adlarını kullanarak oyunu derler, böylece doğrudan Minecraft kodunu okuyabilir ve referans alabilirsiniz. Modunuzu derlerken, Yarn adlandırılmış kodunuzu intermediary'ye geri eşler, böylece bitmiş jar, eşleme yeniden adlandırmalarından bağımsız olarak herhangi bir uyumlu kurulumda çalışır.

Proje Derlenmediğinde

Gradle senkronizasyonu, içe aktar hemen ardından başarısız oluyor: genellikle gradle.properties dosyasındaki Minecraft, yükleyici ve Yarn sürümleri uyumlu değil. Bunları bilinen uyumlu bir sete ayarlayın.
Yanlış Java sürümü: derleme, Minecraft sürümünün ihtiyaç duyduğundan daha eski bir JDK'niz olduğunda desteklenmeyen bir sınıf dosya sürümü hakkında şikayet ediyor. Daha yeni bir JDK yükleyin ve projeyi ona yönlendirin.
Okunacak derlenmiş kaynak yok: genSources komutunu çalıştırın ve yeniden yükleyin. İlk çalıştırma, tüm oyunu derlediği için biraz zaman alabilir.
runClient hiçbir şey yapmıyor: herhangi bir görevi çalıştırmadan önce ilk Gradle senkronizasyonunun tamamlanmasına izin verin. Çalıştırma yapılandırmaları senkronizasyon sırasında oluşturulur.

Sıkça Sorulan Sorular

Opal'ı, bir Fabric istemcisini, $8.99 için edinin