Modlar ve eklentiler Minecraft sunucunu genişletir, ancak aynı şekilde çalışmazlar: Eklentiler Paper veya Spigot için tasarlanmıştır ve çoğu zaman istemci kurulumu olmadan çalışır; modlar ise Forge veya Fabric ile genellikle hem sunucuda hem de oyuncuların bilgisayarlarında aynı şekilde bulunmalıdır. 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.

Eklentiler veya Modlar: doğru temeli seç

Dosyaları yüklemeden önce hangi hedefi izlediğini belirle. Yetkiler, home noktaları, koruma bölgeleri, ekonomi, moderasyon veya yönetici araçları eklemek istiyorsan Paper/Spigot eklentileri çoğu zaman uygun yoldur. Yeni bloklar, biyomlar, teknik sistemler, moblar veya daha derin oyun mekanikleri eklemek istiyorsan genellikle Forge ya da Fabric modlarına ihtiyacın olur.

Özellik Eklentiler (Paper/Spigot) Modlar (Forge/Fabric)
Kurulum Basit: JAR /plugins içine JAR /mods içine
İstemci gerekli mi? Hayır Evet, aynı modlar gerekli
Performans Daha iyi Değişken
Uyumluluk Yüksek Çakışabilir
Örnekler EssentialsX, WorldEdit OptiFine, Biomes O Plenty

Resmi Paper dokümantasyonu Paper’ı Minecraft: Java Edition için bir sunucu yazılımı olarak tanımlar ve eklentiler için diğer kaynakların yanında PaperMC ekosistemine yönlendirir. Bu yüzden Paper eklentileri için doğal bir birincil kaynak PaperMC Hangar olur. Ek eklenti yönetimi için ayrıntılı dahili rehber Panelde Minecraft eklentilerini kurma ve yönetme de uygundur.

Kurulumdan önce gerekenler

Önce sunucunda kurulu Minecraft sürümünü kontrol et. Bir eklenti veya mod bu sürüme ve seçilen sunucu yazılımına uygun olmalıdır. Başka bir major sürüm için hazırlanmış bir dosya bazen başlatılabilir, ancak stabil kabul edilmemelidir.

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

Bağımlılıklara da dikkat et. Bazı eklentiler ek library’lere veya Vault gibi temel eklentilere ihtiyaç duyar. Bazı modlar Fabric API, Cloth Config veya başka mod library’leri gerektirir. Bu bilgiler normalde ilgili genişletmenin proje sayfasında yer alır.

Paper veya Spigot ile eklenti kurma

  1. Eklentiyi Hangar veya Modrinth üzerinden indir.
  2. game-serverhosting üzerindeki sunucu paneline git.
  3. Mods & Plugins sekmesine geç.
  4. İstediğin eklentiyi ara ve panelde mevcutsa Installieren seçeneğine tıkla.
  5. Sunucuyu yeniden başlat.

Alternatif olarak JAR dosyasını manuel olarak /plugins klasörüne yükleyebilirsin. Yeniden başlatmadan sonra eklenti çoğu zaman kendi alt klasöründe otomatik olarak bir yapılandırma dosyası oluşturur. Bu dosyayı ancak sunucu eklentiyle bir kez başlatıldıktan sonra aç; aksi halde standart değerler çoğu zaman eksik olur.

Yeni başlayanlar için önerilen eklentiler tipik temel araçlar olmaya devam eder, ancak yalnızca gerçekten ihtiyacın olanları kur:

EssentialsX     – Temel işlevler (Home, Warp, Kits)
LuckPerms       – Yetki sistemi
WorldGuard      – Bölge koruması
Vault           – Ekonomi sistemi
CoreProtect     – Blok kayıtları / Anti-Grief

Kurulumdan sonra yalnızca sunucunun başlayıp başlamadığını test etme. Oyunda en az bir eklenti komutunu, yetki atamasını ve konsol çıktısını kontrol et. Bir eklenti yükleniyor ama komutlar engelleniyorsa sorun çoğu zaman permissions veya eksik bağımlılıklardadır.

Forge veya Fabric ile mod kurma

  1. Sunucunun Forge veya Fabric ile çalıştığından emin ol.
  2. Modu Modrinth veya CurseForge üzerinden indir.
  3. JAR dosyasını /mods klasörüne yükle.
  4. Önemli: Tüm oyuncularda aynı modlar kurulu olmalı.
  5. Sunucuyu yeniden başlat.

Modlarda sürüm eşitliği özellikle önemlidir. Sunucu, oyuncu istemcisi, modloader ve mod dosyaları birbiriyle uyumlu olmalıdır. Bir oyuncu bağlanırken mod listesi veya registry hata mesajı görüyorsa çoğu zaman istemcide bir mod eksiktir, farklı bir sürüm kuruludur ya da istemci yanlış loader kullanıyordur.

Yeni modları adım adım kur. Birkaç değişiklikten sonra sunucuyu başlat ve konsolu kontrol et. Böylece 30 yeni dosyadan sonra hangi modun başlatmayı engellediğini bilememek yerine çakışmaları daha hızlı bulursun. Modloader’larla daha sık çalışıyorsan benzer süreçler diğer oyunlarda da işine yarar, örneğin Valheim modlarını BepInEx ile kurma rehberinde veya V Rising modlarını BepInEx ile kurma konusunda.

Sonucu kontrol et

Yeniden başlatmadan sonra ilk kontrol noktan konsoldur. ERROR, WARN, Could not load, Missing dependency veya sürüm uyarıları gibi mesajları ara. Her uyarı kritik değildir, ancak başlatma kesintilerini, devre dışı bırakılan eklentileri ve eksik class’ları çözmen gerekir.

Ardından oyunda somut işlevleri kontrol et: Dünya doğru yükleniyor mu? Oyuncular join olabiliyor mu? Yeni komutlar çalışıyor mu? Yeni bloklar, item’lar veya menüler görüntüleniyor mu? Eklentilerde ayrıca yetkileri ve grupları test et. Modlarda en az bir oyuncu tamamen aynı modpack ile bağlanmalıdır.

Sık görülen hatalarda troubleshooting

Eklenti yüklenmiyor: Minecraft sürümünü ve eklentinin Paper/Spigot için uygun olup olmadığını kontrol et. İki dosya da JAR olsa bile bir Forge modu Paper eklentisi olarak çalışmaz.

Sunucu başlamıyor: Konsoldaki hata mesajlarını kontrol et. Sıklıkla dependencies eksiktir, bir dosya başka bir Minecraft sürümü için hazırlanmıştır veya iki genişletme aynı işlevin üzerine yazar.

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 ve istemci arasında modloader, Minecraft sürümü ve mod dosyalarını karşılaştır. Forge/Fabric’te istemci tarafı çoğu zaman aynı modları kullanmalıdır.

Kurulumdan sonra lag: Spark kuruluysa bir eklenti veya modun dikkat çekecek kadar fazla zaman harcayıp harcamadığını kontrol etmek için /spark profiler kullan. İhtiyacın olmayan genişletmeleri devre dışı bırak ve gerçekçi oyuncu aksiyonlarıyla tekrar test et.

Kontrol, sınırlar ve güvenli geri dönüş

“Minecraft Modları ve Eklentileri Kurma – Basit Rehber” rehberi, makalede açıklanan sunucu türü ve kontrol anında görünen sürüm durumu için geçerlidir. Menü adları, mevcut sürümler, mod veya eklenti uyumluluğu ve gerekli kaynaklar güncellemelerden sonra farklılık gösterebilir. Bu nedenle hiçbir değeri kontrol etmeden başka bir oyun, loader veya sunucu sürümüne aktarma.

Dünya, kayıt, yapılandırma veya genişletmeler üzerinde değişiklik yapmadan önce etkilenen dosyaların bir yedeğini oluştur. Ardından yalnızca birbiriyle ilişkili tek bir adımı değiştir ve bunu daha sonra oynamak istediğin aynı istemci ve sunucu sürümüyle kontrol et.

Kontrol noktası Beklenen sonuç İptal ve geri dönüş
Sunucu başlangıcı Sunucu yeni hata mesajı olmadan çalışmaya hazır duruma ulaşır. Başlatma hatalarında değişikliği geri al ve son yedeği geri yükle.
Bağlantı testi Bir test hesabı panelde gösterilen adres üzerinden bağlanabilir. Sürüm veya bağlantı hatalarında sürüm, port ve izinleri yeniden karşılaştır.
İşlev testi Somut olarak değiştirilen işlev, mevcut dünya veya oyun verilerine zarar vermeden çalışır. Yan etkilerde sunucuyu durdur ve yedeklenmiş dosyaları geri yükle.

Başarılı bir tekil test performans veya erişilebilirlik garantisi değildir. Dünya boyutu, modlar, eklentiler, oyuncu sayısı, ağ yolu ve eşzamanlı yük sonucu değiştirebilir. Sürümü, değişikliği ve test sonucunu belgeleyerek sonraki sapmaları takip edebilirsin.

FAQ

Paper eklentilerini ve Forge modlarını aynı anda kullanabilir miyim?

Normal bir standart kurulumda hayır. Paper/Spigot eklentileri ve Forge/Fabric modları farklı sunucu ekosistemlerine aittir. Hedefine uygun platformu seç.

Oyuncuların eklenti kurması gerekir mi?

Klasik Paper veya Spigot eklentilerinde normalde gerekmez. Oyuncular normal bir Minecraft istemcisiyle bağlanır. İstisnalar, bir eklentinin opsiyonel olarak kullandığı istemci tarafı ek işlevler veya resourcepack’ler olabilir.

Bir moddan sonra sunucum neden artık başlamıyor?

Çoğu zaman bir sürüm uymaz, bir bağımlılık eksiktir veya iki mod uyumsuzdur. Konsoldaki ilk ilgili hata mesajını oku ve test için en son kurduğun modu kaldır.

JAR dosyaları nereye konur?

Eklentiler /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 eklentileri kullanır, Forge/Fabric modları kullanır.

Birden fazla genişletmeyi aynı anda kurmalı mıyım?

Hayır. Küçük adımlarla kur ve her yeniden başlatmadan sonra test et. Bu, hataları anlaşılır kılar ve çakışmalarda tüm dosyaları aynı anda kontrol etmek zorunda kalmanı engeller.