Bu yazı, eklenti mağazasının panelde nasıl kullanıldığını adım adım anlatır.

Mağazayı aç

Sol menüden Eklentiler bölümüne gir. Bu bölüm yalnız eklenti ailesinden bir yazılım (Paper, Purpur, Spigot, CraftBukkit) kuruluysa çalışır. Mod yükleyicilerinde (Fabric, Quilt, Forge, NeoForge) aynı satır Modlar adını alır ve mod mağazasını açar; Vanilla'da satır soluk görünür ve tıklanmaz, üzerine geldiğinde Yazılım bölümünden Paper'a geçmen önerilir. Hangi yazılımın sana uyduğuna yazılım karşılaştırmasından karar verebilirsin.

Panelin Eklentiler bölümündeki mağaza: arama kutusu, kaynak ve sıralama seçimi, eklenti kartları ve Kur düğmeleri

Örnek bir sunucuda eklenti mağazası. Kurulu eklentiler kartında işaretlenir; Kurulu sekmesi sunucundaki eklentileri listeler.

Ara ve süz

Mağaza üç kaynaktan beslenir: SpigotMC, Modrinth ve PaperMC Hangar. Arama hepsinde birden değil, kaynak kutusundan seçtiğin tek kaynakta çalışır; kutu SpigotMC ile açılır. Hangar deposu Paper merkezli olduğu için yalnız Paper ve Purpur'da listelenir. Sonuçları en çok indirilen, en yeni ya da son güncellenen olarak sıralayabilirsin; arama kutusu boşken en çok indirilenler gelir.

Her sonuçta desteklenen sürüm aralığı rozet olarak yazar. Sunucunun sürümüyle uyuşmayan içerikte uyumsuzluk rozeti çıkar ve Kur düğmesi kapalı gelir — mağazadan kazara yanlış sürümü kuramazsın. Sonuçlar sayfa sayfa gelir; altındaki numara ve oklarla gezinirsin.

Sonuç kartında ne yazar?

Her sonuç bir kart olarak gelir. Kartta eklentinin simgesi, adı, indirme sayısı, iki satırlık açıklaması, desteklenen sürüm aralığı ve içeriğin geldiği kaynak (SpigotMC, Modrinth ya da Hangar) yazar. Sürüm aralığı sunucunu kapsıyorsa rozet yeşil görünür. Uyumsuz içerikte ayrıca bir uyarı rozeti çıkar: aralık biliniyorsa "1.21.4 ile uyumsuz" gibi sunucunun sürümünü anan bir uyarı, geliştirici hiç sürüm bilgisi yayınlamamışsa "Sürüm bilgisi yayınlanmamış — bu sunucuyla uyumu doğrulanamadı" yazar. İki durumda da Kur düğmesi kapalıdır.

Kartın kendisi tıklanmaz, ayrı bir ayrıntı sayfası da açılmaz. Eklentinin komutlarını, ayar dosyasını ve başka hangi eklentilere ihtiyaç duyduğunu öğrenmek için adını kartta yazan kaynakta aratıp oradaki sayfasını oku. Kurmadan önce yapılan bu kısa okuma, sonradan çıkacak sürprizlerin çoğunu önler.

Bir eklentiyi kurduğunda kartındaki düğme "Kurulu ✓" olur ve kapanır; aynı içeriği yanlışlıkla ikinci kez kuramazsın. Bu tanıma, kurulumu yaptığın kaynağa bağlıdır: kaynak kutusunu değiştirip aynı eklentiyi başka bir mağazada bulursan düğme yine Kur yazabilir. O zaman önce Kurulu sekmesine bak; iki kaynaktan gelen dosyaların adı farklıysa klasörde aynı eklentiden iki tane olur ve sunucu açılışta hata verir.

Kur

Kur'a bastığında panel senin yerine sürüm dosyasını çözer ve doğru klasöre indirir; inen dosyanın gerçekten bir jar olduğu sunucu makinesinde ayrıca doğrulanır. Değişikliğin etkili olması için sunucuyu bir kez yeniden başlatman gerekir, panel bunu üstte bir bant hâlinde hatırlatır.

Bazı eklentiler kendi sitesinden ya da bir kod deposundan dağıtılır. Panel dosyayı önce otomatik çözmeyi dener, sonra aynı eklentiyi diğer mağazalarda adıyla arar; o da tutmazsa jar'ı Dosyalar bölümünden elle yüklemeni ister.

Kurulu listesi ve devre dışı bırakma

Kurduğun her şey Kurulu sekmesinde dosya adı ve boyutuyla toplanır. Buradan bir eklentiyi silmeden geçici olarak devre dışı bırakabilir, sonra tekrar etkinleştirebilirsin; devre dışı olanların adı üstü çizili görünür. Cross-play köprüsü gibi sistemin kendi kurduğu eklentiler bu listede görünmez; onlar kendi anahtarından yönetilir.

Sorun ararken en çok işe yarayan yol budur: sunucu bir kurulumdan sonra bozulduysa, silmeden kapatıp etkisini test edersin. Aynı anda birden fazlasını kapatma — hangisinin sorumlu olduğunu anlayamazsın. Devre dışı bırakmak da, silmek de yeniden başlatma ister.

Örnek: altı kişilik bir survival sunucusuna ilk eklentiler

Paper kurulu, altı arkadaşın oynayacağı yeni bir survival sunucusu düşün. Hedef üç eklenti: yetkiler için LuckPerms, kimin neyi kırdığını kaydetmek için CoreProtect, ev ve doğma noktası komutları için EssentialsX. Mağazada şu sırayla ilerlersin:

  1. Eklentiler bölümünü aç. Kaynak kutusu SpigotMC'de gelir; arama kutusuna LuckPerms yaz. Benzer adlı eklentiler de çıkabilir, doğru kartı adından ve indirme sayısından tanı.
  2. Sürüm rozetinin yeşil olduğunu gör ve Kur'a bas. Düğme "Kurulu ✓" olur, üstte yeniden başlatma bandı belirir.
  3. Aynı yolla CoreProtect eklentisini kur. İki eklenti bir açılış için yeter: üst şeritteki Yeniden Başlat düğmesine bas.
  4. Konsol ekranında iki eklentinin adıyla başlayan ve Enabling kelimesini içeren açılış satırlarını bul. Kırmızı bir hata satırı yoksa ilk tur tamamdır.
  5. Şimdi EssentialsX'i ara; bir kaynakta bulamaz ya da Kur düğmesini kapalı görürsen kaynak kutusundan diğerini dene. EssentialsX modüllerden oluşur; ana eklentiyle birlikte kuracağın modüllerin aynı sürümden olmasına dikkat et, sonra yeniden başlat.
  6. Kurulu sekmesinde dosya adlarını ve boyutlarını kontrol et: her eklentiden yalnız bir dosya olmalı.

Bu düzende oyuncular yine standart Minecraft ile bağlanır, hiçbir şey indirmez. Ayarlara geçmeden önce yetki gruplarını kur. EssentialsX'in modüllerini ve ayarlarını EssentialsX kurulumu yazısında, bu üçlünün neden seçildiğini ve yanına neler eklenebileceğini survival sunucusu için eklenti seti yazısında bulursun.

Kaç eklenti kurabilirim?

Kapı kapatan bir sayı sınırı yoktur. Paketine göre önerilen bir sayı gösterilir; aşarsan panel yalnız performansın etkilenebileceğini hatırlatır ve kararı sana bırakır. Büyük paketlerde bu öneri hiç gösterilmez.

Sayının kendisi tek başına belirleyici değildir: kötü yazılmış tek bir eklenti, on hafif eklentiden fazla yük bindirebilir. Eklenti sayısı ve performans yazısında bunu ayrıca anlattık.

Kurulum olmuyorsa sırayla şuna bak

  1. Sürüm uyuşmuyor. "Sunucunun sürümüyle test edilmemiş" mesajı, eklentinin desteklediği aralığın sunucunun sürümünü kapsamadığını söyler. Mesajda test edilmiş aralık da yazar; ya güncel sürümü başka kaynakta ara ya da sunucunun sürümünü o aralığa çek.
  2. Kaynak ücretli. "Ücretli (premium) dağıtılıyor" diyorsa o dosyayı senin adına indiremeyiz; satın aldıysan jar'ı Dosyalar bölümünden yükle.
  3. Mağaza yanıt vermiyor. Bu uyarı, içeriği barındıran kaynak siteye ulaşılamadığında çıkar. Birkaç dakika sonra tekrar dene ya da kaynak kutusundan başka bir mağaza seç.
  4. Yer kalmamış. "Depolama alanı dolu" uyarısı sunucunun disk kotasının dolduğunu söyler. Eski dünya klasörlerini ve gereksiz dosyaları temizleyip tekrar dene.
  5. Arka arkaya çok deneme. Kısa sürede çok sayıda kurulum denersen panel seni bir süre bekletir; birkaç dakika ara ver.
  6. Kurulum başarılı ama eklenti yok. Önce yeniden başlattığından emin ol. Sonra Konsol ekranında eklentinin adını ara: açılış günlüğü, eksik bağımlılık ya da yanlış Java sürümü gibi sebepleri çoğu zaman tek satırda yazar.
  7. Sunucu derin uykuda. Uzun süre kapalı kalan sunucunun dosyaları arşive alınır; bu sırada panel "Bu sunucu şu an derin uykuda; eklenti işlemleri için önce sunucuyu başlat." der ve kurma, devre dışı bırakma ya da silme çalışmaz. Sunucuyu bir kez başlat, açıldıktan sonra tekrar dene. Durumlar arasındaki farkı uyku modu yazısında anlattık.

Sık yapılan hatalar

  • Yeniden başlatmadan sonuç beklemek. Kurulum, devre dışı bırakma ve silme ancak sunucu yeniden açıldığında geçerli olur.
  • Tek seferde beş eklenti kurmak. Sunucu açılmazsa hangisinin bozduğunu bulmak saat alır. İkişer kur, arada bir açılış yap.
  • Aynı eklentinin iki sürümünü klasörde bırakmak. Yeni sürümün dosya adı farklı olduğu için eskisi silinmez; Kurulu listesinden eski dosyayı kaldırmazsan sunucu açılışta hata verir. Mağazadan güncelleme böyle yapılır: Kurulu listesinden eski sürümü kaldır, sonra mağazadan yenisini kur — ayrı bir “Güncelle” düğmesi yoktur.
  • Mod ile eklentiyi karıştırmak. Mod jar'ı eklenti klasöründe çalışmaz; mod tarafı için mod ve modpack kurma yazısına bak.
  • Silince ayarların da gittiğini sanmak. Kaldırma yalnız jar dosyasını siler; ayar klasörü yerinde kalır, yani tekrar kurarsan eski ayarlarla açılır. Temiz başlangıç istiyorsan o klasörü Dosyalar bölümünden sen sil.

Hangi durumda ne seçmeli

  • Aradığını bulamıyorsan kaynağı değiştir. Varsayılan SpigotMC en geniş havuzdur; Modrinth sürüm bilgisini en düzenli veren kaynaktır; Hangar, Paper tarafında bakımı sürenleri taşır.
  • Mod mu, eklenti mi? Mod yükleyicileri yalnız 8 GB'tan itibaren açılır. 2 ve 4 GB paketlerde mod kuramazsın, eklenti kurarsın — istediğin özellik çoğu zaman eklenti olarak da vardır.
  • Telefon ve tabletten de girilecekse eklenti ailesinde kalmalısın: cross-play köprüsü eklenti olarak kurulur, Minecraft 1.20.5 veya üstü ve en az 4 GB ister.
  • Sunucu ağırlaştıysa silmeden önce ölç. Kurulu listesinden ikişer eklenti devre dışı bırakıp Genel Bakış'taki TPS göstergesini izle; suçluyu tahminle değil farkla bulursun.

Eklenti seçimi, yapılandırma dosyaları, izin yönetimi ve sık karşılaşılan sorunlar için tam eklenti rehberine geç.

Sık sorulan sorular

Kur düğmesine neden basamıyorum?

Üç sebepten biri vardır. Eklenti sunucunun sürümünü desteklemiyordur ya da geliştiricisi sürüm bilgisi yayınlamamıştır; ikisinde de kartta bunu söyleyen bir uyarı rozeti görürsün. Ya da eklenti zaten kuruludur ve düğmede "Kurulu ✓" yazar. İlk iki durumda başka bir kaynakta uyumlu sürüm ara; bulamazsan sürümü eklentinin kendi sayfasından kendin doğrulayıp jar dosyasını Dosyalar bölümünden yükleyebilirsin.

Kurduğum eklentinin hangi sürüm olduğunu nereden anlarım?

İlk ipucu Kurulu sekmesindeki dosya adıdır; geliştiricilerin çoğu sürüm numarasını dosya adına yazar. Kesin bilgi açılış günlüğündedir: sunucu açılırken her eklenti adını ve sürümünü Enabling satırında yazar. O anı kaçırdıysan aynı satırı Günlük bölümünde latest.log içinde aratabilirsin.

Elle yüklediğim jar da Kurulu sekmesinde görünür mü?

Evet. Kurulu sekmesi plugins klasörünün kendisindeki bütün jar dosyalarını gösterir, mağazadan gelip gelmediğine bakmaz; sekme adındaki sayı da bu toplamdır. Böylece elle yüklediğin bir eklentiyi de buradan devre dışı bırakıp silebilirsin. Devre dışı kalan dosyanın adının sonuna .disabled eklenir; alt klasörlere konan jar dosyaları ise listede görünmez, sunucu da onları yüklemez.

Mağazadan kurduğum eklentiler kendiliğinden güncellenir mi?

Hayır. Kurduğun dosya, sen değiştirene kadar aynı sürümde kalır; panel arka planda sürüm değiştirmez, böylece bir güncelleme sunucunu habersizce bozamaz. Yeni sürüme geçmek istediğinde önce Yedekler bölümünden bir yedek al, sonra Kurulu sekmesinden eski dosyayı kaldırıp mağazadan yenisini kur ve yeniden başlat.

Oyuncular oyundayken eklenti kurabilir miyim?

Evet. Kurulum dosyayı yalnız klasöre koyar; çalışan oyunu etkilemez, eklenti bir sonraki açılışta devreye girer. Kurduktan sonra oyuncuları Konsol'dan say komutuyla uyar, örneğin say Sunucu birazdan yeniden başlıyor, ve uygun bir anda Yeniden Başlat'a bas.