Paper sunucusuna eklenti kur

Wispdock kontrol paneli henüz hazır değil. Bir adımda “kontrol panelinde” yazıyorsa, sağlayıcının dosyalar, konsol ve başlat/durdur için sunduğu araçları kullan. Minecraft tarafı her yerde aynı çalışır.

Eklenti sunucusu planlarken sürüm ve bağımlılık listesini sakla; kurulumdan önce uyumluluğu bu listeyle kontrol edebilirsin.

Bu rehber sunucunun zaten Paper çalıştırdığını varsayıyor. Eklentiler Spigot ve Purpur’da da yüklenir, adımlar orada da aynı. Vanilla, Fabric ya da Forge kullanıyorsan eklentiler hiç yüklenmez; neyin nerede çalıştığını sunucu yazılımı seçme rehberinde anlattık.

Eklenti sunucuna uyuyor mu, kontrol et

Bir şey indirmeden önce eklenti sayfasında üç şeye bak.

• Minecraft sürümü. Eklenti sayfaları hangi sürümleri desteklediklerini yazar. En son 1.16 için güncellenmiş bir eklenti 1.21’de çalışabilir de, çalışmayabilir de. Paketlere, dünya üretimine ya da NMS’e (sunucunun iç koduna) dokunan eklentilerde genelde çalışmaz.
• Platform. Bukkit ve Spigot eklentileri Paper’da çalışır. Bazı yeni eklentiler yalnızca Paper içindir, Spigot’ta açılmaz. Velocity ve BungeeCord eklentileri proxy içindir; Paper sunucusunun plugins klasöründe hiçbir şey yapmazlar.
• Java sürümü. Minecraft 1.20.5 ve sonrası Java 21 ister, güncel eklentilerin çoğu da onunla derlenir. Sunucunun çalıştırdığından daha yeni bir Java için derlenmiş eklenti logda UnsupportedClassVersionError ile düşer.

Hangi Minecraft sürümünde ve hangi Paper build’inde olduğundan emin değilsen konsolda /version yaz.

Güvenilir bir yerden indir

Eklentileri geliştiricilerin yayınladığı yerlerden al:

• Hangar (hangar.papermc.io), PaperMC’nin kendi eklenti sitesi.
• Modrinth. Eklentileri modlarla birlikte listeler; yanlışlıkla Fabric modu indirmemek için Paper ya da Bukkit filtresini aç.
• SpigotMC’nin resources bölümü.
• Geliştiricinin GitHub releases sayfası. Çoğu eklenti oraya link verir.

Kopya yükleyen ve “bedava premium eklenti” dağıtan sitelerden uzak dur. Eklenti, sunucuyla aynı erişime sahip çalışır; kurcalanmış bir jar dosyalarını okuyabilir, birine op verebilir, sunucunu bir botnet’e bağlayabilir. Eklenti paralıysa geliştiricisinden satın al.

Lazım olan .jar dosyası. İndirdiğin şey .zip ise önce kendi bilgisayarında aç ve içine bak. Bazı geliştiriciler farklı platformlar için birkaç jar’ı tek arşivde verir, Paper’a ait olan yalnızca biridir.

Eklentilere yeni başlıyorsan ve neye ihtiyacın olduğunu bilmiyorsan, en iyi Minecraft sunucu eklentileri rehberi bilinen eklentileri işlerine göre ayırıyor.

Sunucuyu durdur ve jar dosyasını yükle

1. Önemsediğin bir dünya varsa önce yedek al. Yeni bir eklenti dünyayı nadiren bozar, ama koruma ve dünya düzenleme eklentileri çok şeyi hızlıca değiştirebilir. Nasıl yapılacağı yedekleme rehberinde.

2. Sunucuyu kontrol panelinden durdur.

3. Dosya yöneticisini aç ya da SFTP ile bağlan, server.properties dosyasının yanındaki plugins klasörüne gir ve .jar dosyasını yükle. Jar doğrudan plugins içine gider, bir alt klasöre değil.

plugins klasörünü Paper ilk açılışta oluşturur. Klasör yoksa sunucu hiç çalışmamıştır ya da Paper çalıştırmıyordur.

Sunucuyu başlat ve yüklendiğini kontrol et

Sunucuyu başlat ve konsolu izle. Her eklenti yüklenirken bir satır, etkinleşirken bir satır daha yazar. Sonra şunu çalıştır:

plugins

Bu konsol hali. Oyunda /plugins ya da /pl yazarsın. Yeşil adlar çalışıyor. Kırmızı ad, eklentinin yüklendiğini ama etkinleşemediğini gösterir. Eklenti listede hiç yoksa Paper jar dosyasını hiç yükleyememiştir.

İki durumda da nedeni logs/latest.log içinde. Eklentinin adını arat ve ondan sonraki ilk hatayı oku. En sık çıkanlar:

Çoğu eklenti ilk açılışta plugins/LuckPerms ya da plugins/Essentials gibi kendi klasörünü de oluşturur. Eklenti ayarlarını, çoğu zaman da verilerini orada tutar.

Ayarlarını yap

Ayarlar genelde eklentinin klasöründeki config.yml dosyasında durur. Bazı eklentiler ayarları birkaç dosyaya böler, bazıları mesajları ayrı bir messages.yml ya da dil dosyasında tutar.

Bunlar YAML dosyaları ve YAML titizdir:

• Girintiyi boşlukla yap, asla tab kullanma.
• Düzenlediğin satırın girintisini koru. Bir anahtarı bir boşluk sola kaydırırsan başka bir bölüme geçer.
• İki nokta üst üste içeren ya da özel bir karakterle başlayan metni tırnak içine al.

Bozuk bir YAML dosyası yüzünden eklenti genelde varsayılan ayarlara döner ya da hiç açılmaz; logda da satırı gösteren bir ayrıştırma hatası çıkar. Düzenledikten sonra eklentinin belgelerinde bir yeniden yükleme komutu varsa onu kullan (çoğu /<eklenti> reload kalıbındadır), yoksa sunucuyu yeniden başlat.

Komut ekleyen eklentiler bu komutları genelde yetki adlarıyla (permission node) kilitler. Op’lar çoğunu varsayılan olarak alır. Op olmayan oyunculara bir komut vermek için bir yetki eklentisi kullan; LuckPerms ile nasıl yapılacağı beyaz liste, op ve yetkiler rehberinde.

Neden /reload kullanmamalısın

/reload çalışan sunucunun içinde bütün eklentileri kapatır, bellekten atar ve yeniden yükler. Çoğu eklenti bu sırada arkasını toplamaz: zamanlanmış görevler iki kez çalışmaya devam eder, veritabanı bağlantıları açık kalır, dinleyiciler bir kez daha kaydedilir. Sonuç bellek sızıntısı ve bir sonraki yeniden başlatmaya kadar yarım çalışan eklentiler. Paper bunu yapmadan önce uyarı verip onay ister; o uyarıyı ciddiye al.

Onun yerine sunucuyu yeniden başlat. Birkaç saniye daha uzun sürer ama her şeyin ne durumda olduğunu bilirsin.

Tek tek eklenti yükleyip kaldıran eklenti yöneticilerinde de aynı sorun daha küçük ölçekte var. İstersen sunucunun bir kopyasında hızlı test için kullan, arkadaşlarının oynadığı dünyada değil.

Bağımlılıklar

Bazı eklentiler çalışmak için başka bir eklentiye ihtiyaç duyar. En yaygınları Vault, ProtocolLib ve PlaceholderAPI. Eklenti sayfası neye ihtiyaç duyduğunu genelde “dependencies” ya da “requirements” başlığında yazar.

İki türü var. Zorunlu bağımlılık kurulu değilse eklenti yüklenmez ve logda eksik eklentinin adıyla UnknownDependencyException görürsün. İsteğe bağlı (soft) bağımlılıkta eklenti onsuz da yüklenir, varsa ek özellikleri açar. Bağımlılıkları da diğer eklentiler gibi kur ve onların sürümünü de Minecraft sürümüne göre seç.

Vault tek başına pek bir şey yapmaz. O bir köprü; bağlanacak bir şey olsun diye EssentialsX’in ekonomisi gibi bir ekonomi eklentisinin de kurulu olması gerekir.

Eklenti güncellemek

1. Değişiklik notlarını oku. Büyük sürümler bazen config biçimini değiştirir ya da özellik kaldırır. Bazı eklentiler config’i açılışta kendisi taşır, bazıları sıfırdan başlamanı ister.

2. Eklentinin veri klasörünü ya da bütün sunucuyu yedekle.

3. Sunucuyu durdur, eski jar dosyasını sil ve yenisini yükle. plugins içinde aynı eklentinin iki sürümü olursa “Ambiguous plugin name” hatası alırsın ve yalnızca biri yüklenir; her zaman istediğin değil.

4. Sunucuyu başlat, /plugins ve logu yine kontrol et.

Bir de güncelleme klasörü var. Yeni jar dosyasını eskisiyle birebir aynı adla plugins/update klasörüne koyarsan sunucu bir sonraki açılışta eskisinin yerine onu koyar. Sunucuyu hemen durduramadığında işe yarar, ama jar adlarını eşleştirirken hata yapmak kolay.

Eklenti dertlerinin çoğu Minecraft’ın kendisini güncellerken başlar. Sürümü değiştirmeden önce her eklentinin yeni sürümü desteklediğini kontrol et; her şey sorunsuz yüklenene kadar eski sunucu jar’ını ve yedeği sakla.

Eklenti kaldırmak

Sunucuyu durdur ve eklentinin jar dosyasını sil. plugins içindeki klasörü yerinde kalır ve tek başına hiçbir şey yapmaz. Eklentiyi ileride tekrar kurabilirsen bırak. Temiz bir başlangıç istiyorsan sil, ama önce bak: bazı eklentiler veritabanını orada tutar, LuckPerms de varsayılan olarak öyle yapar. Klasörü silersen veriler de gider.

Eklentinin vanilla yollarla eklediği bloklar ve eşyalar dünyada kalır. Yalnızca eklenti sayesinde var olan şeyler, yani korumalı bölgeler, ev noktaları ya da eklentinin yönettiği market tabelaları, eklenti gidince çalışmaz.

Wispdock’un taslak 4 GB paketi vanilla ve eklentili sunucular için düşünüldü. Ayrıntılar fiyatlar sayfasında; fiyatlar taslak ve sipariş henüz açık değil.

Hâlâ çözemedin mi? Ayrıntıları ve latest.log dosyanı bize gönder.