Minecraft Mod Kurulumu: İstemci ve Sunucu Tarafı

Minecraft mod kurulumu iki ayrı tarafta yapılır: oyunu oynadığınız istemcide ve herkesin bağlandığı sunucuda. Her iki tarafta da mantık aynıdır — önce bir mod yükleyicisi (Forge, NeoForge veya Fabric) kurulur, sonra indirdiğiniz .jar dosyaları o yükleyicinin oluşturduğu mods klasörüne kopyalanır. İşin püf noktası dosyaları taşımak değil, sürümleri birbirine oturtmaktır.

Bu rehberde mod ile eklenti farkını, doğru yükleyiciyi seçmeyi, istemci ve sunucu tarafındaki kurulum adımlarını, hangi modun nereye atılacağını, modlu sunucunun donanım ihtiyacını ve mod çakışmalarını nasıl çözeceğinizi bulacaksınız. Anlatım Minecraft 26.2 “Chaos Cubed” esas alınarak yazıldı ve işletim sisteminden bağımsızdır.

Mod, Plugin ve Datapack Arasındaki Fark#

Üçü de sunucuyu değiştirir ama teknik olarak bambaşka şeylerdir. Yanlış olanı indirmek en sık yapılan başlangıç hatasıdır.

Modlar oyunun kodunu doğrudan değiştirir, bu yüzden istemcinin de aynı modları tanıması gerekir. Pluginler yalnızca sunucu tarafında çalışır ve vanilla istemciyle uyumludur; kurulumunu plugin kurulumu rehberinde anlattık. Datapackler ise oyunun kendi veri sistemini kullanır, hiçbir ek yazılım istemez — datapack kurulumu sayfasına bakabilirsiniz.

Mod Yükleyicisini Seçin: Forge, NeoForge, Fabric#

Mod yükleyicisi, modların oyuna bağlanmasını sağlayan ara katmandır. Üç seçenek var ve bir sunucuda yalnızca birini kullanabilirsiniz. Seçimi modpackiniz ya da oynamak istediğiniz modlar belirler.

Pratik özet: hazır bir modpack kuruyorsanız modpackin istediği yükleyiciyi kullanın, tartışma yok. Kendi mod listenizi yapıyorsanız ve performans önceliğinizse Fabric, büyük içerik modları (teknoloji, büyü, boyut modları) istiyorsanız Forge veya NeoForge tarafındasınız. Sunucu tarafındaki kurulum farkları için Forge sunucu kurulumu ve Fabric sunucu kurulumu sayfalarına geçebilirsiniz.

Mod Kurmadan Önce: Sürüm, Java ve Yedek#

Kurulumların büyük çoğunluğu üç kontrol yapılmadığı için başarısız olur. Dosyaları indirmeden önce bunları netleştirin.

1. Minecraft sürümünü sabitleyin#

Modun indirme sayfasında yazan sürüm, sunucunuzun ve istemcinizin sürümüyle birebir aynı olmalıdır. “26.2 için” yazan bir mod 26.1.2’de çalışmaz. Güncel kararlı sürüm 26.2 “Chaos Cubed” (16 Haziran 2026, protokol 776); 26.3 henüz yayımlanmadı, snapshot aşamasında.

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

Java 26 çıktı ancak LTS değil; sunucu tarafında Java 25 LTS tercih edin. Sürüm eşleşmesinin ayrıntısı hangi Java sürümü gerekir sayfasında.

3. 26.1 kırılmasını hesaba katın#

4. Yedek alın#

Mod eklemek dünya verisini kalıcı olarak değiştirir. Bir modu kurup sonra kaldırdığınızda, o modun eklediği blokların bulunduğu chunk’lar bozulabilir. Kurulum öncesi world, world_nether ve world_the_end klasörlerinin tam kopyasını alın; düzeni yedekleme rehberinde bulabilirsiniz.

İstemci Tarafına Mod Kurulumu#

1. Mod yükleyicisini kurun#

   Forge veya NeoForge installer’ını çalıştırıp “Install client” seçeneğini işaretleyin. Fabric’te installer’ın Client sekmesinden Minecraft sürümünü (26.2) ve Loader sürümünü (0.19.3) seçip kurun. Kurulum, launcher’a yeni bir profil ekler.

2. Profili bir kez çalıştırın#

   Minecraft Launcher’da yeni oluşan profili seçip oyunu bir kez açın ve kapatın. Bu adım mods klasörünün oluşmasını sağlar; klasörü elle de açabilirsiniz.

   Windows : %appdata%\.minecraft\mods
   Linux   : ~/.minecraft/mods
   macOS   : ~/Library/Application Support/minecraft/mods

3. Mod jar dosyalarını kopyalayın#

   İndirdiğiniz .jar dosyalarını doğrudan mods klasörüne atın. Arşivleri açmayın, alt klasör oluşturmayın — mod yükleyicisi yalnızca klasörün ilk seviyesindeki jar dosyalarını okur.

4. Fabric kullanıyorsanız Fabric API’yi ekleyin#

   Fabric modlarının neredeyse tamamı Fabric API’ye bağımlıdır. fabric-api-0.157.0+26.2.jar dosyasını da aynı klasöre koyun, yoksa oyun açılışta modları devre dışı bırakır.

5. Belleği artırın ve oyunu başlatın#

   Launcher’da profilin JVM argümanlarından heap değerini yükseltin. Modlu oynarken istemci tarafında da 6-8 GB ayırmak makuldür.

   -Xms6G -Xmx6G

Sunucu Tarafına Mod Kurulumu#

Sunucu tarafı, mod yükleyicisinin kendi installer’ını sunucu kipinde çalıştırmakla başlar. Aşağıdaki komutlar hem Windows’ta (cmd/PowerShell) hem Linux’ta (terminal) aynıdır, çünkü ikisinde de Java çalıştırılır.

# Forge sunucu kurulumu (Minecraft 26.2)
java -jar forge-26.2-65.1.0-installer.jar --installServer

# Fabric sunucu kurulumu (Minecraft 26.2)
java -jar fabric-installer-1.1.2.jar server -mcversion 26.2 -downloadMinecraft

Kurulum bittiğinde dizin şu hâle gelir:

minecraft-server/
├── libraries/              → yükleyici kütüphaneleri
├── mods/                   → mod jar dosyaları BURAYA
├── config/                 → modların ayar dosyaları
├── world/                  → dünya verisi
├── eula.txt                → eula=true yapılmalı
├── server.properties       → temel sunucu ayarları
├── user_jvm_args.txt       → Forge/NeoForge RAM ayarı
└── run.sh / run.bat        → başlatma betiği

Forge ve NeoForge’da RAM’i başlatma betiğine değil user_jvm_args.txt dosyasına yazarsınız. 16 GB’lık bir pakette işletim sistemine pay bırakarak şu değerleri girin:

# user_jvm_args.txt
-Xms14G
-Xmx14G
-XX:+UseG1GC

Modları mods klasörüne kopyaladıktan sonra sunucuyu başlatın. İlk açılış modlu sunucularda birkaç dakika sürebilir; konsolda mod sayısı ve yükleme aşamaları görünür. İşletim sistemine özel ayrıntılar (servis yapma, güvenlik duvarı, dosya aktarımı) için Windows’ta Forge kurulumu ya da Ubuntu’da Forge kurulumu sayfalarına geçin.

Hangi Mod Nereye? İstemci–Sunucu Eşleşmesi#

Modların hepsi iki tarafa birden kurulmaz. Yanlış yerleştirme, oyuncuların bağlanamamasına ya da sunucunun boşuna kaynak harcamasına yol açar.

Modlu Sunucu İçin Donanım#

Modlu sunucular vanilla sunuculardan katbekat ağırdır. Her mod açılışta sınıflarını belleğe yükler, kendi dünya üretim kurallarını çalıştırır ve tick başına ek iş yaratır. Minecraft’ın ana tick döngüsü tek çekirdekte çalıştığı için burada belirleyici olan çekirdek sayısı değil saat hızıdır.

Disk tarafında NVMe SSD şart: modlu dünyalarda chunk okuma-yazma trafiği vanilla’ya göre kat kat fazladır ve SATA gecikmesi doğrudan TPS düşüşü olarak görünür. Batihost’un modlu Minecraft sunucu paketleri yüksek frekanslı Ryzen işlemci ve NVMe disk üzerine kuruludur. Oyuncu sayısına göre ayrıntılı RAM planlamasını RAM hesaplama sayfasında bulabilirsiniz.

Sunucu Performansını Artıran Modlar#

Fabric ve NeoForge tarafında, oyunun davranışını değiştirmeden yalnızca verimliliği artıran modlar var. Modlu bir sunucuda bunlar neredeyse zorunludur.

Mod Çakışmaları ve Sık Hatalar#

Modlu sunucu kurulumunda sorun çıkması kural, çıkmaması istisnadır. Şu yöntem neredeyse her vakayı çözer.

İkili arama ile suçluyu bulma#

1. Modların yarısını ayırın#

   mods klasöründeki jar dosyalarının yarısını geçici bir klasöre taşıyın ve sunucuyu başlatın.

2. Sonuca göre daralt#

   Sunucu açıldıysa sorun taşıdığınız yarıdadır; açılmadıysa kalan yarıdadır. Sorunlu yarıyı tekrar ikiye bölün.

3. Tekrarlayın#

   100 modluk bir pakette 7 denemede tek bir jar’a inersiniz. Bulduğunuz modun sürümünü güncelleyin ya da alternatifini arayın.

En sık görülen hata mesajları#

Missing or unsupported mandatory dependencies:
    Mod ID: 'fabric', Requested by: 'ornekmod', Expected range: '>=0.157.0'

Incompatible mod set! Server has extra mods: [ornekmod]

java.lang.OutOfMemoryError: Java heap space

Missing dependencies

Modun ihtiyaç duyduğu kütüphane yok. Fabric’te genelde Fabric API eksiktir; mod sayfasındaki “Dependencies” bölümünü okuyun.

Incompatible mod set

Sunucu ile istemcinin mod listesi tutmuyor. Oyunculara tam mod listesini ve sürümlerini verin, ideali paketi tek arşiv hâlinde dağıtmaktır.

OutOfMemoryError

Heap yetersiz. user_jvm_args.txt içindeki değeri yükseltin; çözüm adımları Out of Memory hatası sayfasında.

Exit code 1 / anında kapanma

Java sürümü yanlış olabilir. 26.x mutlaka Java 25 ister.

Sunucu çöktüğünde crash-reports klasöründeki en yeni dosyayı açın; hatanın kaynağı genellikle raporun ilk 30 satırındaki mod adında yazar. Raporu satır satır çözümlemeyi crash report okuma rehberinde anlattık.

Modları Güncelleme ve Kaldırma#

Mod güncellemek jar dosyasını değiştirmekten ibaret görünür ama dünya verisi işin içinde olduğu için dikkat ister.

• Önce yedek: güncellemeden önce dünya klasörlerinin ve config klasörünün kopyasını alın.
• Tek tek değil, paket hâlinde: modları teker teker güncellemek sürüm karmaşası yaratır. Modpack kullanıyorsanız paketin yeni sürümüne bir bütün olarak geçin.
• İki tarafı birden: sunucuda güncellediğiniz her modu oyuncuların da güncellemesi gerekir; aksi hâlde “incompatible mod set” hatası alırlar.
• Kaldırırken: bir modu kaldırdığınızda o modun blokları dünyada boşluk bırakır. Kaldırma işlemini oyuncular çevrimdışıyken yapın ve önce yedekli bir test dünyasında deneyin.
• config klasörünü silmeyin: ayarlarınız orada durur; yalnızca sorun çıkaran modun kendi dosyasını silin.

Hazır paketlerle işe başlamak isterseniz 2026 modpack listesine göz atın; oradaki paketlerin her biri sürüm uyumu test edilmiş mod setleri sunar.

Özetle#

Minecraft mod kurulumu üç adıma indirgenir: doğru mod yükleyicisini (Forge 65.1.0, NeoForge 26.2.0.59 veya Fabric Loader 0.19.3) kurmak, modları mods klasörüne kopyalamak ve istemci ile sunucu taraflarını aynı sürümde tutmak. Fabric kullanıyorsanız Fabric API’yi eklemeyi, Forge kullanıyorsanız RAM’i user_jvm_args.txt içinden vermeyi unutmayın.

2026’da en kritik nokta sürüm uyumudur: 26.1’in getirdiği unobfuscation nedeniyle eski modlar 26.x’te çalışmaz, sunucu da Java 25 ile açılmalıdır. Donanım tarafında modlu sunucuda 16 GB RAM, yüksek frekanslı Ryzen 9 işlemci ve NVMe SSD alt çizgidir. Her kurulum ve güncelleme öncesi dünya yedeği almayı alışkanlık hâline getirirseniz, çakışan bir modu geri almak birkaç dakikalık iş olur.