Fabric ile Minecraft Sunucu Kurulumu

Fabric sunucu kurulumu, Fabric Installer ile sunucu dizininde bir fabric-server-launch.jar üretmek ve bu dosyayı Java 25 ile çalıştırmaktan ibarettir. Minecraft 26.2 “Chaos Cubed” için doğru bileşen üçlüsü şudur: Fabric Loader 0.19.3, Fabric Installer 1.1.2 ve Fabric API 0.157.0+26.2. Kurulum on dakikadan kısa sürer; asıl iş modların sürüm uyumunu doğru kurmaktır.

Fabric, Minecraft sunucusuna mod desteği ekleyen hafif bir mod yükleyicidir. Forge’un aksine kendi devasa API katmanını zorunlu tutmaz; çekirdek yükleyici küçüktür, ihtiyaç duyulan işlevler Fabric API adlı ayrı bir mod üzerinden gelir. Bu tasarım sayesinde Fabric sunucuları hızlı açılır, daha az bellek harcar ve yeni Minecraft sürümlerine genellikle birkaç saat içinde uyum sağlar. Lithium, FerriteCore ve Krypton gibi performans modlarının önce Fabric’e çıkmasının sebebi de budur.

Bu sayfa işletim sisteminden bağımsız anlatılmıştır. Ekran ekran Windows adımları için Windows’ta Fabric sunucu kurulumu, terminal komutlarıyla ilerlemek isterseniz Ubuntu’da Fabric sunucu kurulumu sayfalarına geçebilirsiniz.

Fabric Nedir, Ne Zaman Tercih Edilir?#

Fabric iki parçadan oluşur. Birincisi Fabric Loader: oyunun kendi sınıflarına çalışma zamanında yama uygulayan, modları yükleyen çekirdek. İkincisi Fabric API: modların ortaklaşa kullandığı olay, kayıt ve ağ arayüzlerini sağlayan mod. Loader tek başına çalışır ama pratikte kuracağınız modların neredeyse tamamı Fabric API’yi bağımlılık olarak ister, bu yüzden ikisini birlikte düşünün.

Fabric’i şu durumlarda seçin:

• Sunucunuzda ağırlıklı olarak teknik ve performans modları çalışacaksa (Lithium, Krypton, FerriteCore, C2ME).
• Yeni Minecraft sürümüne hızlı geçmek istiyorsanız; Fabric 26.2’yi çıkışın hemen ardından destekledi.
• Az sayıda ama seçilmiş mod ile yalın bir survival sunucusu kuruyorsanız.

Büyük içerik modpackleri (RLCraft, All the Mods, Better MC) hâlâ çoğunlukla Forge/NeoForge tarafında olduğu için, hazır bir modpack sunucusu kuracaksanız Forge ile modlu sunucu kurulumu sayfası daha doğru adres olur. Paketin indirme sayfasında “Fabric” mi “Forge” mu yazdığını kurulumdan önce mutlaka kontrol edin; ikisi birbirinin yerine geçmez.

Fabric ve Diğer Sunucu Yazılımları Karşılaştırması#

Üç ailenin ayrıntılı farkları için sunucu yazılımları karşılaştırması sayfasına bakın. Mod ve eklentiyi aynı sunucuda birleştirme fikri kulağa cazip gelse de 26.x’te köprü projeleri güvenilir değildir; iki dünyayı ayırmak en sağlıklısıdır.

Kurulum Öncesi: Java 25 ve Donanım#

Fabric sunucusu, altında çalıştığı Minecraft sürümünün Java gereksinimine tabidir. 26.1 ve sonrasında bu değer Java 25’tir ve pazarlık payı yoktur; Java 21 ile başlatmayı denerseniz konsolda UnsupportedClassVersionError görür ve sunucu hiç açılmaz.

Sürüm eşleşmesinin tamamı hangi Java sürümü gerekir sayfasında. Donanım tarafında Minecraft’ın ana tick döngüsü tek çekirdekte çalıştığı için çekirdek sayısı değil saat hızı belirleyicidir: yüksek frekanslı AMD Ryzen 9 7900X/7950X sınıfı işlemciler, düşük frekanslı çok çekirdekli sunucu işlemcilerinden kat kat iyi TPS verir. Modlu sunucularda chunk üretimi yoğun disk I/O ürettiği için NVMe SSD şarttır.

İndirmeniz Gereken Dosyalar#

Adım Adım Fabric Sunucu Kurulumu#

1. Sunucu dizinini oluşturun#

   Sunucu dosyalarını boş ve yalnızca bu iş için ayrılmış bir klasörde tutun. Windows’ta C:\minecraft\fabric, Linux’ta /opt/minecraft/fabric tipik seçimlerdir. Masaüstü veya OneDrive gibi eşitlenen klasörlere kurmayın; dünya dosyaları bozulur.

2. Java 25 kurulumunu doğrulayın#

   Kurulumdan sonra terminalde (Windows’ta PowerShell, Linux’ta kabuk) sürüm kontrolü yapın. Çıktıda 25 ile başlayan bir numara görmelisiniz.

   java -version

   Sistemde birden fazla Java kuruluysa java komutu eski sürümü gösterebilir. Bu durumda başlatma komutunda JDK 25’in tam yolunu yazın.

3. Fabric Installer’ı sunucu kipinde çalıştırın#

   Grafik arayüz kullanmak isterseniz installer’ı çift tıklayıp Server sekmesinden Minecraft sürümünü 26.2, Loader’ı 0.19.3 seçin. Komut satırından tek adımda kurmak daha hızlıdır:

   java -jar fabric-installer-1.1.2.jar server -mcversion 26.2 -loader 0.19.3 -downloadMinecraft

   -downloadMinecraft parametresi vanilla server.jar dosyasını da indirir, böylece ayrıca resmî sunucu jar’ı aramanıza gerek kalmaz. İşlem bitince dizinde fabric-server-launch.jar, server.jar ve .fabric klasörü oluşur.

4. Sunucuyu ilk kez başlatın ve EULA’yı kabul edin#

   İlk çalıştırmada sunucu eula.txt üretip kapanır. Bu normaldir.

   java -Xms6G -Xmx6G -jar fabric-server-launch.jar nogui

   Oluşan eula.txt dosyasını açıp satırı şu hâle getirin:

   eula=true

   Bu adımı atlarsanız sunucu her açılışta kapanır; ayrıntı için EULA hatası çözümü sayfasına bakın.

5. server.properties dosyasını düzenleyin#

   Modlu sunucularda görüş mesafesini vanilla varsayılanında bırakmayın; chunk yükü modlarla birlikte katlanır.

   server-port=25565
   motd=\u00A7bBatihost Fabric Sunucusu
   max-players=40
   view-distance=8
   simulation-distance=6
   online-mode=true
   network-compression-threshold=256
   enable-command-block=false
   spawn-protection=0

   view-distance değerini 8’in üzerine çıkarmak, modlu bir sunucuda TPS’i en hızlı düşüren tek ayardır. Oyuncu başına yüklenen chunk sayısı bu değerin karesiyle büyür.

6. Modları yükleyin ve sunucuyu tekrar açın#

   Sunucu dizininde mods klasörü oluşmuş olmalı; yoksa elle oluşturun ve jar dosyalarını içine kopyalayın. Ardından sunucuyu yeniden başlatıp konsolda yüklenen mod sayısını kontrol edin.

Fabric API ve Mod Kurulumu#

Fabric’te mod kurulumu klasöre dosya kopyalamaktan ibarettir, ama üç kural vardır: her mod dosyası Minecraft sürümüyle eşleşmeli, Fabric API mutlaka bulunmalı ve yalnızca istemci tarafı çalışan modlar sunucuya konmamalıdır. Shader, minimap, envanter düzenleyici gibi modlar sunucu açılışını çökertir.

Doğru bir 26.2 sunucu dizini şuna benzer:

fabric/
├── .fabric/
├── mods/
│   ├── fabric-api-0.157.0+26.2.jar
│   ├── lithium-mc26.2-0.25.3-fabric.jar
│   ├── ferritecore-9.0.0-fabric.jar
│   └── krypton-0.3.1.jar
├── config/
├── world/
├── server.jar
├── fabric-server-launch.jar
├── server.properties
└── eula.txt

Mod dosyalarını yalnızca Modrinth, CurseForge veya modun kendi GitHub sürüm sayfasından indirin. İstemci ve sunucu tarafında hangi modun bulunması gerektiği konusu mod kurulumu rehberinde ayrıntılı anlatılıyor.

Sunucu tarafı performans modları#

26.1 Unobfuscation’ı ve Mod Uyumluluğu#

26.1 ile Mojang obfuscated sunucu jar’ı yayınlamayı bıraktı. Kod artık gerçek sınıf, metot ve alan adlarıyla dağıtılıyor. Bu, mod ekosistemi açısından sıradan bir sürüm atlaması değil, doğrudan bir ABI kırılmasıdır. Fabric bu değişiklikle birlikte yıllardır kullandığı Yarn mapping setini bıraktı ve Mojang Mappings’e geçti.

Pratikte yapmanız gereken şu: sunucuyu 26.2’ye taşımadan önce kullandığınız mod listesini çıkarın ve her birinin Modrinth/CurseForge sayfasında 26.2 etiketli bir dosya olup olmadığını tek tek doğrulayın. Bir modun 26.2 sürümü yoksa üç seçeneğiniz vardır: alternatif mod bulmak, o modu listeden çıkarmak veya sunucuyu şimdilik 26.1.2’de tutmak. Sürüm numaralandırmasının neden değiştiğini merak ediyorsanız yeni sürüm numaralandırması sayfasında ayrıntılı anlatıyoruz.

RAM Ayarları ve JVM Bayrakları#

Fabric sunucusu, başlatma komutunda verdiğiniz JVM bayraklarıyla çalışır. Sunucu jar’ının bir launcher’ı yoktur, dolayısıyla çöp toplayıcı seçimi tamamen sizin elinizdedir. Bayraksız başlatılan bir 26.x sunucusu Java 25’te G1GC kullanır — çünkü JEP 523 ile G1 hâlâ JVM’in genel varsayılan çöp toplayıcısıdır.

8–12 GB heap kullanan Fabric sunucularında G1GC ve Aikar’s Flags hâlâ en isabetli tercihtir; PaperMC’nin resmî dokümanı 26.x çıkışlarından sonra geri çekilmedi. 16 GB ve üzeri heap ile çalışan ağır modlu sunucularda ZGC değerlendirilebilir.

java -Xms14G -Xmx14G \
  -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 \
  -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:+AlwaysPreTouch \
  -XX:G1NewSizePercent=40 -XX:G1MaxNewSizePercent=50 -XX:G1HeapRegionSize=16M \
  -XX:G1ReservePercent=15 -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 \
  -XX:InitiatingHeapOccupancyPercent=20 -XX:G1MixedGCLiveThresholdPercent=90 \
  -XX:G1RSetUpdatingPauseTimePercent=5 -XX:SurvivorRatio=32 \
  -XX:+PerfDisableSharedMem -XX:MaxTenuringThreshold=1 \
  -jar fabric-server-launch.jar nogui

ZGC tercih edecekseniz tek bayrak yeterlidir: -XX:+UseZGC. Eski rehberlerde geçen -XX:+ZGenerational bayrağı Java 25’te obsolete durumdadır ve yalnızca uyarı basar, kullanmayın.

-Xms ve -Xmx daima eşit verilir; heap’in büyüyüp küçülmesi modlu sunucularda gereksiz duraklama üretir. Bayrakların tek tek ne yaptığını RAM ayarları ve JVM flag’leri sayfasında bulabilirsiniz.

Sık Karşılaşılan Fabric Hataları#

Incompatible mods found

Konsol hangi modun hangi sürümü beklediğini yazar. Genellikle eksik ya da yanlış sürüm Fabric API’dir. 26.2 için 0.157.0+26.2 dosyasını yükleyin.

UnsupportedClassVersionError

Java sürümü düşük. 26.x için Java 25 gerekir; sistemde birden fazla Java varsa başlatma komutunda tam yolu verin.

Mixin apply failed

Bir mod, o Minecraft sürümünde artık var olmayan bir kod noktasına yama uygulamaya çalışıyor. Neredeyse her zaman eski sürüm mod dosyasıdır.

java.lang.OutOfMemoryError

Heap yetersiz. 16 GB pakette -Xmx14G verildiği hâlde hata alıyorsanız sorun bellek miktarı değil, sızdıran bir moddur; spark ile bellek profili alın.

Sunucu açılıyor ama oyuncu bağlanamıyor

25565/TCP portu kapalı olabilir. Güvenlik duvarında gelen kural açın ve server.properties içindeki server-ip satırının boş olduğundan emin olun.

Konsolda görülen hatanın ilk satırı değil, Caused by: ile başlayan satırı okuyun; gerçek suçlu mod adı orada yazar. crash-reports klasöründeki dosyanın en üstünde de aynı bilgi bulunur.

Yedekleme ve Sürüm Yükseltme Disiplini#

Fabric sunucusunda en sık yaşanan veri kaybı, mod güncellemesi sırasında olur. Bir modun yeni sürümü dünya verisinde depoladığı NBT yapısını değiştirebilir ve geri dönüş mümkün olmaz. Bu yüzden şu sırayı bozmayın:

1. Sunucuyu düzgün kapatın#

   Konsola stop yazın. Süreci zorla sonlandırmak (kill / Görev Yöneticisi) yazılmamış chunk verisini kaybettirir.

2. Dünya ve mod klasörünü birlikte yedekleyin#

   Yalnızca world klasörünü almak yeterli değildir; aynı mod setine geri dönebilmek için mods ve config klasörlerini de aynı arşive koyun.

3. Test kopyasında deneyin#

   Yedeği ayrı bir dizine açıp yeni mod sürümleriyle bir kez başlatın. Konsolda hata yoksa canlı sunucuya uygulayın.

Otomatik yedek kurgusu için Minecraft sunucu yedekleme rehberine göz atın. Minecraft 26.2’ye geçişin tamamını adım adım görmek isterseniz 26.2 sunucu kurulumu ve güncelleme sayfası bu işin kontrol listesidir.

Özetle#

Fabric sunucu kurulumu üç karara indirgenebilir: doğru Java (26.x için Java 25), doğru Loader/Installer ikilisi (0.19.3 ve 1.1.2) ve mod sürümlerinin Minecraft sürümüyle birebir eşleşmesi. Kurulumun kendisi tek komutla biter; sunucuyu ayakta tutan şey mod uyumluluğunu takip etme disiplinidir.

26.1 ile gelen unobfuscation nedeniyle eski mod arşivinizi olduğu gibi taşıyamazsınız — bu, 26.x’e geçen sunucu sahiplerinin en çok zaman kaybettiği nokta. Lithium, FerriteCore ve Krypton üçlüsünü ilk günden kurun, heap değerini pakete göre sabitleyin ve her mod güncellemesinden önce dünya ile mod klasörünü birlikte yedekleyin. Donanım tarafında yüksek frekanslı Ryzen ve NVMe disk ile en az 8 GB RAM alt sınırını koruyun; modlu sunucuda 16 GB paket rahat çalışmanın anahtarıdır. Kurulum sırasında takıldığınız bir nokta olursa destek talebi açarak sistem ekibimize yazabilirsiniz.