Modlu sunucuya mod ekleme işi göründüğünden basittir: sunucuyu durdurursunuz, indirdiğiniz .jar dosyasını sunucunun mods klasörüne kopyalarsınız, sunucuyu tekrar başlatırsınız. İşin zor kısmı dosyayı kopyalamak değil, doğru dosyayı seçmek ve oyuncuların istemcisiyle sunucuyu aynı çizgide tutmaktır. Bu sayfada çalışan bir modlu sunucuya sonradan mod eklemeyi, mod çıkarmayı ve iki işlemde de dünyayı kaybetmemeyi adım adım anlatıyoruz.
Anlatılanlar Forge, NeoForge ve Fabric için ortaktır; üçünde de mod klasörünün adı ve mantığı aynıdır. Sunucunuzu henüz kurmadıysanız önce modlu Minecraft sunucusu kurma rehberini okuyun, sonra bu sayfaya dönün.
Mod Eklemeden Önce Tutması Gereken Üç Şey#
Bir mod dosyasının sunucunuzda çalışması için üç bilginin birbirini tutması gerekir. Bu üçlüyü her indirmede kontrol ederseniz modlu sunucu hatalarının büyük bölümünü baştan elemiş olursunuz.
- Minecraft sürümü
- Sunucunuz 26.2 ise mod da 26.2 için yayınlanmış olmalı. 1.21.11 için derlenmiş bir mod 26.2 sunucusunda yüklenmez.
- Mod yükleyici (loader)
- Forge modu Fabric sunucusunda, Fabric modu Forge sunucusunda çalışmaz. NeoForge ile Forge da artık ayrı projelerdir; çoğu yeni mod NeoForge sürümü yayınlar.
- Bağımlılıklar
- Mod başka bir modu kütüphane olarak istiyorsa onu da kurmanız gerekir. Fabric tarafında bu neredeyse her zaman Fabric API’dir.
Doğru Mod Dosyasını Nereden İndirirsiniz?#
Mod indirmek için iki güvenilir kaynak vardır: Modrinth ve CurseForge. Üçüncü taraf "mod indirme" siteleri kullanmayın; bu sitelerdeki jar dosyalarına zararlı kod eklendiği çok görülmüştür. İndirdiğiniz dosya her zaman .jar uzantılı olmalıdır. Karşınıza .exe, .rar ya da kurulum sihirbazı çıkıyorsa yanlış yerdesiniz.
Bağlantılar resmî kaynaklara gider. Üçüncü taraf sitelerden mod jar’ı indirmeyin.
Her iki sitede de mod sayfasının üstünde filtre alanları vardır. Önce Game version (oyun sürümü) alanından sunucunuzun sürümünü, sonra Loader (yükleyici) alanından Forge, NeoForge veya Fabric’i seçin. Filtreleri uygulamadan listedeki ilk dosyayı indirmek, modlu sunucu hatalarının bir numaralı sebebidir.
Dosya adları da size bilgi verir. Örneğin lithium-neoforge-0.25.3+mc26.2.jar adındaki dosyanın NeoForge için olduğu ve Minecraft 26.2’yi hedeflediği isimden okunur. Bu alışkanlığı edinirseniz indirdiğiniz dosyayı açmadan doğrulayabilirsiniz.
Sunucuya Mod Ekleme: Adım Adım#
-
Sunucuyu düzgün kapatın#
Konsola önce kaydetme komutunu, sonra durdurma komutunu yazın. Süreci "kapat" düğmesiyle ya da işlem sonlandırarak bitirmeyin; yarım kalan bir dünya kaydı chunk bozulmasına yol açar.
save-all save-off stop -
Yedek alın#
Sadece dünyayı değil,
world,modsveconfigklasörlerini birlikte yedekleyin. Dünyayı geri yüklerken o günkü mod listesi ve ayar dosyaları elinizde olmazsa geri dönüş işe yaramaz.cd /opt/minecraft/server tar -czf ~/batihost-yedek-2026-08-18.tar.gz world mods config -
Mod dosyasını mods klasörüne koyun#
İndirdiğiniz
.jardosyasını sunucunun kök dizinindekimodsklasörüne kopyalayın. Klasör yoksa mod yükleyici ilk açılışta oluşturur. Dosyayı zip’ten çıkarmayın, arşivin kendisi zaten moddur.# Linux sunucuda doğrudan indirme örneği cd /opt/minecraft/server/mods ls -la # Windows sunucuda: C:\minecraft\server\mods klasörüne kopyalayın -
Bağımlılıkları da ekleyin#
Mod sayfasındaki Dependencies / Required bölümünü okuyun ve orada listelenen modları da aynı klasöre koyun. Fabric modlarının neredeyse tamamı Fabric API ister.
-
Sunucuyu başlatın ve logu izleyin#
Sunucuyu her zamanki komutunuzla açın ve konsolu izleyin. Mod yükleyici modları sayarak yükler; hata varsa açılış burada durur.
-
Aynı modu oyunculara dağıtın#
Mod içerik ekliyorsa oyuncuların istemcisinde de aynı dosya bulunmalıdır. Oyuncu tarafındaki adımlar için modlu sunucuya arkadaş bağlama sayfasına bakın.
Hangi Modlar Sunucuya Kurulmaz?#
Yeni başlayanların en sık yaptığı hata, oyuncunun bilgisayarında çalışan her modu sunucuya da atmaktır. Yalnızca istemci tarafını değiştiren modlar sunucuda hiçbir işe yaramaz; en iyi ihtimalle boşuna RAM harcar, kötü ihtimalle sunucuyu açılışta çökertir.
| Mod türü | Sunucuya kurulur mu? | Örnekler |
|---|---|---|
| İçerik modları (blok, eşya, canlı, boyut) | Evet, iki tarafa da | Teknik, sihir ve macera modları |
| Minimap ve harita modları | Hayır, sadece istemci | Xaero’s Minimap, JourneyMap istemci kısmı |
| Görüntü ve render optimizasyonu | Hayır, sadece istemci | Sodium, Embeddium, OptiFine |
| Shader ve doku araçları | Hayır, sadece istemci | Iris, shader paketleri |
| Sunucu performans modları | Evet, sadece sunucu | Lithium, FerriteCore, Krypton, spark |
| Yönetim ve koruma modları | Evet, sadece sunucu | Bölge koruma, yedekleme, ön chunk üretimi |
Ayrım şu basit soruyla yapılır: mod oyunun kurallarını mı değiştiriyor, yoksa sadece görüntüsünü mü? Kural değiştiriyorsa iki tarafa, görüntü değiştiriyorsa sadece istemciye kurulur. Sunucu tarafında hangi performans modlarının kurulacağını modlu sunucu optimizasyonu sayfasında ayrıntılı bulabilirsiniz.
Mod Çıkarma ve Dünya Kaybını Önleme#
Mod çıkarmak eklemekten daha risklidir. Bir modu mods klasöründen sildiğinizde o modun dünyaya yerleştirdiği bloklar, sandıklardaki eşyaları ve makineleri geçersiz hale gelir. Minecraft 1.16 ve sonrasında mod yükleyici bu girdileri sessizce siler; eskiden konsolda çıkan onay penceresi ve /fml confirm komutu artık geçerli değildir, o bilgiyi anlatan rehberler eskimiştir.
Zararı en aza indiren sıra şudur:
- Oyun içinde o modun makinelerini ve eşyalarını sökün, envanterleri boşaltın.
- Konsolda
save-allvesave-offçalıştırın, sunucuyustopile durdurun. world,modsveconfigklasörlerini tarihli bir yedeğe alın.- Mod jar’ını ve varsa
configiçindeki ayar dosyasını silin. - Sunucuyu açın,
logs/latest.logdosyasında yeni hata var mı kontrol edin.
--forceUpgrade ve --eraseCache parametreleriyle başlatmayı rutin haline getirmeyin. Bu parametreler dünyadaki tüm chunk’ları yeniden yazar; işlem sırasında bir kesinti olursa dünyanın tamamını kaybedebilirsiniz. Yalnızca ışık ve chunk hatası çözülemediğinde, yedek alındıktan sonra kullanılır.Mod Ekledikten Sonra RAM Ayarını Gözden Geçirin#
Her yeni mod, açılışta kayıt (registry) girdisi ve bellek tüketir. 15 mod eklediğiniz bir sunucuda dün sorunsuz çalışan RAM ayarı bugün yetmeyebilir. Modlu sunucularda tabanımız 16 GB’dır; 200 modu aşan büyük paketlerde 24-32 GB gerekir.
| Sunucu paketi | Java heap ayarı | Uygun olduğu senaryo |
|---|---|---|
| 16 GB | -Xms14G -Xmx14G | 40-80 modluk paket, 5-15 oyuncu |
| 24 GB | -Xms20G -Xmx20G | 150+ modlu paket, orta oyuncu sayısı |
| 32 GB | -Xms28G -Xmx28G | 200+ modlu büyük paket, kalabalık sunucu |
Forge ve NeoForge kurulumlarında bu değerler başlatma komutunda değil, sunucu kökündeki user_jvm_args.txt dosyasında tutulur. Dosyaya yalnızca JVM argümanları yazılır; -jar ya da dosya yolu yazılmaz.
# user_jvm_args.txt içeriği (16 GB paket)
-Xms14G
-Xmx14G
-XX:+UseG1GC
-XX:+ParallelRefProcEnabled
-XX:MaxGCPauseMillis=200Sunucunuz için kaç GB’ın doğru olduğuna karar veremiyorsanız modlu sunucu RAM tablosunu inceleyin. Donanım tarafında modlu sunucuların ana tick döngüsü tek çekirdekte çalıştığı için çekirdek sayısı değil saat hızı belirleyicidir; Batihost’un modlu Minecraft sunucu paketleri Ryzen 9 işlemci ve NVMe SSD üzerinde çalışır.
Web Panel ve FTP ile Mod Yükleme#
Sunucunuzu web panel üzerinden yönetiyorsanız SSH ya da uzak masaüstüne hiç girmenize gerek yoktur. Paneldeki dosya yöneticisinden mods klasörüne girip yükleme düğmesini kullanabilirsiniz. Küçük mod dosyaları (birkaç MB) için bu en pratik yoldur.
Tek seferde onlarca mod yükleyecekseniz veya dosyalar büyükse FTP/SFTP istemcisi kullanın. Panellerin web yükleme limiti genellikle 100 MB civarındadır ve büyük paketlerde yükleme yarıda kesilir. Adımlar için panel dosya yöneticisi ve FTP ile panele bağlanma sayfalarına bakın.
Sık Karşılaşılan Hatalar ve Anlamları#
Mod ekledikten sonra karşılaşacağınız hata mesajları aslında size sorunu doğrudan söyler. Aşağıdaki tablo, konsolda ya da oyuncunun ekranında gördüğünüz metnin ne anlama geldiğini özetler.
| Gördüğünüz metin | Nerede çıkar | Anlamı ve çözümü |
|---|---|---|
Missing or unsupported mandatory dependencies: | Sunucu açılışında, log | Bir modun istediği bağımlılık eksik. Satırdaki Mod ID ve Requested by alanlarını okuyup eksik modu kurun. |
Incompatible mod set! | Fabric açılışında | Fabric hangi modu hangi sürüme çekmeniz gerektiğini "A potential solution has been determined" satırının altında yazar. |
FAILED during APPLY (mixin) | Açılışta, crash raporu | Mod bu Minecraft sürümü için derlenmemiş ya da başka bir modla çakışıyor. Modun doğru sürümünü indirin. |
| "Your client is missing the following mods..." | Oyuncunun ekranında | Oyuncuda eksik mod var. Ekrandaki listedeki modları oyuncuya gönderin. |
Connection closed - mismatched mod channel list | Bağlanırken | İstemci ve sunucunun mod listesi ya da sürümleri farklı. İki tarafı birebir eşitleyin. |
| "Incompatible FML modded server" | Sunucu listesinde, kırmızı X | Ping yanıtına dayanan uyumsuzluk uyarısıdır. Sunucuya girmeyi deneyin; asıl hata mesajını orada görürsünüz. |
Bu hataların ayrıntılı çözümleri için mod uyuşmazlığı hatası ve modlu sunucu hataları sayfalarına bakın. Sunucu tamamen çöküyorsa crash report okuma rehberi hangi modun suçlu olduğunu bulmanızı sağlar.
Mod Listesini Düzenli Tutmanın Yolları#
Sunucu birkaç ay yaşadıktan sonra mods klasörü kontrolden çıkar: kim ne zaman hangi modu eklemiş, hangi dosya güncel, kimse hatırlamaz. Birkaç basit alışkanlık bunu önler.
- Sürüm günlüğü tutun. Sunucu kökünde düz bir metin dosyasına tarih, eklenen mod ve sürümünü yazın. Tek satırlık kayıt bile ileride saatler kazandırır.
- Eski jar’ları klasörde bırakmayın. Bir modu güncellerken eski dosyayı silin. Aynı modun iki sürümü klasörde kalırsa yükleyici çakışma hatası verir.
- Dosya adını değiştirmeyin. Mod adında sürüm bilgisi vardır; yeniden adlandırmak teşhisi zorlaştırır.
- Yedeği otomatikleştirin. Haftalık tam yedek, günlük dünya yedeği yeterlidir. Panelde zamanlanmış görevlerle kurabilirsiniz.
- Oyunculara tek paket dağıtın. Mod listesini elle göndermek yerine paketin tamamını CurseForge Launcher profili olarak dağıtmak uyuşmazlıkları bitirir.
İstemci tarafında mod kurmayı da öğrenmek isteyen oyuncularınız için Minecraft mod kurulumu sayfasını paylaşabilirsiniz; orada oyun klasörü, profil seçimi ve mod yükleyici kurulumu ayrı ayrı anlatılıyor.
Özetle#
Sunucuya mod eklemek üç adımdan ibarettir: sunucuyu stop ile durdurun, doğru sürüm ve doğru yükleyici için indirdiğiniz .jar dosyasını mods klasörüne koyun, sunucuyu tekrar başlatın. İşi güvenli kılan şey ise etrafındaki alışkanlıklardır: her değişiklikten önce world, mods ve config klasörlerini birlikte yedeklemek, modları tek tek eklemek, içerik ekleyen modları oyunculara da dağıtmak ve mod sayısı arttıkça RAM ayarını yukarı çekmek.
Mod çıkarırken aynı dikkat daha da gereklidir; silinen modun bıraktığı bloklar geri gelmez. Bir sorunla karşılaşırsanız önce logs/latest.log dosyasını okuyun: modlu sunucuda hataların neredeyse tamamı orada adıyla yazar.