Minecraft Sunucuları 8 dk okuma

Minecraft Sunucusuna Modpack Kurulumu: Forge, NeoForge ve Fabric Rehberi

CurseForge veya Modrinth'teki bir modpack'i oyun panelinde dünyanızı silmeden kurun: sunucu paketini bulma, Forge/NeoForge/Fabric kurulumu, SFTP ile yükleme, doğru Java sürümü ve en sık hataların çözümü, ekran görüntüleriyle.

Minecraft Sunucusuna Modpack Kurulumu: Forge, NeoForge ve Fabric Rehberi
AnkSOFT
Yayıncı

All the Mods, Prominence, Better MC ya da Cobblemon gibi bir modpack'i arkadaşlarınızla oynamak için sunucuya kurmak istiyorsunuz ama sunucu açılmıyor, modlar yüklenmiyor ya da oyuna girerken "eksik mod" hatası alıyorsunuz. Bu sorunların neredeyse hepsi üç şeyden birine dayanır: yanlış dosya (istemci paketi), yanlış yükleyici sürümü ya da yanlış Java sürümü.

Bu rehberde CurseForge veya Modrinth'teki bir modpack'i oyun panelimizde dünyanızı silmeden, adım adım nasıl kuracağınızı ekran görüntüleriyle anlatıyoruz. Forge, NeoForge ve Fabric paketleri için aynı yol geçerlidir.


Önce Bilmeniz Gereken 3 Şey

  1. Sunucuya sunucu paketi yüklenir. Modpack'lerin oyuncu için hazırlanan (istemci) paketi sunucuda çalışmaz. Aradığınız dosyanın adında genellikle Server Pack, ServerFiles ya da server geçer.
  2. Minecraft sürümü ve yükleyici sürümü birebir aynı olmalı. Ör. "Minecraft 1.20.1 + Forge 47.4.x" ya da "Minecraft 1.21.1 + NeoForge 21.1.x". Bu bilgi modpack sayfasında yazar.
  3. Yükleyiciyi (Forge/NeoForge/Fabric) panel kurar, modları siz yüklersiniz. Sunucu paketinin içindeki run.sh, startserver.bat gibi başlatma dosyaları panelde kullanılmaz; panel sunucuyu kendi başlatma komutuyla açar.

1. Sunucu Paketini Bulun ve Sürümü Not Edin

CurseForge: Modpack sayfasında Files sekmesine geçin, oyuncuların kullandığı modpack sürümünü açın ve Additional Files bölümündeki Server Pack (.zip) dosyasını indirin.

Modrinth: Modpack sayfasında Versions sekmesine geçin. Sürümün ek dosyalarında adında server geçen bir .zip varsa onu indirin. .mrpack dosyası oyuncu paketidir, doğrudan sunucuya kurulmaz. Sunucu dosyası yoksa paketin açıklamasında veya Discord'unda sunucu kurulum talimatı genellikle yer alır.

İndirirken şu iki bilgiyi not edin: Minecraft sürümü ve yükleyici + sürümü.

Modpack sunucu dosyası nereden bulunur: CurseForge ve Modrinth adımları


2. Sunucuyu Durdurun ve Dünyanızı Yedekleyin

Oyun panelimize giriş yapın, sunucunuzu seçin ve Terminal ekranındaki kare (Stop) butonuyla sunucuyu durdurun.

Mevcut dünyanızı korumak istiyorsanız world klasörünü önce bilgisayarınıza indirin. Nasıl yapılacağını dünya yedeği alma ve SFTP rehberimizde anlattık.

Not: Vanilla/Paper ile oluşturulmuş bir dünya çoğu durumda modpack ile açılabilir; ancak modpack'in kendi dünya üretimi yalnızca yeni keşfedilen bölgelerde görünür. Temiz bir başlangıç istiyorsanız world klasörünü yedekleyip silin.


3. Yükleyiciyi Panelden Kurun (Forge, NeoForge, Fabric)

Sol menüde More → Versions ekranını açın. Modpack'inizin yükleyicisini seçin (Forge, NeoForge veya Fabric), ardından Minecraft sürümüne tıklayın.

Açılan pencerede:

  • Build listesinden modpack'in istediği yükleyici sürümünü seçin (ör. Forge 47.4.28). Emin değilseniz önerilen (stable) sürüm çoğu pakette çalışır.
  • Wipe Server Files seçeneğini kapalı bırakın. Açarsanız sunucudaki tüm dosyalar, dünyanız dahil, silinir.
  • Install butonuna basın.

Versions ekranında Forge 1.20.1 kurulumu ve Wipe Server Files seçeneği

Panel kurulumda Server Jar File değerini server.jar yapar ve uygun Java sürümünü otomatik seçer. Kurulum birkaç dakika sürebilir.

Yeni sipariş veriyorsanız sipariş formundaki Sunucu Yazılımı alanından Forge seçebilirsiniz. Sunucu yazılımınızın değiştirilmesi gerekiyorsa (ör. "sunucumu Forge 1.20.1'e geçirin") destek talebi oluşturmanız yeterlidir; başlatma komutu müşteri panelinden değiştirilemez.


4. Java Sürümünü Kontrol Edin

Startup sekmesine geçin. Sağ üstteki Docker Image alanı sunucunun hangi Java ile çalışacağını belirler. Versions ekranı bunu otomatik ayarlar; elle değiştirdiyseniz aşağıdaki tabloya göre seçin.

Minecraft sürümü Java
1.16.5 ve altı Java 8
1.17 – 1.20.4 Java 17
1.20.5 – 1.21.x Java 21
26.x Java 25

Startup sekmesi: başlatma komutu ve Docker Image (Java) seçimi

unix_args.txt, run.sh, server.jar farkı: Forge 1.17 ve üzeri ile NeoForge, sunucuyu tek bir jar yerine libraries klasöründeki unix_args.txt dosyasıyla başlatır. run.sh bunu bilgisayarda çalıştırmak içindir; panelde kullanılmaz. Panelin kurduğu server.jar bu başlatmayı sizin yerinize yapar. Bu yüzden Server Jar File alanını server.jar olarak bırakın.


5. Modpack Dosyalarını Yükleyin

Files bölümüne geçin ve sağ üstteki Upload butonuyla sunucu paketini (.zip) yükleyin. Yükleme bitince dosyanın sağındaki ⋯ menüsünden Unarchive seçin.

Files bölümü: Upload butonu ve Unarchive seçeneği

Çıkardıktan sonra ana dizinde mods, config ve paketinize göre defaultconfigs, kubejs gibi klasörleri görmelisiniz.

Dosyalar çıkarıldı: config, defaultconfigs, kubejs ve mods klasörleri

Dikkat etmeniz gerekenler:

  • Dosyalar bir alt klasöre çıktıysa (ör. ServerFiles-1.4.2/mods), klasörün içindekileri seçip Move ile ana dizine taşıyın.
  • Sunucu paketinde libraries klasörü, forge-…-installer.jar ya da başlatma dosyaları varsa bunlara gerek yoktur; yükleyiciyi 3. adımda panel kurdu. Silebilirsiniz.
  • Ana dizinde eula.txt dosyasının içeriği eula=true olmalıdır. İlk açılışta panel EULA onayı isterse I Accept ile onaylayın.

100 MB'tan Büyük Paketler: SFTP ile Yükleyin

Tarayıcıdan yükleme büyük dosyalarda yarıda kesilebilir. 100 MB'ı aşan paketleri SFTP ile yükleyin:

  1. Settings sekmesindeki SFTP Details kutusunda sunucu adresini ve kullanıcı adını görürsünüz. Şifre, panele giriş yaptığınız şifrenizdir.
  2. FileZilla veya WinSCP'yi açın. Protokol olarak SFTP seçin, adres, port (2022), kullanıcı adı ve panel şifrenizi girin.
  3. Bağlandıktan sonra .zip'i sunucunun ana dizinine sürükleyin, ardından panelden Unarchive ile çıkarın. Dilerseniz paketi bilgisayarınızda açıp mods ve config klasörlerini doğrudan da yükleyebilirsiniz.

Settings sekmesi: SFTP Details (adres, kullanıcı adı, şifre bilgisi)


6. Sunucuyu Başlatın

Terminal ekranına dönün ve Start ile sunucuyu başlatın. Büyük modpack'lerde ilk açılış birkaç dakika sürebilir. Konsolda en sonda Done yazısını gördüğünüzde sunucunuz hazırdır.

Konsolda Forge ile açılan sunucu ve Done mesajı

Oyuncuların da aynı modpack'i aynı sürümle (CurseForge veya Modrinth uygulamasından) kurması gerekir; aksi halde sunucuya bağlanırken mod uyuşmazlığı hatası alırlar.


Ne Kadar RAM Gerekir?

Modpack'in büyüklüğü RAM ihtiyacını belirler. Genel bir fikir vermesi için:

Modpack Önerilen RAM
Hafif (50 moda kadar) 4–6 GB
Orta (100–200 mod) 6–10 GB
Büyük (ATM, 300+ mod) 12–16 GB

Oyuncu sayısı ve keşfedilen alan arttıkça ihtiyaç da artar. Konsolda OutOfMemoryError görüyorsanız ya da sunucu sürekli kapanıyorsa daha yüksek RAM'li bir pakete geçmeniz gerekir.


En Sık Karşılaşılan Hatalar ve Çözümleri

"Could not find or load main class @unix_args.txt" veya "UnsupportedClassVersionError". Java sürümü yanlıştır. Aşağıdaki örnekte Forge 1.20.1 sunucusu Java 8 ile başlatılmış. Startup → Docker Image alanından tablodaki doğru Java'yı seçin ve sunucuyu yeniden başlatın.

Yanlış Java sürümü: konsolda java 1.8 ve Could not find or load main class hatası

"Missing or unsupported mandatory dependencies" / "Mod X requires Y". Bir mod, başka bir modu ya da farklı bir yükleyici sürümünü istiyor. Hata satırında adı geçen modu mods klasörüne ekleyin veya Versions ekranından modpack'in istediği Forge/NeoForge/Fabric build'ini kurun.

"Attempted to load class net/minecraft/client/... for invalid dist DEDICATED_SERVER". Sunucuya yalnızca oyuncu tarafında çalışan (client-only) bir mod yüklenmiş. Hata satırında geçen modu mods klasöründen silin. OptiFine, Iris/Oculus, Sodium/Embeddium gibi görüntü ve performans modları buna en sık örnektir. Bu sorun genellikle sunucu paketi yerine istemci paketi yüklendiğinde görülür.

Sunucu açılıyor ama modlar yok. Yükleyici kurulmamış ya da Server Jar File alanı eski bir dosyayı gösteriyordur. 3. adımı tekrarlayın; alan server.jar olmalıdır.

Oyuncular giremiyor: "Mod rejections" / "Incompatible mod set". Oyuncunun bilgisayarındaki modpack sürümü sunucudakiyle aynı değildir. Herkesin aynı modpack sürümünü kurduğundan emin olun.

Yükleme yarıda kalıyor. Dosya büyüktür; SFTP ile yükleyin (5. adım).


Ne Zaman Destek Talebi Açmalısınız?

Hizmet sözleşmemiz gereği mod ve modpack kurulumu müşterinin sorumluluğundadır; yine de takıldığınız noktada yanınızdayız. Yukarıdaki adımlara rağmen sunucunuz açılmıyorsa ya da sunucu yazılımınızın değiştirilmesi gerekiyorsa destek talebi oluşturun ve şunları ekleyin:

  • Modpack'in adı ve sürümü (ör. "ATM9 1.1.0")
  • Minecraft ve yükleyici sürümü (ör. "1.20.1, Forge 47.4.28")
  • Konsoldaki ilk hata satırları ya da crash-reports klasöründeki en yeni dosya

Bu bilgilerle sorununuzu çok daha hızlı yönlendirebiliriz.


Modpack'iniz için yeterli RAM'e sahip bir sunucuya ihtiyacınız varsa Minecraft sunucu paketlerimize göz atabilirsiniz. Sürüm değiştirme hakkında daha fazla bilgi için Minecraft sürüm ve yazılım değiştirme rehberimizi de okuyabilirsiniz.

Sıkça Sorulan Sorular

Modpack'in hangi dosyasını sunucuya yüklemeliyim?

Sunucu paketini (Server Pack / ServerFiles). CurseForge'da modpack sürümünün Additional Files bölümünde, Modrinth'te sürümün ek dosyalarında bulunur. Oyuncu (istemci) paketi ve .mrpack dosyası sunucuda doğrudan çalışmaz.

Forge veya NeoForge'u nasıl kurarım?

Panelde More → Versions ekranından yükleyiciyi ve Minecraft sürümünü seçip modpack'in istediği build'i kurun. Wipe Server Files seçeneğini kapalı bırakın; panel server.jar ve Java sürümünü otomatik ayarlar.

Modpack kurulumu dünyamı siler mi?

Versions ekranında Wipe Server Files kapalıysa dünyanız silinmez. Yine de büyük değişikliklerden önce world klasörünü bilgisayarınıza yedeklemenizi öneririz.

100 MB'tan büyük modpack'i nasıl yüklerim?

SFTP kullanın. Settings → SFTP Details'teki adres ve kullanıcı adıyla, panel şifrenizi kullanarak FileZilla veya WinSCP üzerinden bağlanıp dosyayı yükleyin, ardından panelden Unarchive ile çıkarın.

Modpack için ne kadar RAM gerekir?

Hafif paketler için 4–6 GB, 100–200 modluk paketler için 6–10 GB, ATM gibi büyük paketler için 12–16 GB önerilir. Oyuncu sayısı arttıkça ihtiyaç da artar.

TR| EN