Modlu Minecraft sunucusu nasıl kurulur?

Forge mu, Fabric mi, NeoForge mu?

Modlu sunucunun ilk kararı mod yükleyicidir, çünkü modlar yükleyiciye göre yazılır: Forge modu Fabric sunucusunda çalışmaz, tersi de geçerlidir. Seçimi aslında kurmak istediğiniz modlar yapar — önce oynamak istediğiniz modların veya modpack'in hangi yükleyiciyi hedeflediğine bakın, sunucuyu ona göre kurun.

Sunucu tarafı kurulum

Her yükleyicinin bir sunucu kurulum aracı (server installer) vardır: indirilen installer sunucu dosyalarını ve başlatma betiğini üretir. Java kurulumu, EULA onayı ve port açma adımları temel rehberdekiyle aynıdır; burada yalnız mod tarafına özgü farklar var.

mkdir -p ~/minecraft && cd ~/minecraft
java -jar forge-installer.jar --installServer
./run.sh   # ilk çalıştırma; eula.txt onayı temel rehberdeki gibi

java -jar fabric-installer.jar server -mcversion 1.21.1 -downloadMinecraft
java -Xms4G -Xmx8G -jar fabric-server-launch.jar nogui

Modlar, sunucu klasöründe oluşan mods dizinine .jar olarak atılır ve sunucu yeniden başlatıldığında yüklenir. Her modun tam olarak sunucunun Minecraft ve yükleyici sürümünü hedefleyen dosyasını indirin; "1.21 için Fabric" yazan bir mod 1.21.1 Forge sunucusunda çalışmaz.

Hazır modpack kurulumu

Tek tek mod toplamak yerine hazır bir modpack kurmak çoğu topluluk için daha pratiktir: mod seti, config dosyaları ve sürümler paketin sahibi tarafından uyumlu hâlde derlenmiştir. CurseForge ve Modrinth'te popüler paketlerin çoğu, sunucuya kurulmak üzere hazırlanmış ayrı bir "server pack" (server files) arşivi sunar.

1. Modpack sayfasından istemci arşivini değil "server pack" arşivini indirin.
2. Arşivi sunucuya aktarın ve sunucu klasörüne çıkarın.
3. Paketle gelen kurulum veya başlatma betiğini (install.sh, start.sh vb.) çalıştırın; yoksa yükleyicinin installer'ını paketin istediği sürümle kurun.
4. eula.txt onayını verip sunucuyu başlatın; ilk açılış config üretimi nedeniyle normalden uzun sürer.

scp server-pack.zip kullanici@sunucu-ip:~/minecraft/
cd ~/minecraft && unzip server-pack.zip

İstemci–sunucu eşleşmesi

Modlu sunucuda oyuncular sunucuya "boş" bir istemciyle giremez: istemcide aynı Minecraft sürümü, aynı yükleyici ve sunucuyla uyumlu mod seti kurulu olmalıdır. Sürüm veya mod listesi uyuşmadığında oyuncu bağlantı ekranında reddedilir ve çoğu zaman eksik ya da uyumsuz modların listesi gösterilir.

Her modun iki tarafta da olması gerekmez; modlar üç gruba ayrılır ve bu ayrım hem sunucunun mods klasörünü hem oyunculara dağıtacağınız listeyi belirler:

• Yalnız istemci: shader, minimap, envanter arayüzü gibi görsel modlar — sunucuya konmaz, oyuncu isterse kurar.
• Yalnız sunucu: yedekleme, izin yönetimi, performans ölçümü gibi yönetim modları — oyuncunun kurması gerekmez.
• İki taraflı: yeni blok, eşya, makine ve dünya üretimi ekleyen modlar — hem sunucuda hem her oyuncuda aynı sürümle kurulu olmalıdır.

Kaynak planı: modpack ne kadar bellek ister?

Modlu sunucunun kaynak ihtiyacını oyuncu sayısından çok mod sayısı ve modların türü belirler: dünya üretimini değiştiren ve makine simülasyonu çalıştıran paketler, sade bir Paper sunucusunun birkaç katı belleğe ihtiyaç duyar. Aşağıdaki değerler tipik başlangıç noktalarıdır; gerçek ihtiyacı sunucuyu yük altında izleyerek doğrulayın.

java -Xms8G -Xmx8G -jar fabric-server-launch.jar nogui

Crash teşhisi: sorunlu modu bulmak

Modlu sunucu çöktüğünde iki dosyaya bakılır: crash-reports klasöründeki son rapor ve logs/latest.log. Raporun üst kısmındaki "Caused by" satırı ile hata yığınında geçen mod kimliği, suçluyu çoğu zaman doğrudan söyler. En sık iki neden: bir modun bağımlılığının (kütüphane modunun) eksik olması ve modun sunucunun Minecraft/yükleyici sürümüyle uyuşmaması.

ls -t ~/minecraft/crash-reports | head -n 1
tail -n 50 ~/minecraft/logs/latest.log

Rapor açık bir mod adı vermiyorsa ikili arama en hızlı yoldur: mod listesini yarıya bölerek suçluyu birkaç denemede daraltırsınız.

1. mods klasörünün tamamını bir kenara kopyalayın.
2. Modların yarısını klasörden çıkarın (kütüphane/bağımlılık modlarını içeride tutun) ve sunucuyu başlatın.
3. Çökme sürüyorsa sorun kalan yarıda, düzeldiyse çıkardığınız yarıdadır.
4. Sorunlu yarıyı tekrar ikiye bölerek tek moda inene kadar yineleyin; bulduğunuz modu güncelleyin veya paketten çıkarın.

Dünya ve mod güncelleme disiplini

Modlar dünya kayıt dosyasına kendi bloklarını ve eşyalarını yazar. Bir modu kaldırdığınızda o modun blokları dünyadan silinir; bir modpack'i büyük sürüm atlatarak güncellediğinizde dünya üretimi değişebilir ve eski bölgelerle yeni bölgeler arasında kırık geçişler oluşabilir. Bu yüzden güncelleme, modlu sunucuda rutin değil planlı bir iştir.

tar -czf ~/yedek/guncelleme-oncesi-$(date +%F).tar.gz \
  ~/minecraft/world ~/minecraft/mods ~/minecraft/config

• Güncellemeden önce dünya, mods ve config klasörlerini birlikte yedekleyin — üçü bir bütündür.
• Modpack'in sürüm notlarını okuyun; paket sahipleri dünya bozan değişiklikleri genelde açıkça yazar.
• Modları tek tek değil, modpack'in test edilmiş yeni sürümüyle topluca güncelleyin.
• Mümkünse güncellemeyi önce dünya kopyasıyla ayrı bir test sunucusunda deneyin.

Sık sorulanlar