Bilgi Bankası

Minecraft sunucunuzu yeni aldıysanız ve sunucuya mod yüklemek istiyorsanız işlem ilk bakışta karışık görünebilir.

Aslında temel mantık son derece basittir:

Sunucuyu kapat
↓
mods klasörünü aç
↓
Modun .jar dosyasını yükle
↓
Gerekli dependency modlarını da yükle
↓
Sunucuyu tekrar başlat

Ancak burada çok önemli bir nokta vardır:

Her mod her Minecraft sunucusunda çalışmaz.

Modun:

• Minecraft sürümü,
• Forge / NeoForge / Fabric türü,
• gerekli diğer modları,
• sunucu tarafında çalışıp çalışmadığı

doğru olmalıdır.

Bu rehber Minecraft sunucusunu bugün ilk kez almış bir kullanıcının bile uygulayabileceği şekilde hazırlanmıştır.

30 saniyelik çözüm: Minecraft sunucusuna mod nasıl kurulur?

Öncelikle sunucunuzun Forge, NeoForge veya Fabric olduğundan emin olun.

Sunucuyu kapatın.

Dosya yöneticisinden:

mods

klasörünü açın.

İndirdiğiniz mod dosyasını buraya yükleyin.

Örneğin:

journeymap-neoforge.jar

dosyasını:

mods/journeymap-neoforge.jar

şeklinde yükleyin.

Mod başka bir moda ihtiyaç duyuyorsa onu da aynı klasöre yükleyin.

Sunucuyu tekrar başlatın.

Bitti.

Sunucu açılmıyorsa aşağıdaki bölümlerde neyi yanlış yaptığınızı bulabilirsiniz.

1. Minecraft mod nedir?

Mod, Minecraft'a yeni özellikler ekleyen dosyalardır.

Modlarla örneğin:

• yeni eşyalar,
• yeni bloklar,
• yeni yaratıklar,
• yeni dünyalar,
• yeni makineler,
• yeni biyomlar,
• haritalar,
• teknoloji sistemleri

eklenebilir.

Örneğin bir mod Minecraft'a yüzlerce yeni makine ekleyebilirken başka bir mod sadece küçük bir özellik ekleyebilir.

2. Mod ile plugin aynı şey mi?

Hayır.

Yeni kullanıcıların en fazla karıştırdığı konulardan biri budur.

Çok basit şekilde:

Forge / NeoForge / Fabric
→ MOD
→ mods klasörü

Paper / Spigot / Purpur
→ PLUGIN
→ plugins klasörü

Yani Forge için indirdiğiniz bir modu:

plugins

klasörüne atmayın.

Paper için indirdiğiniz bir plugini de:

mods

klasörüne atmayın.

3. Mod yüklemek için sunucum Forge olmak zorunda mı?

Forge seçeneklerden biridir ancak tek seçenek değildir.

Minecraft modlu sunucularda yaygın olarak:

Forge
NeoForge
Fabric

gibi mod loader sistemleri kullanılır.

İndireceğiniz mod hangi loader için hazırlanmışsa sunucunuzun da ona uygun olması gerekir.

4. Forge nedir?

Forge, Minecraft Java Edition için uzun yıllardır kullanılan mod yükleme sistemlerinden biridir.

Forge için hazırlanmış modlar Forge sunucularında kullanılır.

Örneğin mod dosyanızın indirme sayfasında:

Mod Loader: Forge

yazıyorsa Forge sürümünü indirmeniz gerekir.

5. NeoForge nedir?

NeoForge da Minecraft Java Edition için kullanılan bir mod loader sistemidir.

Yeni Minecraft sürümlerindeki birçok mod NeoForge sürümü yayınlayabilir.

İndirme sayfasında:

NeoForge

yazıyorsa NeoForge uyumlu dosyayı kullanmanız gerekir.

Forge ile NeoForge isimlerinin birbirine benzemesi sizi yanıltmasın.

Forge dosyasını NeoForge dosyasıymış gibi düşünmeyin.

6. Fabric nedir?

Fabric de Minecraft modları çalıştırmak için kullanılan başka bir mod loader sistemidir.

Fabric için hazırlanmış bir mod genellikle Fabric Loader üzerinde çalıştırılır.

Bazı Fabric modları ayrıca:

Fabric API

isimli moda ihtiyaç duyabilir.

7. Forge modu Fabric sunucuda çalışır mı?

Genellikle hayır.

Örneğin:

Sunucu: Fabric
Mod: Forge

ise yanlış dosya indirmişsinizdir.

Modun Fabric sürümü varsa onu indirmeniz gerekir.

8. Fabric modu NeoForge sunucuda çalışır mı?

Normal şartlarda hayır.

Şöyle düşünün:

Sunucu Forge ise
→ Forge mod

Sunucu NeoForge ise
→ NeoForge mod

Sunucu Fabric ise
→ Fabric mod

Bu basit kural yeni kullanıcıların yaptığı hataların büyük bölümünü engeller.

9. Minecraft sürümü de aynı olmak zorunda mı?

Evet, çok önemlidir.

Örneğin sunucunuz:

Minecraft 1.21.1

ise sadece modun adına bakıp herhangi bir sürümünü indirmeyin.

Modun:

Minecraft 1.21.1

ile uyumlu dosyasını bulun.

Örneğin:

Sunucu: Minecraft 1.21.1
Mod: Minecraft 1.20.1

ise mod büyük ihtimalle çalışmayacaktır.

10. "En son sürümü indirdim" yeterli mi?

Hayır.

Bu da çok sık yapılan bir hatadır.

Modun en yeni sürümü sizin Minecraft sürümünüz için olmayabilir.

Örneğin:

Sunucu: Minecraft 1.21.1

Modun en yeni dosyası:
Minecraft 1.21.8

ise sadece "en yeni" olduğu için bu dosyayı indirmeyin.

Sizin Minecraft sürümünüze uygun olan dosyayı indirin.

11. Mod dosyası nasıl görünür?

Minecraft modları genellikle:

.jar

uzantılıdır.

Örneğin:

examplemod-1.21.1-neoforge.jar
jei-1.21.1-forge.jar
fabric-api.jar

gibi dosyalar görebilirsiniz.

Bu JAR dosyaları sunucudaki:

mods

klasörüne yüklenir.

12. ZIP dosyasını mods klasörüne atacak mıyım?

Her zaman değil.

İndirdiğiniz dosya:

mod.zip

şeklindeyse dosyanın gerçekten mod dosyası olup olmadığını kontrol edin.

Çoğu Minecraft modu:

modadi.jar

şeklinde gelir.

Bir modpack indirdiyseniz ZIP dosyasının içerisinde onlarca mod, config ve başka dosya bulunabilir.

Modpack ile tek bir mod aynı şey değildir.

13. mods klasörü nerede?

Minecraft sunucunuzun ana klasöründe bulunur.

Örneğin:

config
logs
mods
world
server.properties
run.bat

gibi dosya ve klasörler görüyorsanız:

mods

klasörünü açın.

14. mods klasörü yoksa ne yapacağım?

Forge, NeoForge veya Fabric sunucunuzu henüz hiç çalıştırmadıysanız mods klasörü oluşmamış olabilir.

Sunucuyu uygun mod loader ile bir kez başarılı şekilde başlatın.

Ardından:

mods

klasörü oluşabilir.

Eğer Vanilla veya Paper çalıştırıyorsanız mods klasörü beklemeyin.

Önce doğru server yazılımını kullandığınızdan emin olun.

15. Mod yüklemeden önce sunucuyu kapatmalı mıyım?

Evet.

En güvenli yöntem budur.

Minecraft konsoluna:

stop

yazın.

Sunucunun tamamen kapanmasını bekleyin.

Daha sonra mod dosyalarını yükleyin.

Sonra sunucuyu yeniden başlatın.

16. Mod dosyasını yükledim, şimdi ne yapacağım?

Sunucuyu yeniden başlatın.

Konsolu takip edin.

Sunucu başarılı şekilde:

Done!

mesajına kadar geliyorsa temel olarak açılmış demektir.

Ancak konsolda kırmızı hata satırları varsa onları da kontrol edin.

17. Mod oyuncunun bilgisayarına da kurulmalı mı?

Bazı modlarda evet, bazı modlarda hayır.

Bu çok önemli bir ayrımdır.

Bazı modlar hem:

SERVER
+
CLIENT

tarafında bulunmalıdır.

Örneğin mod oyuna:

• yeni bloklar,
• yeni itemler,
• yeni yaratıklar,
• yeni mekanikler

ekliyorsa oyuncuların bilgisayarında da aynı moda ihtiyaç duyulması çok yaygındır.

Ancak bazı modlar sadece sunucu tarafında çalışabilir.

Modun kendi indirme sayfasındaki açıklamayı kontrol edin.

18. Sunucuya modu attım ama oyuncu bağlanamıyor

Oyuncunun bilgisayarında gerekli mod bulunmuyor olabilir.

Örneğin sunucuda:

ExampleMod.jar

var ama oyuncunun Minecraft'ında yoksa bağlantı sırasında mod uyumsuzluğu mesajı alınabilir.

Oyuncunun:

• aynı Minecraft sürümünü,
• aynı mod loader türünü,
• gerekli modları

kullandığından emin olun.

19. Mod sürümleri de aynı olmalı mı?

Sunucu ve client arasında zorunlu çalışan modlarda aynı veya uyumlu mod sürümlerini kullanmak en güvenli yöntemdir.

Örneğin sunucuda:

ExampleMod-5.2.jar

oyuncuda:

ExampleMod-3.1.jar

bulunuyorsa sürüm uyuşmazlığı yaşanabilir.

Modpack kullanıyorsanız tüm oyuncuların aynı modpack sürümünü kullanması işleri çok kolaylaştırır.

20. Client-only mod nedir?

Bazı modlar yalnızca oyuncunun bilgisayarında çalışmak için hazırlanmıştır.

Bunlara:

Client-only mod

denir.

Örneğin bazı:

• arayüz,
• görsel,
• shader,
• kamera,
• HUD

modları sadece client tarafında kullanılabilir.

Böyle bir modu sunucuya atarsanız bazı durumlarda sunucu açılmayabilir.

21. Client-only modu sunucuya atarsam ne olur?

Mod düzgün tasarlanmışsa sunucu onu yok sayabilir veya server tarafında yüklemeyebilir.

Ancak bazı client-only modlar dedicated server üzerinde hata oluşturabilir.

Konsolda buna benzer ifadeler görebilirsiniz:

DEDICATED_SERVER
invalid dist
client class
net.minecraft.client

Bu durumda yüklediğiniz modun sunucu tarafında kullanılıp kullanılmadığını kontrol edin.

22. Server-only mod nedir?

Bazı modlar yalnızca Minecraft sunucusunda çalışabilir ve oyuncuların bilgisayarına kurulması gerekmeyebilir.

Bunlara basitçe:

Server-side mod

diyebiliriz.

Bu nedenle her mod için:

Hem sunucuya hem oyuncuya kur

şeklinde tek bir kural yoktur.

Modun sayfasını kontrol etmek gerekir.

23. Dependency nedir?

Dependency, bir modun çalışabilmek için ihtiyaç duyduğu başka bir mod veya kütüphanedir.

Örneğin:

Mod A
↓
GeckoLib gerekiyor

ise sadece Mod A'yı yüklemek yeterli değildir.

GeckoLib'in de:

• doğru Minecraft sürümünü,
• doğru loader sürümünü

yüklemeniz gerekir.

24. Dependency eksikse ne olur?

Sunucu açılmayabilir.

Konsolda buna benzer mesajlar görebilirsiniz:

requires
required dependency
missing dependency
dependency not found

Örneğin:

ExampleMod requires GeckoLib

görüyorsanız problem büyük ihtimalle açıktır.

Gerekli GeckoLib sürümünü yüklemelisiniz.

25. Fabric API nedir?

Fabric kullanan birçok mod ayrıca:

Fabric API

isimli mod/kütüphaneye ihtiyaç duyabilir.

Bu nedenle Fabric modunun indirme sayfasında:

Requires Fabric API

yazıyorsa Fabric API'yi de:

mods

klasörüne yükleyin.

Fabric API'nin de kullandığınız Minecraft sürümüyle uyumlu olması gerekir.

26. GeckoLib nedir?

GeckoLib bazı modların animasyon sistemleri için kullandığı bir kütüphanedir.

Kurduğunuz mod:

GeckoLib required

diyorsa GeckoLib'i de kurmanız gerekir.

Ancak rastgele GeckoLib sürümü indirmeyin.

Örneğin sunucunuz NeoForge ise NeoForge uyumlu, Minecraft sürümünüze uygun sürümü seçin.

27. Modrinth veya CurseForge'dan mod indirirken neye bakacağım?

Dosyayı indirmeden önce üç şeyi kontrol edin:

1. Minecraft sürümü

2. Mod Loader

3. Dependencies

Örneğin sunucunuz:

Minecraft: 1.21.1
Loader: NeoForge

ise indirdiğiniz dosyada da bunlarla uyumluluk arayın.

Forge veya Fabric dosyasını yanlışlıkla indirmeyin.

28. Modu güvenilir yerden indirmek önemli mi?

Evet.

JAR dosyaları çalıştırılabilir Java kodu içerebilir.

Bu nedenle internette rastgele:

minecraft-mod-bedava-full-indir.jar

gibi bilinmeyen sitelerden dosya indirip sunucunuzda çalıştırmayın.

Mod geliştiricisinin belirttiği resmi kaynakları ve bilinen mod platformlarını tercih edin.

29. Mod kurdum ve sunucu artık açılmıyor

Bu durumda ilk soru şudur:

Sunucu modu yüklemeden önce açılıyor muydu?

Cevap evetse son yüklediğiniz mod güçlü bir şüphelidir.

Örneğin:

Sunucu açılıyordu
↓
ExampleMod.jar yükledim
↓
Sunucu açılmıyor

ise sunucuyu kapatın.

Son yüklediğiniz:

ExampleMod.jar

dosyasını mods klasöründen çıkarın.

Sunucuyu tekrar başlatın.

Açılıyorsa modun:

• sürümünü,
• loader türünü,
• dependencylerini,
• server uyumluluğunu

kontrol edin.

30. Modu silmek yerine geçici olarak kapatabilir miyim?

Dosyayı başka bir klasöre taşıyabilirsiniz.

Örneğin:

mods/ExampleMod.jar

dosyasını:

disabled-mods/ExampleMod.jar

gibi Minecraft'ın mod yüklemediği başka bir klasöre taşıyabilirsiniz.

Böylece dosyayı tamamen kaybetmeden test yapabilirsiniz.

31. 100 mod var, hangisi sorunlu nasıl bulacağım?

100 modlu sunucuda modları rastgele tek tek silmek zaman kaybettirebilir.

Önce:

logs/latest.log

dosyasını kontrol edin.

Şu kelimeleri arayın:

ERROR
FATAL
Exception
Caused by
requires
dependency
ModLoadingException

Çoğu zaman gerçek sorun burada görünür.

32. latest.log nerede?

Sunucu klasörünün içerisinde:

logs

klasörüne girin.

Burada:

latest.log

dosyasını görebilirsiniz.

Yani:

Sunucu Klasörü
↓
logs
↓
latest.log

Bu dosya Minecraft sunucusunun en önemli hata kayıtlarından biridir.

33. crash-report dosyası nerede?

Sunucu crash verdiyse:

crash-reports

isimli klasör oluşabilir.

İçerisinde:

crash-....txt

şeklinde dosyalar bulunabilir.

Mod kaynaklı crash problemlerinde hem:

logs/latest.log

hem de:

crash-reports

kontrol edilmelidir.

34. "requires" yazıyorsa ne yapacağım?

Örneğin hata:

Mod A requires Mod B

diyorsa Mod A'nın çalışması için Mod B gereklidir.

Yapmanız gereken:

Mod B'nin doğru sürümünü indir
↓
mods klasörüne yükle
↓
Sunucuyu yeniden başlat

Bu kadar.

35. "Wrong mod loader" veya benzeri hata alıyorum

Yanlış loader için hazırlanmış mod indirmiş olabilirsiniz.

Örneğin:

Sunucu: NeoForge

İndirdiğiniz mod:
ExampleMod-Fabric.jar

yanlıştır.

NeoForge sürümünü bulmanız gerekir.

36. Java sürümü de önemli mi?

Evet.

Minecraft sürümünüz ve mod loader'ınız belirli bir Java sürümü gerektirebilir.

Sunucunun Java sürümünü kontrol etmek için Windows CMD veya PowerShell üzerinde:

java -version

Linux üzerinde de:

java -version

kullanabilirsiniz.

Yanlış Java sürümü kullanıldığında modları değiştirmek sorunu çözmeyebilir.

37. Modpack nedir?

Modpack tek bir mod değildir.

Birbiriyle birlikte çalışması için hazırlanmış:

• modlar,
• config dosyaları,
• scriptler,
• ayarlar

paketidir.

Örneğin bir modpack:

150 mod

içerebilir.

Böyle bir paketi kurarken 150 modu tek tek indirmek yerine modpack'in server pack dosyası varsa onu kullanmak daha doğru olabilir.

38. Server Pack nedir?

Bazı modpack geliştiricileri sunucuda kullanılmak üzere ayrıca:

Server Pack

yayınlar.

Server pack içerisinde sunucu için gerekli:

• modlar,
• configler,
• başlangıç dosyaları

hazır bulunabilir.

Mümkünse modpack kurulumunda geliştiricinin yayınladığı server pack'i tercih edin.

39. Client mod klasörünü komple sunucuya atabilir miyim?

Bu sık yapılan bir hatadır.

Bilgisayarınızdaki:

.minecraft/mods

klasörünü olduğu gibi sunucuya kopyalamak her zaman doğru değildir.

Çünkü client mod klasörünüzde yalnızca oyuncunun bilgisayarında çalışması gereken modlar bulunabilir.

Bunlardan bazıları dedicated server üzerinde crash oluşturabilir.

Modpack'in server pack'i varsa onu kullanmak daha güvenlidir.

40. Windows VDS üzerinde mod nasıl kurulur?

Windows VDS üzerinde Minecraft çalıştırıyorsanız Minecraft konsoluna:

stop

yazın.

Sunucu klasörünü açın.

Örneğin:

C:\MinecraftServer\

klasörünüz varsa:

C:\MinecraftServer\mods\

klasörüne girin.

Mod JAR dosyasını buraya kopyalayın.

Örneğin:

C:\MinecraftServer\mods\ExampleMod.jar

Daha sonra sunucuyu tekrar başlatın.

41. Hosting panelinden mod nasıl kurulur?

Sunucu panelinize giriş yapın.

Minecraft sunucunuzu kapatın.

Dosya Yöneticisi / File Manager bölümünü açın.

Şu klasöre girin:

mods

Modun:

.jar

dosyasını yükleyin.

Gerekli dependency modlarını da yükleyin.

Sunucuyu tekrar başlatın.

42. Linux sunucuda mod nasıl kurulur?

Temel mantık aynıdır.

Sunucuyu güvenli şekilde kapatın.

Mod dosyasını:

mods/

klasörüne yükleyin.

Örneğin sunucu klasörünüz:

/home/minecraft/server/

ise:

/home/minecraft/server/mods/ExampleMod.jar

şeklinde olabilir.

Daha sonra sunucuyu tekrar başlatın.

43. FTP veya SFTP ile mod yükleyebilir miyim?

Evet.

Hosting sağlayıcınız FTP veya SFTP erişimi veriyorsa mod dosyasını bu yöntemle de yükleyebilirsiniz.

Hedef klasör yine:

mods

klasörüdür.

44. Mod güncellemesi nasıl yapılır?

Önce sunucuyu kapatın.

Örneğin eski dosya:

ExampleMod-1.0.jar

yeni dosya:

ExampleMod-1.1.jar

ise eski JAR dosyasını kaldırın.

Yeni JAR dosyasını yükleyin.

İkisini birlikte bırakmayın.

Sonra sunucuyu başlatın.

45. Mod güncellemeden önce yedek almalı mıyım?

Evet, özellikle modlu dünyalarda tavsiye edilir.

Bazı modlar dünyaya:

• özel bloklar,
• özel itemler,
• özel yapılar,
• özel dimensionlar

ekler.

Bir modu kaldırmak veya büyük sürüm değiştirmek dünya verilerini etkileyebilir.

Özellikle önemli bir sunucuda değişiklik yapmadan önce world ve config dosyalarınızı yedekleyin.

46. Bir modu direkt silmek güvenli mi?

Her zaman değildir.

Örneğin mod dünyaya özel bloklar ve makineler ekliyorsa modu kaldırmak o içeriklerin kaybolmasına veya dünya yüklenirken sorun oluşmasına neden olabilir.

Bu nedenle:

Önce yedek al
↓
Modun kaldırma talimatını kontrol et
↓
Sonra değişiklik yap

şeklinde ilerlemek daha güvenlidir.

47. En sık yapılan mod kurulum hataları

Hata 1: Yanlış Minecraft sürümünü indirmek

Sunucu: 1.21.1
Mod: 1.20.1

Hata 2: Yanlış loader indirmek

Sunucu: NeoForge
Mod: Fabric

Hata 3: Dependency yüklememek

Mod GeckoLib istiyor
ama GeckoLib kurulu değil.

Hata 4: Client-only modu sunucuya atmak

Bazı görsel veya client modları dedicated server üzerinde bulunmamalıdır.

Hata 5: Modu plugins klasörüne atmak

Forge/NeoForge/Fabric modları normalde:

mods

klasörüne yüklenir.

Hata 6: ZIP dosyasını mod sanmak

Dosyanın gerçekten yüklenmesi gereken JAR olup olmadığını kontrol edin.

Hata 7: Sunucu ve client modlarını farklı tutmak

Her iki tarafta bulunması gereken modlarda sürüm uyumuna dikkat edin.

Hata 8: Hata mesajını okumadan modları rastgele silmek

Önce:

logs/latest.log

dosyasını kontrol edin.

48. Baştan sona örnek mod kurulumu

Diyelim sunucunuz:

Minecraft 1.21.1
NeoForge

ve yüklemek istediğiniz mod:

ExampleMod
Minecraft 1.21.1
NeoForge

için hazırlanmış.

Yapacağınız işlem:

1. Sunucu paneline gir.

2. Konsola stop yaz.

3. Dosya yöneticisini aç.

4. mods klasörüne gir.

5. ExampleMod.jar dosyasını yükle.

6. Mod dependency istiyor mu kontrol et.

7. İstiyorsa gerekli dependency .jar dosyasını da yükle.

8. Sunucuyu başlat.

9. Konsolu takip et.

10. Sunucu açılıyorsa oyuna bağlan.

11. Mod client tarafında da gerekiyorsa bilgisayarına da aynı uyumlu modu kur.

Bitti.

49. Mod yükledikten sonra sunucu açılmıyorsa hızlı kontrol

Mod doğru Minecraft sürümü mü?
        ↓
Forge / NeoForge / Fabric doğru mu?
        ↓
Dependency eksik mi?
        ↓
Mod server tarafında çalışıyor mu?
        ↓
Java sürümü doğru mu?
        ↓
latest.log ne diyor?
        ↓
crash-report ne diyor?
        ↓
Son yüklediğim modu çıkarınca sunucu açılıyor mu?

50. Hâlâ anlamadıysanız sadece bunu yapın

Sunucunuz Forge, NeoForge veya Fabric ise:

Sunucuyu kapat
↓
mods klasörüne gir
↓
Doğru Minecraft sürümüne ait
doğru loader için hazırlanmış
mod .jar dosyasını yükle
↓
Gerekli dependencyleri yükle
↓
Sunucuyu aç

Örneğin:

mods/ExampleMod.jar

Sunucu açılmazsa ilk bakacağınız yer:

logs/latest.log

olmalıdır.

Modları rastgele değiştirerek problemi çözmeye çalışmak yerine hata mesajının ne söylediğini okuyun.

Batihost'ta sadece sunucu vermiyoruz, Minecraft da biliyoruz.

Minecraft sunucunuzu yeni aldıysanız Forge, NeoForge, Fabric, dependency, client-only mod veya modpack gibi kavramlar ilk başta oldukça karışık gelebilir.

Batihost olarak Minecraft sunucu ve VDS hizmetlerinin yanında mod kurulumu, Forge, NeoForge, Fabric, Java ve Minecraft sunucu hatalarının teşhisinde de müşterilerimize yardımcı oluyoruz.

Mod yükledikten sonra sunucunuz açılmıyorsa onlarca modu rastgele silmeden önce latest.log ve crash-report dosyalarındaki gerçek hata incelenmelidir.

Batihost Minecraft Sunucu ve VDS hizmetlerini inceleyin