Modlu Minecraft sunucusu kurmak, vanilla sunucu kurmaktan yalnızca tek bir adım fazlasını gerektirir: oyunun kendisiyle modlar arasına bir mod yükleyici (mod loader) koymak. Geri kalan her şey — Java kurulumu, port açma, EULA kabulü, dünya oluşturma — aynıdır. Bu sayfada bir VDS (sanal özel sunucu) kiraladıktan sonra sıfırdan çalışır bir modlu sunucuya nasıl ulaşacağınızı, hiçbir adımı atlamadan anlatıyoruz.
Anlatım Minecraft 26.2 “Chaos Cubed” üzerinden yapılıyor ama mantık her sürümde aynı. Kurulum boyunca dört karar noktası var: hangi Minecraft sürümü, hangi mod yükleyici, hazır modpack mi kendi mod listeniz mi, ve ne kadar RAM. Bu dördünü baştan doğru vermezseniz sunucu ya hiç açılmaz ya da oyuncular bağlanamaz. Önce bunları netleştirip sonra kuruluma geçeceğiz.
Modlu Sunucu Nedir, Normal Sunucudan Farkı Nedir?#
Vanilla Minecraft sunucusu mod yükleyemez. Mojang’ın dağıttığı server.jar yalnızca oyunun kendisini çalıştırır; oyunun iç sınıflarına dışarıdan kod enjekte etmenin bir yolu yoktur. Modlar tam olarak bunu yaptığı için araya bir katman gerekir. Forge, NeoForge ve Fabric bu katmandır: sunucu açılırken önce yükleyici çalışır, mods klasöründeki jar dosyalarını okur, aralarındaki bağımlılıkları çözer ve modların oyun koduna kancalarını takmasına izin verir.
Modlu sunucu ile eklentili (plugin) sunucuyu karıştırmayın — bu, yeni başlayanların en sık yaptığı hatadır:
- Mod, oyuna yeni içerik ekler: blok, eşya, makine, boyut, canlı. Hem sunucuda hem oyuncuda kurulu olmak zorundadır. Forge/NeoForge/Fabric ister.
- Eklenti (plugin), var olan oyunun kurallarını değiştirir: yetki, ekonomi, bölge koruma, ışınlanma. Yalnızca sunucuda bulunur, oyuncu vanilla oyunla girer. Paper, Spigot veya Purpur ister.
Survival, skyblock veya minigame sunucusu kurmak istiyorsanız muhtemelen mod değil eklenti arıyorsunuz. Teknik modpack, otomasyon, RPG veya “oyunu baştan değiştiren” bir deneyim istiyorsanız doğru yerdesiniz.
Bu ayrımın pratik bir sonucu daha var: modlu bir sunucu, aynı oyuncu sayısındaki eklentili bir sunucudan çok daha ağırdır. Sebebi basit — her mod açılışta kendi bloklarını, eşyalarını, tariflerini ve varlık türlerini bellekteki bir kayıt defterine yazar. Bu defter oyuncu bağlanmasa bile orada durur. Yani 300 modlu bir sunucu, tek bir oyuncu için bile 16 GB’lık bir bellek tabanı ister. Vanilla sunucularda RAM ihtiyacını oyuncu sayısı belirlerken, modlu sunucularda mod sayısı belirler.
Başlamadan Önce Vermeniz Gereken Üç Karar#
1. Hazır modpack mi, kendi mod listeniz mi?#
Yeni başlıyorsanız hazır modpack kurun. Modpack, birbiriyle uyumlu olduğu test edilmiş yüzlerce modun tek pakette toplanmış hâlidir; ayrıca hazır yapılandırma dosyalarıyla gelir. Kendi listenizi toplarsanız her modun bağımlılığını, sürüm aralığını ve diğer modlarla çakışmasını elle çözmek zorunda kalırsınız. Modpack kuracaksanız CurseForge modpack sunucusu kurulumu sayfası bu işin ayrıntılı anlatımıdır.
2. Hangi Minecraft sürümü?#
Burada dürüst olmak gerekiyor: Ağustos 2026 itibarıyla büyük “kitchen sink” modpacklerin çoğu hâlâ Minecraft 1.21.1 + NeoForge üzerinde. All the Mods 10 gibi paketler 1.21.1 için yayınlanıyor ve Java 21 istiyor. 26.x tarafına geçiş başladı (All the Mods 11 gibi paketler 26.1 hattını destekliyor) ama 26.2 için 200-400 modluk hazır paket henüz yok denecek kadar az. Yani “en yeni sürüm” istiyorsanız az modla, “en zengin modpack” istiyorsanız daha eski bir sürümle yaşamayı kabul edeceksiniz.
3. Hangi mod yükleyici?#
Bu kararı siz vermezsiniz, modlarınız verir. Modpack indiriyorsanız paketin sayfasında yükleyici yazılıdır. Kendi listenizi topluyorsanız modların çoğunluğunun hedeflediği yükleyiciyi seçin. Bir Forge modunu Fabric sunucusuna atarsanız yüklenmez; tersi de geçerlidir.
Mod Yükleyici Seçimi: Forge, NeoForge ve Fabric#
Üç yükleyici de aynı işi farklı felsefeyle yapar. Kurulum adımları Forge ile NeoForge’da neredeyse birebir aynıdır (aynı installer altyapısını kullanırlar); Fabric ise klasik tek jar mantığıyla çalışır.
| Özellik | Forge | NeoForge | Fabric |
|---|---|---|---|
| MC 26.2 sürümü | 65.1.2 (latest) / 65.1.0 (recommended) | 26.2.0.63 (kararlı) / 26.2.0.64 (en yeni) | Loader 0.19.3 / Installer 1.1.2 |
| Kurulum komutu | --installServer | --installServer | Server launcher jar |
| Sunucu jar’ı üretir mi? | Hayır (1.17+) | Hayır | Evet |
| Başlatma | run.sh / run.bat | run.sh / run.bat | -jar ile klasik |
| RAM ayarı nerede? | user_jvm_args.txt | user_jvm_args.txt | Başlatma komutunda |
| Yeni modpack ağırlığı | Eski paketler (1.12.2, 1.16.5, 1.20.1) | Modern paketlerin varsayılanı | Hafif ve performans paketleri |
Pratik kural: 1.20.2 ve sonrası modern sürümlerde büyük modpack ekosistemi NeoForge’a kaydı. Yeni kuracağınız bir 26.x modlu sunucuda varsayılan tercihiniz NeoForge olsun. Forge hâlâ aktif geliştiriliyor ama ağırlıklı olarak eski paketler için kullanılıyor. Fabric ise az modlu, performans odaklı sunucularda öne çıkıyor. Yükleyicilerin tek tek ayrıntılı kurulumu için Forge sunucu kurulumu ve Fabric sunucu kurulumu sayfalarına bakabilirsiniz.
VDS Donanımı: Modlu Sunucu Ne İster?#
Modlu sunucu, vanilla sunucudan katbekat ağırdır. Her mod kendi bloklarını, eşyalarını ve tariflerini bir kayıt defterine (registry) yazar; bu defter tamamen bellekte durur ve oyuncu sayısından bağımsızdır. Yani tek kişilik bir 300 modlu sunucu bile 16 GB isteyebilir. Aşağıdaki tablo Batihost’ta önerdiğimiz yapılandırmalardır:
| Sunucu tipi | RAM | İşlemci | Disk | Java heap |
|---|---|---|---|---|
| 20-50 mod, 2-8 oyuncu | 16 GB | Ryzen 9 7900X | 100 GB NVMe | -Xms14G -Xmx14G |
| 50-150 mod, 5-15 oyuncu | 24 GB | Ryzen 9 7900X | 150 GB NVMe | -Xms20G -Xmx20G |
| 200+ mod (ATM, Better MC tipi) | 32 GB | Ryzen 9 7950X | 200 GB NVMe | -Xms28G -Xmx28G |
İşlemci tarafında çekirdek sayısına değil saat hızına bakın. Minecraft’ın ana tick döngüsü tek çekirdekte çalışır; 32 çekirdekli düşük frekanslı bir sunucu işlemcisi, 8 çekirdekli yüksek frekanslı bir Ryzen’in yanında modlu sunucuda geride kalır. Bu yüzden yüksek frekanslı Ryzen VDS paketleri modlu sunucular için doğru tercihtir. Disk tarafında NVMe SSD şart: modlu dünyalarda chunk okuma/yazma trafiği vanilla’nın çok üzerindedir ve dönen disk anında lag üretir. RAM hesabının ayrıntılı dökümü için modlu sunucu RAM rehberine bakın.
Java 25 Kurulumu ve Doğrulaması#
Kurulumun ilk şartı doğru Java sürümüdür. Yanlış Java ile sunucu açılışta UnsupportedClassVersionError verip durur. Eşleştirme tablosu şudur:
| Minecraft sürümü | Gerekli Java | Not |
|---|---|---|
| 26.1 ve sonrası | Java 25 | Güncel hat (26.2 dahil) |
| 1.20.5 – 1.21.11 | Java 21 | Popüler modpacklerin çoğu burada |
| 1.17 – 1.20.4 | Java 17 | 1.19/1.20 dönemi paketleri |
| 1.16.5 ve öncesi | Java 8 | Eski, 1.12.2 modpackleri |
-
Eclipse Temurin JDK 25Önerilenİndir
-
Eclipse Temurin JDK 211.21.x paketleri içinİndir
-
NeoForge installer (MC 26.2)İndir
-
Minecraft Forge installerİndir
-
Fabric Server Launcherİndir
Bağlantılar resmî kaynaklara gider. Üçüncü taraf sitelerden mod yükleyici veya jar indirmeyin.
Kurulumdan sonra sürümü mutlaka doğrulayın. Hem Linux hem Windows’ta aynı komut çalışır:
java -version
# beklenen çıktı: openjdk version "25.0.4" ...
Popüler modpacklerin çoğu hâlâ 1.21.1’de olduğu için iki Java sürümünü sunucuda yan yana tutmak işinizi kolaylaştırır. Linux tarafında bu, iki paketi birlikte kurup çalıştırma anında hangi Java’yı kullanacağınızı tam yolla belirtmek demektir:
sudo apt install -y temurin-21-jdk temurin-25-jdk
/usr/lib/jvm/temurin-25-jdk-amd64/bin/java -version
Windows tarafında her iki JDK’yı da kurup start.bat dosyasında java yerine ilgili JDK’nın tam yolunu yazarak aynı sonucu alırsınız. Sürüm eşleştirmesinin ayrıntılı dökümü için hangi Java sürümü gerekir sayfasına bakabilirsiniz.
Adım Adım: VDS Üzerinde Modlu Sunucu Kurulumu#
Aşağıdaki adımlar NeoForge üzerinden anlatılıyor. Forge’da tek fark installer dosyasının adresi ve adı; komutlar birebir aynı.
-
VDS’e bağlanın ve sunucu klasörünü oluşturun#
Linux VDS’e SSH ile, Windows VDS’e Uzak Masaüstü ile bağlanın. Sunucu için ayrı bir klasör açın; modlu kurulum yüzlerce dosya üretir, dağınıklığı baştan engelleyin.
mkdir -p /opt/minecraft/modlu && cd /opt/minecraft/modluWindows tarafında aynı iş
C:\minecraft\modluklasörünü oluşturmakla biter. Linux’ta sunucuyu kök (root) kullanıcıyla çalıştırmayın; ayrı bir kullanıcı açıp klasörün sahipliğini ona verin. -
Mod yükleyici installer’ını indirin#
NeoForge ve Forge, jar dosyasını Maven deposundan sunar. Sürüm numarasını değiştirmeniz yeterlidir.
# NeoForge (Minecraft 26.2) wget https://maven.neoforged.net/releases/net/neoforged/neoforge/26.2.0.63/neoforge-26.2.0.63-installer.jar # Forge (Minecraft 26.2, recommended yapı) wget https://maven.minecraftforge.net/net/minecraftforge/forge/26.2-65.1.0/forge-26.2-65.1.0-installer.jarWindows’ta bu dosyaları tarayıcıdan indirip klasöre kopyalarsınız.
-
Installer’ı sunucu kipinde çalıştırın#
Bu adımı atlamak en sık yapılan hatadır. Installer’ı parametresiz çalıştırırsanız grafik arayüz açmaya çalışır ve ekransız bir VDS’te takılır. Mutlaka
--installSerververin.java -jar neoforge-26.2.0.63-installer.jar --installServerInstaller’ın kabul ettiği bayraklar yalnızca şunlardır:
--installServer,--extract,--offlineve--help.--install-servergibi tireli varyantlar yoktur, hata verir. İşlem birkaç dakika sürer ve yüzlerce kütüphane indirir; kesmeyin. -
Oluşan dosyaları tanıyın#
Kurulum bitince klasörünüz şuna benzer. Modern Forge/NeoForge’da çalıştırılabilir tek bir
forge-<sürüm>.jaryoktur; bunu bilmeyenler saatlerce olmayan bir jar arar.modlu/ ├── user_jvm_args.txt <-- RAM ve JVM ayarları burada ├── run.sh <-- Linux başlatma betiği ├── run.bat <-- Windows başlatma betiği ├── libraries/ <-- installer'ın indirdiği bağımlılıklar ├── mods/ <-- mod jar dosyaları buraya └── server.properties <-- ilk açılıştan sonra oluşur -
Sunucuyu ilk kez başlatın ve EULA’yı kabul edin#
İlk çalıştırma
eula.txtdosyasını oluşturur ve durur. Bu normaldir.chmod +x run.sh ./run.sh noguiArdından
eula.txtiçindekieula=falsesatırınıeula=trueyapın:sed -i 's/eula=false/eula=true/' eula.txtWindows’ta
run.batçalıştırılır veeula.txtNot Defteri ile düzenlenir. -
Modları mods klasörüne koyun#
Her mod dosyasının hem doğru Minecraft sürümü hem doğru yükleyici için olduğundan emin olun. Dosya adları genellikle bunu söyler:
lithium-neoforge-0.25.3+mc26.2.jargibi. Bir dosya adındafabricyazıyorsa NeoForge sunucusuna koymayın. -
Portu açın ve sunucuyu gerçek anlamda başlatın#
Minecraft Java Edition varsayılan portu 25565/TCP’dir. Güvenlik duvarında bu portu açmadan kimse bağlanamaz.
sudo ufw allow 25565/tcp ./run.sh noguiWindows tarafında Windows Defender Güvenlik Duvarı’nda gelen kural oluşturulur. Konsolda
Done (312.845s)! For help, type "help"satırını gördüğünüzde sunucu hazırdır. Büyük paketlerde bu satırın çıkması 10 dakikayı bulabilir.
screen veya tmux kullanın, kalıcı çözüm için de bir systemd servisi yazın. Windows tarafında NSSM ile Windows servisi yapılır. Modlu sunucular uzun açıldığı için bu adım vanilla’dan bile daha önemlidir.RAM ve JVM Ayarları: user_jvm_args.txt#
Forge ve NeoForge’da RAM ayarı başlatma komutunda değil, user_jvm_args.txt dosyasındadır. run.sh bu dosyayı @user_jvm_args.txt söz dizimiyle okur; bu yüzden sunucuyu mutlaka run.sh / run.bat ile başlatmanız gerekir. Dosyaya yalnızca JVM argümanları yazılır — tam java komutu, -jar veya dosya yolu yazılmaz.
16 GB’lık bir VDS paketi için doğru içerik şudur:
-Xms14G
-Xmx14G
-XX:+UseZGC
-XX:+UseCompactObjectHeaders
-XX:+UseStringDeduplication
-XX:MaxMetaspaceSize=1g
Buradaki üç ayrıntı önemlidir:
- Xms ve Xmx daima eşit verilir. Heap’in sürekli büyüyüp küçülmesi modlu sunucuda gereksiz duraklamalar üretir.
-XX:+ZGenerationalyazmayın. Bu bayrak Java 25’te obsolete’tir ve yalnızca uyarı basar. Doğru kullanım tek başına-XX:+UseZGC’dir.-XX:+UseCompactObjectHeaders, Java 25’te kararlı bir özelliktir ve her nesnenin başlığını 12 bayttan 8 bayta indirir. Milyonlarca küçük nesne tutan modlu sunucularda somut bellek kazancı sağlar.
Alternatif olarak G1GC ve Aikar’s Flags de 26.x sunucularında hâlâ geçerlidir. Pratik kural: 8-12 GB heap’te G1GC + Aikar’s Flags, 16 GB ve üzeri ağır modlu sunucularda ZGC. İkisini karıştırmayın — ZGC’ye geçerken tüm -XX:G1* bayraklarını silin. Fabric tarafında ise user_jvm_args.txt yoktur, argümanlar doğrudan başlatma komutuna yazılır:
java -Xms14G -Xmx14G -XX:+UseZGC -XX:+UseCompactObjectHeaders -jar fabric-server-launch.jar nogui
-Xmx artırmak işe yaramaz. Metaspace heap’in dışındadır ve sınıf metadata’sını tutar; modlu sunucularda binlerce sınıf yüklendiği için ayrı sınırlanması gerekir. Çözüm -XX:MaxMetaspaceSize=1g vermektir.mods Klasörü Mantığı: Hangi Mod Sunucuya Konur?#
Bütün modlar sunucuya konmaz. Yanlış modu sunucuya atmak boşuna RAM ve açılış süresi harcar, bazen de doğrudan hata verir. Ayrım şudur:
| Mod türü | Sunucuya | İstemciye | Örnek |
|---|---|---|---|
| İçerik modu (blok, eşya, boyut) | Evet | Evet | Create, Mekanism |
| Sunucu performans modu | Evet | Gerekmez | Lithium, FerriteCore |
| Görsel / render modu | Hayır | Evet | Sodium, shader modları |
| Minimap ve arayüz modları | Hayır | Evet | Xaero’s Minimap |
| Yönetim / koruma modu | Evet | Gerekmez | Chunky, spark |
Kural olarak: ağ kanalı kaydeden veya kayıtlı içerik (blok/eşya/tarif) ekleyen her mod iki tarafta da bulunmalıdır. Yalnızca oyuncunun ekranını değiştiren, hiçbir şey kaydetmeyen modlar sunucuya konmaz. Mod ekleme ve çıkarmanın ayrıntılı prosedürü için sunucuya sonradan mod ekleme sayfasına bakın.
Oyuncular Modlu Sunucunuza Nasıl Bağlanır?#
Modlu sunucunun vanilla sunucudan en görünür farkı burada ortaya çıkar: oyuncular normal Minecraft launcher’ıyla giremez. Herkesin bilgisayarında sunucudakiyle birebir aynı mod listesi ve aynı sürümler bulunmalıdır. “Aynı mod ama farklı yapı” bile bağlantıyı reddettirir.
Oyuncu tarafında yapılacaklar sırayla şunlardır: sunucunun kullandığı modpack adını ve sürümünü öğrenmek, CurseForge veya Modrinth uygulamasından tam olarak o sürümü kurmak, uygulamadaki oyna düğmesiyle oyunu açmak (normal Minecraft launcher’ından değil), ardından Çok Oyunculu ekranından Sunucu Ekle diyerek IP adresini yazmak. Yalnızca modpack adının aynı olması yetmez; “Better MC v12” ile “Better MC v12 HF” farklı paketlerdir ve birbirine bağlanamaz. Bu akışın ekran ekran anlatımı modlu sunucuya arkadaş bağlama sayfasındadır.
Sürüm tutmadığında oyuncunun göreceği tipik uyarılar şunlardır: sunucu listesinde kırmızı çarpı ve üzerine gelince çıkan “Incompatible FML modded server” ipucu, bağlanmaya çalışınca açılan “Your client is missing the following mods…” ekranı, ya da eski sürümlerde “Connection closed - mismatched mod channel list” mesajı. Hepsinin tek çözümü aynıdır: iki tarafın mod listesini eşitlemek.
NeoForge’un yeni ağ protokolünde bir kolaylık var: sunucu artık oyuncunun tam mod listesini karşılaştırmıyor, yalnızca kayıtlı ağ kanallarına ve registry içeriğine bakıyor. Pratik sonucu şudur — 26.x NeoForge sunucularında oyuncular minimap, shader veya FPS modu gibi tamamen istemci tarafı eklentileri kendi tarafına kurabilir, sunucu buna karışmaz. Fabric tarafında ise durum daha da esnektir; mod uyuşmazlığı bağlantı anında değil, oyun açılırken çözümleme aşamasında ortaya çıkar ve Fabric size hangi modu hangi sürüme çekmeniz gerektiğini açıkça yazar.
İlk Açılışta En Sık Karşılaşılan Hatalar#
| Belirti | Neden | Çözüm |
|---|---|---|
UnsupportedClassVersionError | Yanlış Java sürümü | 26.x için Java 25, 1.21.x için Java 21 kurun |
Could not find or load main class @user_jvm_args.txt | Sunucu run.sh yerine -jar ile başlatılmış | run.sh / run.bat kullanın |
| Installer takılıyor, hiçbir şey olmuyor | --installServer verilmemiş, GUI açılmaya çalışıyor | Bayrağı ekleyip tekrar çalıştırın |
Missing or unsupported mandatory dependencies | Bir mod başka bir modu istiyor, o eksik | Log satırındaki “Requested by” alanına bakıp eksik modu ekleyin |
| Sunucu açılıyor ama oyuncular giremiyor | Mod listesi uyuşmazlığı veya kapalı port | Mod listelerini eşitleyin, 25565/TCP’yi açın |
Mixin ... FAILED during APPLY | Mod o Minecraft sürümü için derlenmemiş | Modun doğru sürümünü indirin |
Teşhisin doğru yeri logs/latest.log dosyasıdır; çökme olduysa crash-reports/ klasörüne de bakın. Hataların ayrıntılı çözümleri modlu sunucu hataları sayfasında toplanmıştır.
Modlu Sunucuyu Hızlandırmanın Kısa Yolu#
Kurulum bittikten sonra üç şey yaparsanız TPS’iniz belirgin şekilde düzelir. Birincisi performans modları: Lithium genel oyun mantığını, FerriteCore bellek kullanımını, ServerCore dinamik yükü iyileştirir. FerriteCore tek başına büyük paketlerde bellek kullanımını ciddi biçimde düşürür ve “RAM yetmiyor” şikayetinin ilk çözümü olmalıdır.
İkincisi görüş mesafesi. server.properties içindeki view-distance kare olarak büyür: değer 16 iken oyuncu başına 1089 chunk yüklenir, 10 iken 441. Yani 16’dan 10’a düşürmek yüklü chunk sayısını 2,5 kat azaltır. Modlu sunucuda 8-10 arası makul bir başlangıçtır.
view-distance=10
simulation-distance=8
max-tick-time=60000
Üçüncüsü ön chunk üretimi (pregeneration). Chunky gibi bir modla dünyayı önceden ürettirirseniz oyuncular yeni alanlara girerken yaşanan takılmalar ortadan kalkar. Ayrıntılar için modlu sunucu optimizasyonu sayfasına bakın. Komut satırıyla uğraşmak istemiyorsanız web panel üzerinden modlu sunucu kurma yolunu tercih edebilir, hazır yapılandırılmış bir modlu Minecraft sunucusu paketiyle doğrudan oyuna başlayabilirsiniz.
Özetle#
Modlu Minecraft sunucusu kurmanın omurgası dört adımdır: sürüme uygun Java’yı kurun, modlarınızın istediği yükleyiciyi (çoğunlukla NeoForge) --installServer ile kurun, RAM’i user_jvm_args.txt içinde ayarlayın ve modları mods klasörüne koyup portu açın. Donanım tarafında modlu sunucu için taban 16 GB RAM, yüksek frekanslı Ryzen işlemci ve NVMe diskten aşağı inmeyin.
Hazır bir modpack kuracaksanız bir sonraki durağınız CurseForge modpack sunucusu kurulumu olsun; oradaki server pack yöntemi, modları tek tek toplama işini tamamen ortadan kaldırır. Kurulum sırasında takılırsanız destek talebi açarak Batihost ekibinden yardım alabilirsiniz.