NeoForge ile Modlu Minecraft Sunucu Kurulumu

NeoForge sunucu kurulumu pratikte tek komuta iner: installer’ı indirip --installServer bayrağıyla çalıştırırsınız, gerisini installer halleder. Minecraft 26.2 “Chaos Cubed” için güncel kararlı yapı NeoForge 26.2.0.63, zorunlu Java sürümü ise Java 25. Kurulumdan sonra klasörde run.sh, run.bat, user_jvm_args.txt ve libraries oluşur; çalıştırılabilir tek bir “forge jar” aramayın, 1.17’den beri öyle bir dosya yok.

İşin zor kısmı kurulum değil. Modlu sunucu işletenlerin destek taleplerinde en sık gördüğümüz şey, sunucunun sorunsuz açılıp oyuncuların bağlanamaması: mod listesi iki tarafta birebir tutmadığı anda NeoForge bağlantıyı reddediyor. Bu yüzden aşağıda kurulum kadar mod eşleşmesi tarafına da yer ayırdık.

Sayfa işletim sisteminden bağımsız yazılmıştır. Ekran adımları, klasör yolları ve servis ayarları için Windows’ta Minecraft sunucu kurulumu veya Linux üzerinde sunucu kurulumu sayfalarına geçin.

NeoForge Nedir, Forge’dan Neden Ayrıldı?#

NeoForge, Minecraft Forge’un 2023 yazında, 1.20.1 döneminde çatallanmasıyla ortaya çıktı. Forge’a uzun süre emek vermiş geliştiricilerin bir bölümü projeden ayrıldı ve iki gerekçeyle yeni bir yükleyici başlattı: yıllar içinde ağırlaşmış kod tabanını modernleştirmek ve kararların tek kişiye değil topluluk yönetimine bağlı olduğu bir yapı kurmak.

Ayrılma kullanıcı tarafında bir kırılma yaratmadı, çünkü NeoForge miras aldığı yapıyı korudu: aynı installer altyapısı, aynı mods klasörü, aynı mantıkla çalışan mod API’si. Bir Forge sunucusu kurmayı bilen kişi NeoForge’u da bilir. Zaman geçtikçe iki proje kod tarafında birbirinden uzaklaştı ama kurulum akışı hala neredeyse aynı.

2026 tablosu şöyle: 1.20.2 sonrası modern sürümlerde büyük modpack ekosistemi ağırlıklı olarak NeoForge’a kaydı ve yeni kurulan 26.x modlu sunucularda varsayılan tercih NeoForge oldu. Forge hâlâ aktif geliştiriliyor (26.2 hattında Recommended yapı 65.1.0) ancak daha çok eski paketlerde karşınıza çıkıyor: 1.12.2, 1.16.5, 1.19.2 ve 1.20.1 paketlerinin büyük kısmı Forge tarafında.

Yükleyici seçimini modpack belirler, tercih değil. Paket hangisi için yayınlandıysa onu kurarsınız.

İki projenin felsefe ve API farklarını ayrıntılı karşılaştıran Forge ve NeoForge arasındaki farklar sayfası bu kararı verirken işinizi kolaylaştırır. Klasik Forge kurulumu için Forge modlu sunucu kurulumu, hafif ve hızlı bir alternatif arıyorsanız Fabric sunucu kurulumu sayfalarına bakabilirsiniz.

Kurulumda gerçekten değişen üç şey#

Kurulum adımları aynı olduğu için “NeoForge nasıl kurulur” sorusunun cevabı da kısa. Gerçek farklar üç yerde toplanıyor: indirme adresindeki maven yolu ve dosya adı, kurulum sonrası oluşan argüman dosyasının bulunduğu klasör ve sürüm numaralandırma şeması. Geri kalan her şey — installer bayrağı, klasör düzeni, mod yükleme mantığı — ortak.

NeoForge Sunucusu İçin Gereksinimler#

Java 25 zorunluluğu#

Minecraft 26.1 ile birlikte minimum gereksinim Java 25’e çıktı ve 26.2’de aynen sürüyor. NeoForge’un resmî duyurusu da net: 26.1 ve sonrası Java 25 ister. Kuruluma başlamadan önce sürümü doğrulayın.

java -version
# beklenen çıktı:
# openjdk version "25.0.4" 2026-...

Çıktıda 21 ya da 17 görüyorsanız sistemde eski bir JDK varsayılan durumdadır. Bu durumda ya varsayılanı değiştirin ya da başlatma betiğinde JDK 25’in tam yolunu yazın. Sürüm eşleşme tablosunun tamamı hangi Java sürümü gerekir sayfasında.

Donanım ve RAM planı#

Modlu sunucuda RAM ihtiyacı oyuncu sayısından çok mod sayısına bağlıdır. Her mod kendi sınıflarını, tariflerini ve kayıtlarını belleğe yükler; 40 oyuncu taşıyan sade bir Paper sunucusu, 8 oyunculu ağır bir modpack’ten daha az bellek harcayabilir.

İşlemcide belirleyici olan çekirdek sayısı değil saat hızıdır: Minecraft’ın ana tick döngüsü tek çekirdekte döner ve modlar bu döngüye ek iş yükler. Disk tarafında NVMe SSD şart, çünkü modlu dünyalarda chunk okuma/yazma trafiği vanilla’nın kat kat üzerindedir. Rakamların gerekçesini modlu sunucu için kaç GB RAM gerekir sayfasında ayrıntılandırdık; hazır bir altyapı arıyorsanız Ryzen tabanlı modlu Minecraft sunucu paketlerimize göz atabilirsiniz.

İndirmeniz Gerekenler#

NeoForge 26.2 Sunucusunu Adım Adım Kurma#

1. Sunucuya ait boş bir klasör açın#

   Installer bulunduğu dizine kurulum yapar, yani klasörü kirli bırakmayın. Windows’ta C:\minecraft\neoforge-26.2, Linux’ta /opt/minecraft/neoforge-26.2 gibi ayrı bir yol kullanın.

2. Installer’ı indirin#

   Dosya adı neoforge-<sürüm>-installer.jar biçimindedir. Resmî maven deposundan doğrudan da çekebilirsiniz:

   wget https://maven.neoforged.net/releases/net/neoforged/neoforge/26.2.0.63/neoforge-26.2.0.63-installer.jar

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

   Tek gerekli bayrak --installServer. Installer kütüphaneleri kendisi indirir; internet bağlantısı gerekir.

   java -jar neoforge-26.2.0.63-installer.jar --installServer

   Installer yalnızca dört bayrak kabul eder: --installServer, --extract, --offline ve -h/--help. Hiçbir bayrak verilmezse grafik arayüz açmayı dener; ekranı olmayan bir sunucuda tam olarak burada takılırsınız.

4. Sunucuyu bir kez başlatıp EULA’yı kabul edin#

   İlk çalıştırmada eula.txt üretilir ve sunucu kapanır. Dosyadaki satırı değiştirip kaydedin:

   eula=true

5. RAM’i user_jvm_args.txt içinden verin#

   Bu dosyaya yalnızca JVM argümanları yazılır; tam java komutu, -jar veya dosya yolu yazılmaz. 16 GB’lık bir paket için:

   # user_jvm_args.txt
   -Xms14G
   -Xmx14G

6. run betiğiyle başlatın#

   Sunucu mutlaka run betiğiyle açılmalıdır; betik user_jvm_args.txt dosyasını @dosya sözdizimiyle okur. Linux tarafında önce çalıştırma izni verin:

   chmod +x run.sh
   ./run.sh nogui

   Windows tarafında karşılığı run.bat dosyasıdır. Konsolda Done satırını gördüğünüzde sunucu 25565/TCP portunu dinlemeye başlamıştır.

Kurulumdan Sonra Oluşan Dosyalar#

Installer bittiğinde klasörünüz aşağıdaki gibi görünür. eula.txt, server.properties ve mods ilk çalıştırmadan sonra tamamlanır:

sunucu-klasoru/
├── user_jvm_args.txt      <- RAM ve JVM bayrakları burada
├── run.sh                 <- Linux / macOS başlatma betiği
├── run.bat                <- Windows başlatma betiği
├── libraries/             <- tüm bağımlılıklar ve argüman dosyaları
├── eula.txt               <- eula=true yapılacak
├── server.properties
├── mods/                  <- mod .jar dosyaları buraya
├── config/                <- mod ayar dosyaları
├── logs/
└── world/

Run betiklerinin içeriği tek satırdır ve iki argüman dosyasını birleştirir: sizin düzenlediğiniz user_jvm_args.txt ile installer’ın ürettiği sürüme özel dosya. Linux’ta bu ikinci dosya unix_args.txt, Windows’ta win_args.txt adını taşır.

# run.sh içeriği (NeoForge, tipik hâli)
java @user_jvm_args.txt @libraries/net/neoforged/neoforge/26.2.0.63/unix_args.txt "$@"

mods Klasörü ve İstemci–Sunucu Mod Eşleşmesi#

Mod kurulumu basittir: .jar dosyalarını mods klasörüne atar, sunucuyu yeniden başlatırsınız. Karmaşık olan kısım, aynı listenin oyuncularda da bulunması gerektiğidir.

Bir oyuncu bağlandığında NeoForge, istemci ile sunucunun kayıtlı ağ kanallarını ve mod listesini karşılaştırır. Ortak oyunu etkileyen bir mod bir tarafta eksikse, fazlaysa veya sürümü farklıysa bağlantı reddedilir ve “Mismatched Mod Channel List” hatası verilir. Eşleşme tam olmalıdır; aynı mod ama farklı yapı da hata sayılır.

Yalnızca istemcide çalışan modlar bu kuralın dışındadır ve sunucuya konmaz. Tipik örnekler:

• Minimap modları (Xaero’s Minimap, JourneyMap’in istemci kısmı)
• Render ve FPS modları (Sodium/Embeddium, OptiFine benzeri araçlar)
• Shader yükleyicileri ve görsel arayüz eklentileri

Bunları sunucuya atmak en iyi ihtimalle boşuna RAM ve açılış süresi harcar, kötü ihtimalle sunucuyu açılışta çökertir. Mod dosyalarını iki tarafa dağıtırken izlenecek yol mod kurulumu: istemci ve sunucu tarafı sayfasında anlatılıyor. Hazır bir paketle çalışıyorsanız kural tek cümle: istemci arşivini değil, paketin “server pack” arşivini indirin. İstemci arşivini sunucuya kopyalamak, modlu sunucu kurulumlarında en sık yapılan hatadır ve içindeki görsel modlar sunucuyu daha ilk açılışta çökertir.

RAM Planı ve JVM Bayrakları#

NeoForge’da bayrakların tamamı user_jvm_args.txt içine, her biri ayrı satıra yazılır. Dosya # ile başlayan yorum satırlarını kabul eder. 16 GB’lık bir pakette Aikar’s Flags temelli tam içerik şöyle görünür:

# user_jvm_args.txt - 16 GB paket
-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

Birkaç kural: -Xms ile -Xmx daima eşit verilir, fiziksel RAM’in tamamı heap’e ayrılmaz (işletim sistemi ve heap dışı bellek için 2 GB civarı pay bırakın) ve yukarıdaki değerler 12 GB üzeri heap içindir — 8 GB heap kullanıyorsanız G1NewSizePercent=30, G1MaxNewSizePercent=40 ve G1HeapRegionSize=8M yapın.

Çöp toplayıcı tarafında yaygın bir yanlış anlama var: 26.1 sürüm notlarındaki “G1GC yerine ZGC” değişikliği Minecraft Launcher’ın istemci JVM varsayılanıdır, sunucuyu ilgilendirmez. Sunucu jar’ının launcher’ı yoktur; çöp toplayıcıyı tamamen sizin verdiğiniz bayraklar belirler. Java 25’te G1 hâlâ JVM’in genel varsayılanıdır. 16 GB ve üzeri heap kullanan ağır modpacklerde -XX:+UseZGC denenebilir, ancak -XX:+ZGenerational bayrağını yazmayın; Java 25’te geçersizdir ve yalnızca uyarı basar. Doğru kullanım tek bayraktır: -XX:+UseZGC.

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

Bu tablodaki hataların ortak yanı şu: neredeyse hepsi tek bir modun ya da tek bir satırın sonucudur. Bu yüzden mod eklerken hepsini birden atmayın; üçer beşer ekleyip sunucuyu yeniden başlatın, konsolu okuyun. Toplu ekleme yaptığınızda hata çıktığında suçluyu bulmak yarım günü yiyebiliyor. Konsolda yalnızca son satıra değil, ilk hata satırına bakın — asıl neden çoğu zaman en üstte yazar.

Çökme sonrası oluşan rapor dosyasını okumayı öğrenmek, modlu sunucu işletirken en çok işinize yarayacak beceridir. Hata metinlerinin ne anlama geldiğini modlu sunucu hataları ve çözümleri sayfasında topladık.

Özetle#

NeoForge kurulumu üç şeye bakar: doğru Java, doğru installer ve doğru başlatma yöntemi. Java 25 kurun, 26.2 için neoforge-26.2.0.63-installer.jar dosyasını --installServer bayrağıyla çalıştırın, eula.txt içindeki değeri true yapın, RAM’i user_jvm_args.txt dosyasından verin ve sunucuyu run betiğiyle açın. Modlu bir sunucuda 16 GB RAM ve -Xms14G -Xmx14G makul bir başlangıçtır; büyük paketlerde 24-32 GB’a çıkın.

Sunucu açıldıktan sonra işin ikinci yarısı başlıyor: mod listesini oyuncularla birebir eşitlemek, 26.2 için derlenmemiş modları listeden çıkarmak ve mod eklerken herşeyin yedeğini önceden almak. Sıfırdan bir modlu sunucu kuruyorsanız VDS üzerinde modlu sunucu kurma rehberi tüm akışı baştan sona anlatıyor. Takıldığınız bir nokta olursa destek talebi açarak sistem ekibimize yazabilirsiniz.