Forge ile Modlu Minecraft Sunucu Kurulumu

Forge sunucu kurulumu, Minecraft’a mod eklemek isteyen herkesin öğrenmesi gereken ilk iştir: Forge, sunucunuza blok, eşya, makine, boyut ve canlı ekleyen modları yükleyebilmenizi sağlayan mod yükleyicisidir ve Minecraft 26.2 için güncel dalı 65.x’tir (65.1.1 latest, 65.1.0 recommended). Paper veya Purpur ile eklenti kurmaya alışkınsanız burada mantığın değiştiğini baştan bilin: Forge eklenti değil mod çalıştırır ve modların büyük bölümü hem sunucuda hem oyuncunun bilgisayarında aynı sürümle bulunmak zorundadır.

Bu rehberde Forge ile NeoForge arasındaki farkı, doğru sürüm ve Java eşleşmesini, installer’ın nasıl çalıştığını, mods klasörünün mantığını ve modlu sunucularda en sık karşılaşılan hataları ele alıyoruz. Anlatılanlar Windows ve Linux için ortaktır; işletim sistemine özgü adımlarda ilgili sayfaya yönlendiriyoruz.

Forge Nedir ve Ne Zaman Gerekir?#

Vanilla Minecraft sunucusu mod yükleyemez. Mojang’ın server.jar dosyası yalnızca oyunun kendisini çalıştırır. Modlar oyunun iç sınıflarına müdahale ettiği için araya bir katman gerekir; işte Forge bu katmandır. Sunucu açılırken önce Forge yüklenir, mods klasöründeki jar dosyalarını okur, bağımlılıkları çözer ve modların oyun koduna kancalarını takmasına izin verir.

Forge’a şu durumlarda ihtiyacınız var:

• Teknik modpack kurmak istiyorsunuz (makine, otomasyon, enerji sistemleri).
• Oyuna yeni boyut, biyom, canlı veya eşya ekleyen modlar çalıştıracaksınız.
• Hazır bir modpack sunucu paketi indirdiniz ve içinden Forge çıktı.

Şu durumlarda Forge’a ihtiyacınız yok: survival, skyblock, minigame veya PvP sunucusu kuruyorsanız ve yalnızca yetki, ekonomi, bölge koruma gibi işlevler istiyorsanız. Bunlar eklenti işidir ve Paper ya da Purpur ile çözülür. Ayrımı netleştirmek isterseniz sunucu yazılımları karşılaştırması sayfasına bakın.

Forge mu NeoForge mu?#

2023’te Forge geliştiricilerinin bir bölümü ayrılıp NeoForge’u kurdu. İki proje bugün paralel ilerliyor ve ikisi de Minecraft 26.2’yi destekliyor. Aralarında seçim yaparken kişisel tercihinize değil, kuracağınız modların hangisini istediğine bakmalısınız. Bir mod yalnızca NeoForge için yayınlanmışsa Forge sunucusunda çalışmaz, tersi de geçerlidir.

Pratik kural: hazır bir modpack kuruyorsanız paketin belirttiği yükleyiciyi kullanın, tartışmayın. Kendi mod listenizi hazırlıyorsanız listedeki modların çoğunluğu hangi yükleyiciyi hedefliyorsa onu seçin. Kurulum adımları iki projede de neredeyse birebir aynıdır, bu rehberdeki komutlar NeoForge için de geçerlidir.

Forge Sürüm Numaraları ve Java Eşleşmesi#

Forge sürüm numarası iki parçadan oluşur: 26.2-65.1.0 ifadesindeki 26.2 Minecraft sürümü, 65.1.0 ise Forge’un kendi sürümüdür. Forge, Minecraft’ın 2026’da geçtiği yeni numaralandırmayı kendi tarafında uygulamadı; eski biçimini koruyor.

Her Minecraft sürümü için Forge iki kanal sunar. Recommended daha uzun süre test edilmiş, kararlı yapıdır; Latest en yeni ama daha az denenmiş yapıdır. Oyuncuların bulunduğu bir sunucuda Recommended kanalını tercih edin.

Sürüm-Java eşleşmesinin tamamı ve dağıtım önerileri için hangi Java sürümü gerekir rehberini kullanın. Sunucuda birden fazla Java sürümü kuruluysa hangisinin varsayılan olduğunu mutlaka kontrol edin; modlu sunucularda en çok zaman kaybettiren sorun budur.

Modlu Sunucu İçin Donanım Planı#

Modlar sunucuya iki türlü yük bindirir: bellek ve tek çekirdek işlem gücü. Yüzlerce yeni blok tipi, eşya kaydı ve tarif (recipe) yalnızca kayıt aşamasında bile gigabaytlarca bellek tüketir. Bu yüzden modlu sunucularda eklentili sunuculara göre çok daha yüksek RAM gerekir.

İşlemci seçiminde çekirdek sayısına değil saat hızına bakın: Minecraft’ın ana tick döngüsü tek çekirdekte çalışır, modlar da bu döngünün içinde çalışır. Düşük frekanslı çok çekirdekli bir sunucu işlemcisi modlu sunucuda hayal kırıklığı yaratır. Disk tarafında NVMe SSD zorunludur; modlu dünyalarda chunk okuma/yazma trafiği vanilla’nın kat kat üzerindedir.

Hazır kurulu modlu Minecraft sunucu paketleri veya kendi kurulumunuzu yapacaksanız yüksek frekanslı High CPU VDS paketleri bu profillere karşılık gelir. Oyuncu sayısına göre bellek planını RAM gereksinim tablosundan kontrol edebilirsiniz.

İndirmeniz Gerekenler#

Forge Sunucusu Kurulumu Adım Adım#

1. Doğru Java sürümünü kurun#

   Minecraft 26.2 tabanlı Forge için Java 25 gerekir. Kurulumdan sonra doğrulayın:

   java -version

   Çıktı 25. ile başlamıyorsa sistemde başka bir Java varsayılan durumdadır. Sunucuyu başlatan betikte Java’nın tam yolunu vermek en güvenilir çözümdür.

2. Boş bir sunucu klasörü oluşturun ve installer’ı indirin#

   Forge installer, çalıştırıldığı klasörün içine onlarca dosya ve libraries ağacı açar. Bu yüzden mutlaka boş bir klasör kullanın. Forge indirme sayfasında iki düğme görürsünüz: Installer ve Installer (Windows). Sunucu için evrensel .jar installer’ı indirin.

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

   Bu adım Forge kurulumunun kalbidir. Installer’ı çift tıklayarak değil, --installServer parametresiyle komut satırından çalıştırın:

   java -jar forge-26.2-65.1.0-installer.jar --installServer

   Installer, Mojang ve Forge sunucularından gerekli kütüphaneleri indirir. İnternet hızınıza göre bir-iki dakika sürebilir. İşlem bittiğinde konsolda The server installed successfully satırını görmelisiniz.

4. Oluşan dosyaları tanıyın#

   Kurulum sonunda klasörde şunlar bulunur:

   libraries/

   Forge ve Minecraft kütüphaneleri. Silmeyin, taşımayın.

   user_jvm_args.txt

   RAM ve JVM bayraklarını yazacağınız dosya.

   run.sh / run.bat

   Sunucuyu başlatan betikler. Sunucu bunlarla açılır.

   installer.log.txt

   Kurulum günlüğü. Sorun çıkarsa buraya bakılır.

   Tek parça bir server.jar ya da forge-server.jar aramayın; Minecraft 1.17’den beri Forge böyle bir dosya üretmiyor.

5. RAM ayarını user_jvm_args.txt içine yazın#

   Dosyayı açın, içindeki açıklama satırlarının altına heap değerlerini ekleyin. 16 GB’lık bir sunucu için:

   -Xms14G
   -Xmx14G

   Her bayrak ayrı satırda olmalıdır. -Xms ve -Xmx değerlerini daima eşit verin; modlu sunucuda heap’in sürekli büyüyüp küçülmesi belirgin takılmalara yol açar.

6. İlk çalıştırma ve EULA#

   Linux’ta betiği çalıştırılabilir yapıp başlatın, Windows’ta run.bat dosyasını çalıştırın:

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

   Sunucu ilk açılışta eula.txt oluşturup kapanır. Dosyayı açıp satırı eula=true yapın ve betiği tekrar çalıştırın. Bu kez Forge tüm modları tarar, dünyayı üretir ve konsola Done satırını basar.

7. Sunucuyu kalıcı çalışır hale getirin#

   Terminal veya uzak masaüstü oturumu kapandığında sunucunun kapanmaması için arka plan çalıştırma yöntemi kurun. İşletim sistemine özgü adımlar Windows’ta Forge kurulumu ve Ubuntu’da Forge kurulumu sayfalarında; port açma, otomatik başlatma ve servis tanımlama orada anlatılıyor.

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

Sunucu bir kez başarıyla açıldıktan sonra klasörde mods dizini oluşur. Mod jar dosyalarını doğrudan buraya kopyalarsınız, alt klasör açmazsınız. Her mod ekleme veya çıkarma işleminden sonra sunucuyu tamamen yeniden başlatmanız gerekir; Forge çalışırken mod yüklenemez.

Modların üç türü#

Her iki tarafta gerekli

Blok, eşya, boyut, canlı ekleyen modlar. Sunucuda ve oyuncunun istemcisinde aynı sürümle bulunmalıdır.

Yalnızca sunucu tarafı

Performans, koruma, yönetim ve yedekleme modları. İstemciye kurulmaz.

Yalnızca istemci tarafı

Mini harita, arayüz geliştirmeleri, shader destek modları. Sunucuya atılmaz, atılırsa ya yok sayılır ya da açılışta hata verir.

Sürüm eşleşmesi mutlaktır. Sunucuda bir modun 1.4.2 sürümü, oyuncuda 1.4.1 sürümü varsa bağlantı reddedilir ve oyuncu mod uyuşmazlığı ekranı görür. Bu yüzden oyunculara tek tek mod listesi vermek yerine hazır bir istemci paketi dağıtmak en pratik yöntemdir. Mod yükleme mantığının istemci tarafı için mod kurulumu rehberine bakabilirsiniz.

Bağımlılıkları atlamayın#

Modların çoğu kütüphane modlarına bağımlıdır. Bağımlılık eksikse Forge açılışta durur ve konsola şuna benzer bir satır basar:

Missing or unsupported mandatory dependencies:
    Mod ID: 'examplelib', Requested by: 'examplemod', Expected range: '[2.1,)', Actual version: '[MISSING]'

Bu mesaj tam olarak neyin eksik olduğunu ve hangi sürüm aralığının gerektiğini söyler. Eksik kütüphaneyi indirip mods klasörüne ekleyin.

26.1 Unobfuscation: Eski Modlar Neden Çalışmıyor?#

Minecraft 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. Oyuncular için görünmez bir değişiklik, mod ekosistemi içinse bir ABI kırılması: derlenmiş her mod, karşısında bulacağını sandığı isimlerin değiştiğini görüyor.

Sonuç net: 1.21.11 ve öncesi için derlenmiş hiçbir mod, yeniden derlenmeden 26.1 veya 26.2 üzerinde çalışmaz. Bu bir yapılandırma sorunu değildir, hiçbir ayarla aşılamaz. Yapılabilecek tek şey mod geliştiricisinin 26.x için yeni sürüm yayınlamasını beklemektir.

Aynı sebeple "26.2 modpack" arıyorsanız beklentinizi ayarlayın: büyük paketlerin çoğu hâlâ 1.20.1 veya 1.21.x tabanlıdır ve bu tamamen normaldir. Güncel paket listesi ve RAM ihtiyaçları için en iyi Minecraft modpackleri sayfasına bakın.

JVM Bayrakları ve Modlu Sunucu Performansı#

Modlu sunucularda çöp toplayıcı seçimi eklentili sunuculardan daha önemlidir çünkü heap çok daha büyüktür. Önce yaygın bir yanlışı düzeltelim: Minecraft 26.1 ile duyurulan "G1GC yerine ZGC" değişikliği istemci tarafını ilgilendirir, Minecraft Launcher’ın oyun JVM’i için geçerlidir. Sunucunun çöp toplayıcısını tamamen sizin verdiğiniz bayraklar belirler ve Java 25’te G1 hâlâ JVM’in varsayılanıdır.

16 GB heap kullanan bir modpack sunucusunda G1GC ile şu ayarlar iyi bir başlangıçtır. user_jvm_args.txt dosyasına her bayrağı ayrı satıra yazın:

-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:InitiatingHeapOccupancyPercent=20
-XX:G1MixedGCLiveThresholdPercent=90
-XX:SurvivorRatio=32
-XX:+PerfDisableSharedMem
-XX:MaxTenuringThreshold=1

Heap 16 GB’ın üzerine çıkıyorsa (24-32 GB’lık ağır paketler) ZGC’yi değerlendirebilirsiniz. Büyük heap’lerde duraklama sürelerini belirgin biçimde kısaltır:

-Xms28G
-Xmx28G
-XX:+UseZGC
-XX:+AlwaysPreTouch

Heap seçimi, Xms/Xmx eşitliği ve GC karşılaştırmaları için RAM ayarları ve JVM flag’leri sayfasına bakın. Sunucu düşük TPS veriyorsa spark’ın Forge yapısını mods klasörüne atıp /spark profiler start komutuyla hangi modun yük yarattığını ölçebilirsiniz.

Modpack Sunucusu Kurmak#

Modları tek tek toplamak yalnızca kendi paketinizi hazırlıyorsanız gereklidir. Popüler modpacklerin neredeyse tamamı hazır bir server pack yayınlar. Bu paketin içinde doğru Forge sürümü, tam mod listesi ve test edilmiş yapılandırma dosyaları hazır gelir.

1. Server pack’i indirin ve açın#

   Modpack’in CurseForge veya Modrinth sayfasındaki "Server Pack" dosyasını indirin. Sunucudaki boş klasöre açın. Paketin içinde genellikle bir kurulum betiği bulunur.

2. Forge sürümünü doğrulayın#

   Paketin kullandığı Minecraft ve Forge sürümlerini not edin. Bazı paketler Forge’u kendisi kurar, bazıları sizden kurmanızı ister. Elle kuracaksanız paketin belirttiği sürümü indirin, "en yenisini" değil.

3. RAM değerini pakete göre ayarlayın#

   Modpack sayfası genellikle önerilen bellek miktarını yazar. Bu değeri user_jvm_args.txt dosyasına girin. Önerilen değerin altına inmeyin; büyük paketlerde bellek yetersizliği açılışta değil, oyun sırasında rastgele çökmeler olarak ortaya çıkar.

4. Oyunculara aynı istemci paketini dağıtın#

   Sunucu ile istemcinin mod listesi ve sürümleri birebir aynı olmalıdır. Oyunculara modpack’in istemci sürümünü CurseForge veya Modrinth uygulamasından kurmalarını söyleyin.

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

Installer jar’ını doğrudan çalıştırmak#

En yaygın hata. java -jar forge-...-installer.jar nogui komutu sunucuyu başlatmaz; installer’ı grafik arayüz modunda açmaya çalışır ve başsız (headless) bir sunucuda hata verir. Sunucu run.sh veya run.bat ile başlatılır.

Yanlış Java sürümü#

Konsolda UnsupportedClassVersionError görüyorsanız Java sürümü ile Minecraft sürümü uyuşmuyordur. 26.x için Java 25, 1.12.2 için Java 8 gerekir. Sistemde birden çok Java varsa betikte tam yol kullanın.

Bellek yetersizliği#

java.lang.OutOfMemoryError: Java heap space hatası heap’in dolduğunu gösterir. Çözümü rastgele heap büyütmek değil, önce hangi modun bellek tükettiğini bulmaktır; ayrıntılı yöntem Out of Memory hatası çözümü sayfasında.

Çökme raporunu okumamak#

Forge çöktüğünde crash-reports klasörüne ayrıntılı bir rapor yazar. Raporun başındaki Description satırı ve Suspected Mods bölümü genellikle sorunu doğrudan söyler. Rapor okuma yöntemini crash report nasıl okunur sayfasında anlattık.

Mod ve yükleyici karıştırmak#

Fabric modunu Forge sunucusuna atmak sessizce yok sayılmaya ya da açılışta hataya yol açar. Mod indirirken dosya adındaki veya indirme sayfasındaki forge / neoforge / fabric etiketine dikkat edin.

Özetle#

Forge kurulumu üç şeye dikkat ettiğinizde sorunsuz ilerler: doğru Java sürümü, installer’ın --installServer parametresiyle çalıştırılması ve mod sürümlerinin sunucu ile istemcide birebir eşleşmesi. Minecraft 26.2 için 65.1.0 (recommended) yapısı ve Java 25 doğru kombinasyondur; eski modpackler için Forge’un o sürüme ait dalını ve uygun Java’yı kullanın.

26.1 ile gelen unobfuscation nedeniyle eski modların 26.x üzerinde çalışmadığını unutmayın — bu bir ayar sorunu değil, mod geliştiricisinin yeniden derlemesini gerektiren bir uyumluluk kırılmasıdır. Donanımda modlu sunucunun alt sınırı 16 GB RAM, yüksek saat hızlı Ryzen 9 işlemci ve NVMe SSD’dir; büyük paketlerde 24-32 GB’a çıkın. Kurulumda takılırsanız destek talebi açarak Batihost ekibinden yardım alabilirsiniz.