Minecraft Mod ve Plugin Kurulumu – Basit Rehber

Son kontrol: 26 Eylül 2026. Modlar ve plugin'ler Minecraft sunucunu genişletir, ancak aynı şekilde çalışmazlar: Plugin'ler Paper veya Spigot için tasarlanmıştır ve çoğunlukla istemci kurulumu gerektirmeden çalışır; Forge, NeoForge veya Fabric ile çalışan modların ise çoğu zaman hem sunucuda hem oyuncunun bilgisayarında aynı şekilde bulunması gerekir. Belirleyici olan Minecraft sürümü, sunucu yazılımı, bağımlılıklar ve her yeniden başlatmadan sonra yapılan temiz bir testtir.

Plugin mi mod mu: doğru temeli seç

Dosya yüklemeden önce hedefini belirle. Yetkiler, ev noktaları, koruma bölgeleri, ekonomi, moderasyon ya da yönetici araçları eklemek istiyorsan Paper/Spigot plugin'leri çoğunlukla uygun yoldur. Yeni bloklar, biyomlar, teknik sistemler, mob'lar veya daha derin oyun mekanikleri eklemek istiyorsan genellikle Forge, NeoForge veya Fabric modlarına ihtiyacın olur.

Resmi Paper dokümantasyonu, Paper'ı Minecraft: Java Edition için bir sunucu yazılımı olarak tanımlar ve plugin'ler için diğer kaynakların yanında PaperMC ekosistemine yönlendirir. Paper plugin'leri için akla gelen birincil kaynak bu nedenle PaperMC'nin Hangar'ıdır; eklemeyle ilgili resmi talimatı, Hangar'ın yanında Modrinth'i de anan Paper dokümantasyonunda bulursun. Ek plugin yönetimi için derinlemesine dahili rehber Minecraft Plugins installieren und verwalten im Panel de uygundur.

Kurulumdan önceki gereksinimler

Önce sunucunda kurulu Minecraft sürümünü kontrol et. Bir plugin veya mod, bu sürüme ve seçilen sunucu yazılımına uymalıdır. Başka bir ana sürüm için hazırlanmış bir dosya bazen başlayabilir, ancak kararlı olduğu varsayılmamalıdır. Mart 2026'dan beri Minecraft, 1.21.x yerine yıl ve drop'a göre (26.1, 26.2, 26.3 …) sayılıyor; son eski sürüm 1.21.11 oldu. Bu nedenle birçok mod ve plugin sürüm listesinde her iki yazımı da taşıyor – tam olarak karşılaştır.

Sunucunun Java sürümünü de kontrol et. Minecraft 1.18 ile 1.20.4 arası Java 17 ile çalışır, 1.20.5 ile 1.21.11 arası Java 21 ister ve Minecraft 26.1'den (Mart 2026) itibaren Java 25 zorunludur – Paper, NeoForge ve Fabric de bunu aynı şekilde şart koşar. Yeni bir oyun sürümü için hazırlanmış bir mod veya plugin, çok eski bir Java sürümüyle hiç başlamaz. Ayrıca kurulu her mod yeni sürümü sürüm listesinde göstermeden bir mod sunucusunun Minecraft sürümünü yükseltme – büyük içerik modları yeni bir drop'tan sonra çoğu zaman haftalar, hatta aylar alır.

JAR dosyalarını değiştirmeden önce sunucuyu durdur. Dünyanın, yapılandırmanın ve plugin ya da mod klasörünün güncel bir yedeğini oluştur veya kontrol et. Özellikle Forge, NeoForge ve Fabric kurulumlarında tek bir sürüm çakışması sunucunun tamamen başlamasını engelleyebilir.

Bağımlılıklara da dikkat et. Bazı plugin'ler ek kütüphanelere veya Vault gibi temel plugin'lere ihtiyaç duyar. Bazı modlar Fabric API, Cloth Config veya başka mod kütüphaneleri gerektirir. Bu bilgiler normalde ilgili eklentinin proje sayfasında yer alır.

Paper veya Spigot ile plugin kurma

1. Plugin'i Hangar veya Modrinth üzerinden indir – platforma (Paper, Spigot, Purpur) ve sürüm listesindeki Minecraft sürümüne dikkat et. Modrinth'te soldan platforma göre filtreleyebilirsin; bazı projeler aynı işlevi ayrıca Fabric modu olarak da sunar ve o yanlışlıkla plugin klasörüne düşer.
2. game-serverhosting üzerindeki sunucu panona git.
3. Mods & Plugins sekmesine geç.
4. İstediğin plugin'i ara ve panelde mevcutsa Yükle'ye tıkla.
5. Sunucuyu yeniden başlat.

Alternatif olarak JAR dosyasını elle /plugins klasörüne yükleyebilirsin. Yeniden başlatmadan sonra plugin çoğunlukla kendi alt klasöründe otomatik olarak bir yapılandırma dosyası oluşturur. Bu dosyayı ancak sunucu plugin ile bir kez başladıktan sonra aç, aksi halde varsayılan değerler sıklıkla eksik olur.

Başlangıç için önerilen plugin'ler tipik temel araçlar olarak kalır, ancak yalnızca gerçekten ihtiyacın olanı kur:

• EssentialsX – Temel işlevler (home, warp, kit)
• LuckPerms – Yetki sistemi
• WorldGuard – Bölge koruması
• Vault – Ekonomi/yetkiler için API köprüsü (EssentialsX gibi bir ekonomi plugin'i gerektirir)
• CoreProtect – Blok kaydı / grief önleme

Kurulumdan sonra yalnızca sunucunun başlayıp başlamadığını test etme. Oyunda en az bir plugin komutunu, yetki dağıtımını ve konsol çıktısını kontrol et. Bir plugin yüklenmesine rağmen komutlar engelleniyorsa sorun çoğu zaman yetkilerde veya eksik bağımlılıklardadır.

Forge, NeoForge veya Fabric ile mod kurma

Kısa bir sınıflandırma: NeoForge, 2023'ten beri Forge'un çatalıdır ve orijinal ekibin neredeyse tamamı onunla çalışmaya devam ediyor. Minecraft 1.21 ve üzeri için eski Forge modlarının çoğu artık yalnızca NeoForge sürümleri yayımlıyor; Forge ise eski mod paketleri (örneğin 1.12.2, 1.16.5 veya 1.20.1) için doğru seçim olmaya devam ediyor. Fabric, kendi başına hafif bir ekosistemdir – Fabric modları ne Forge'da ne de NeoForge'da çalışır.

1. Sunucunun Forge, NeoForge veya Fabric ile çalıştığından emin ol – hem de modun yapıldığı loader ile. Minecraft 1.21 ve üzeri için NeoForge, Forge'un olağan halefidir; Forge ve NeoForge dosyaları 1.20.2'den beri birbirinin yerine kullanılamaz.
2. Modu Modrinth veya CurseForge üzerinden indir – loader'a (Forge, NeoForge veya Fabric) ve Minecraft sürümüne uygun olarak. Bir NeoForge dosyası Forge sunucusunda çalışmaz, tersi de geçerlidir.
3. JAR dosyasını /mods klasörüne yükle.
4. Projenin istemci/sunucu tarafı bilgisini kontrol et. Ortak oynanış modları her iki tarafta uyumlu sürümlerde bulunmalıdır; salt sunucu modlarına oyuncuların ihtiyacı yoktur, salt istemci modları ise dedicated sunucuya ait değildir.
5. Sunucuyu yeniden başlat.

Modlarda sürüm eşitliği özellikle önemlidir. Sunucu, oyuncu istemcisi, mod loader'ı ve mod dosyaları birbirine uymalıdır. Bir oyuncu bağlanırken mod listesi veya registry hata mesajı görüyorsa çoğunlukla istemcide bir mod eksiktir, başka bir sürümde kuruludur ya da istemci yanlış loader'ı kullanıyordur.

Yeni modları adım adım kur. Sunucuyu birkaç değişiklikten sonra başlat ve konsolu kontrol et. Böylece çakışmaları daha hızlı bulursun; 30 yeni dosyadan sonra hangi modun başlamayı engellediğini artık bilememekten kurtulursun. Mod loader'larla daha sık çalışıyorsan benzer akışlar diğer oyunlarda da işine yarar; örneğin Valheim Mods mit BepInEx installieren rehberinde veya V Rising Mods mit BepInEx yazısında.

Sonucu kontrol etme

Yeniden başlatmadan sonra konsol ilk kontrol noktandır. ERROR, WARN, Could not load, Missing dependency gibi mesajları veya sürüm uyarılarını ara. Her uyarı kritik değildir, ancak başlatma iptallerini, devre dışı kalan plugin'leri ve eksik sınıfları düzeltmen gerekir.

Oyunda ardından somut işlevleri kontrol edersin: Dünya doğru yükleniyor mu? Oyuncular katılabiliyor mu? Yeni komutlar çalışıyor mu? Yeni bloklar, eşyalar veya menüler görünüyor mu? Plugin'lerde ek olarak yetkileri ve grupları test edersin. Modlarda en az bir oyuncu tamamen aynı mod paketiyle bağlanmalıdır.

Sık görülen hatalarda sorun giderme

Plugin yüklenmiyor: Minecraft sürümünü ve plugin'in Paper/Spigot için uygun olup olmadığını kontrol et. Bir Forge modu, her iki dosya da JAR olarak bulunsa bile Paper plugin'i olarak çalışmaz.

Sunucu başlamıyor: Konsolda hata mesajlarını kontrol et. Çoğunlukla bağımlılıklar eksiktir, bir dosya başka bir Minecraft sürümü için derlenmiştir ya da iki eklenti aynı işlevi geçersiz kılıyordur.

Mod çakışması: Çakışmayı bulmak için modları tek tek veya küçük gruplar halinde kaldır. En son kurulan dosyalarla başla ve her değişiklikten sonra yeniden başlat.

Oyuncular bağlanamıyor: Sunucu ile istemci arasında mod loader'ı, Minecraft sürümünü ve mod dosyalarını karşılaştır. Forge, NeoForge ve Fabric'te istemci tarafı çoğunlukla aynı modları ve aynı loader'ı kullanmalıdır.

Kurulumdan sonra lag: spark kuruluysa /spark profiler start komutunu, birkaç dakikalık oyundan sonra da /spark profiler stop komutunu kullanarak bir plugin'in veya modun dikkat çekici derecede çok zaman tüketip tüketmediğini kontrol et. İhtiyacın olmayan eklentileri devre dışı bırak ve gerçekçi oyuncu eylemleriyle yeniden test et.

Logda java.lang.NoClassDefFoundError yazıyorsa

java.lang.NoClassDefFoundError: some/Mod/Class

İki noktadan sonraki yol her hatada farklıdır; eksik olan sınıfı belirtir. Mesaj şu anlama gelir: Bir mod başka bir dosyadaki kodu kullanmak istedi ve Java onu başlangıçta bulamadı. Aynı bulguyla yakından ilişkili olan java.lang.ClassNotFoundException hatasıdır.

Arkasında neredeyse her zaman şu nedenlerden biri vardır:

1. Bir bağımlılık eksik. Birçok mod bir kütüphane modu gerektirir, örneğin bir API veya library modu. Modrinth ve CurseForge'da bu, mod sayfasında „Dependencies“ ya da „Bağımlılıklar“ altında yer alır.
2. Mod başka bir sürüm için derlenmiş. Minecraft 1.20.1 için hazırlanmış bir dosya, 1.21'de sınıflarını artık bulamaz. Mod ile bağımlılık farklı sürüm seviyelerinden geliyorsa da aynısı olur.
3. Yanlış loader. NeoForge sunucusundaki bir Fabric modu ya da 1.20.2'den itibaren NeoForge üzerindeki bir Forge dosyası çoğu zaman tam da bu mesajla başarısız olur.
4. Sunucuda bir istemci modu var. Grafik, menü veya minimap modları yalnızca oyun istemcisinde bulunan sınıflara erişir. Sunucuda bunlar yoktur.

Sorunlu modu bulma

1. latest.log dosyasını veya crash raporunu aç ve mesajın hemen üstündeki ve altındaki satırları oku. Çoğunlukla orada yüklenmesi gereken modun adı yazar.
2. Sınıf yolu tek başına duruyorsa başlangıcı çoğu zaman projeyi ele verir. Örneğin dev/architectury/… şeklindeyse sınıf Architectury API'ye aittir.
3. Eksik bağımlılığı Minecraft sürümüne ve loader'a uyan sürümde kur ya da etkilenen modu uygun dosyayla değiştir.
4. Mod bir istemci mod paketinden geliyorsa onu /mods içinden kaldır. Mod paketlerinde mümkünse resmi sunucu paketini kullan; orada salt istemci modları zaten ayıklanmıştır.
5. Yeniden başlat ve mesajın gidip gitmediğini kontrol et. Ardından yeni bir sınıf görünüyorsa bir bağımlılık daha eksiktir.

Logun tamamını Minecraft Crash-Report-Analyzer aracımıza da yapıştırabilirsin. İlgili satırı işaretler.

FAQ

Paper plugin'lerini ve Forge modlarını aynı anda kullanabilir miyim?

Normal bir standart kurulumda hayır. Paper/Spigot plugin'leri ile Forge/NeoForge/Fabric modları farklı sunucu ekosistemlerine aittir; PaperMC ekibi bu konuda açıktır: ya modlar ya plugin'ler. Mohist veya Arclight gibi hibrit sunucular ikisini de vaat eder, ancak kararsız kabul edilir ve Paper ile plugin geliştiricileri tarafından desteklenmez. Hedefine uyan platformu seç.

Oyuncuların plugin kurması gerekir mi?

Klasik Paper veya Spigot plugin'lerinde normalde hayır. Oyuncular normal bir Minecraft istemcisiyle bağlanır. İstisnalar, bir plugin'in isteğe bağlı kullandığı istemci tarafı ek işlevler veya resource pack'ler olabilir.

Sunucum bir moddan sonra neden artık başlamıyor?

Çoğunlukla bir sürüm uymuyordur, bir bağımlılık eksiktir ya da iki mod uyumsuzdur. Konsoldaki ilk ilgili hata mesajını oku ve deneme amacıyla en son kurulan modu kaldır.

JAR dosyaları nereye konur?

Plugin'ler /plugins içine, modlar /mods içine konur. Doğru klasör yalnızca dosya türüne değil, sunucu yazılımına bağlıdır: Paper/Spigot plugin'leri, Forge/NeoForge/Fabric ise modları kullanır. Paper'da JAR doğrudan /plugins içinde olmalıdır – alt klasörler taranmaz.

Birçok eklentiyi aynı anda kurmalı mıyım?

Hayır. Onları küçük adımlarla kur ve her yeniden başlatmadan sonra test et. Bu, hataları izlenebilir kılar ve çakışma durumunda tüm dosyaları aynı anda kontrol etmek zorunda kalmanı önler.