Eklentiler, sunucuna koruma, ekonomi, mini oyun ve yönetim özellikleri katmanın en kolay yoludur. En büyük avantajı şudur: eklenti yalnız sunucuda çalışır, oyuncuların hiçbir şey kurması gerekmez — herkes standart Minecraft ile bağlanır.

Eklenti mi, mod mu?

Karar tek soruya iner: oyunun kurallarını mı değiştirmek istiyorsun, sunucuya yetenek mi eklemek istiyorsun? Yeni blok, boyut ve makine istiyorsan mod gerekir ve herkes onu kurmalıdır. Koruma bölgesi, ekonomi, sıralama tablosu, oyuncu yönetimi istiyorsan eklenti yeter. Mod tarafı için mod ve modpack rehberine bakabilirsin.

Eklenti kullanabilmek için sunucu yazılımının eklenti ailesinden olması gerekir: Paper, Purpur, Spigot veya CraftBukkit. Vanilla eklenti kabul etmez; mod yükleyicileri de kabul etmez.

1) Mağazadan tek tıkla kurulum

Sunucu panelinde sol menüden Eklentiler bölümüne gir. Arama, kaynak kutusundan seçtiğin TEK kaynakta koşar: SpigotMC, Modrinth ya da PaperMC Hangar — aradığını bulamazsan kaynağı değiştirip tekrar ara. Sonuçları en çok indirilen, en yeni ya da son güncellenen olarak sıralayabilirsin.

Her sonuçta sürüm uyumluluğu otomatik kontrol edilir; uyumsuz içerik listede açıkça işaretlenir ve Kur düğmesi kapalı gelir. Uyumlu bir sürüm bulunduğunda tek tıkla kurulur. Böylece yanlış sürümü yükleyip sunucuyu çökertme riskin belirgin biçimde azalır.

Kurulan eklentiler Kurulu listesinde toplanır. Buradan bir eklentiyi silmeden geçici olarak devre dışı bırakabilir, sonra tekrar etkinleştirebilirsin — sorun ararken en çok işe yarayan özellik budur. Değişikliklerin etkili olması için sunucuyu bir kez yeniden başlat.

2) Kendi .jar dosyanı yükleme

Mağazada bulunmayan ya da harici bir siteden dağıtılan bir eklenti için Dosyalar bölümüne gidip plugins klasörüne .jar dosyasını yükle. Yükledikten sonra sunucuyu yeniden başlat; eklenti ilk açılışta kendi yapılandırma klasörünü oluşturur.

Elle yüklemede sürüm kontrolü sende olur — indirdiğin dosyanın hem Minecraft sürümüne hem sunucu yazılımına uygun olduğundan emin ol.

Sürüm uyumluluğu — en sık yapılan hata

Bir eklentinin çalışması için hem Minecraft sürümüne hem de sunucu yazılımına uygun olması gerekir. Yanlış sürüm yüklersen sunucu açılışta o eklentiyi devre dışı bırakır ve konsola bir hata satırı yazar.

Konsolun ilk otuz satırı bu tür sorunların çoğunu ele verir: hangi eklentinin yüklenemediği, hangi sürümü beklediği orada yazar. Bir eklenti kurduktan sonra ilk açılışı konsoldan izlemek iyi bir alışkanlıktır.

Bağımlılıklar: başka eklentiye ihtiyaç duyan eklentiler

Bazı eklentiler tek başına açılmaz; işlerinin bir kısmını başka bir eklentiye bırakır. Buna bağımlılık denir. Zorunlu bir bağımlılık eksikse sunucu o eklentiyi hiç yüklemez ve konsola UnknownDependencyException içeren bir hata yazar; aynı hatada eksik eklentinin adı da geçer. İsteğe bağlı bir bağımlılık eksikse eklenti açılır, yalnız ona bağlı özelliği çalışmaz.

En sık rastlananlar şunlardır: ekonomi ve yetki bilgisini eklentiler arasında taşıyan Vault, WorldGuard'ın bölge seçmek için kullandığı WorldEdit, oyun paketleri düzeyinde çalışan eklentilerin istediği ProtocolLib ve başka eklentilerin bilgilerini mesajlara yerleştiren PlaceholderAPI. Hangisinin gerektiği eklentinin sayfasında yazar. Panelin mağazası bir eklentiyi kurarken bağımlılıklarını kendiliğinden kurmaz; onları ayrıca arayıp kurman gerekir. Bağımlılığı ve asıl eklentiyi aynı turda kurup tek bir yeniden başlatma yapabilirsin; sunucu açılışta önce bağımlılığı yükler.

Yapılandırma dosyaları

Çoğu eklenti ayarlarını plugins/EklentiAdi/config.yml altında tutar. Bu dosyaları panelin dosya yöneticisinden düzenleyebilirsin. YAML biçiminde girinti anlamlıdır: bir boşluk fazlası ya da eksiği dosyayı geçersiz kılar ve eklenti açılmaz.

Düzenlemeden önce dosyanın bir kopyasını almak, hatalı bir değişikliği saniyeler içinde geri almanı sağlar. Değişiklikten sonra sunucuyu yeniden başlat ya da eklentinin varsa kendi yeniden yükleme komutunu kullan.

Sık düzenlenen dosyalar için dosya yöneticisindeki aramayı kullan; klasörler arasında dolaşmaktan hızlıdır.

İzinler (permissions)

Birden fazla kişinin yönettiği bir sunucuda, hangi oyuncunun hangi komutu çalıştırabileceğini kontrol etmen gerekir. Bunun için bir izin yönetim eklentisi kurulur; gruplar tanımlar (oyuncu, moderatör, yönetici) ve komut yetkilerini gruplara verirsin.

İzin yönetimi olmadan tek seçeneğin herkesi yönetici yapmak ya da hiç kimseye yetki vermemektir; büyüyen bir toplulukta ikisi de sürdürülebilir değildir.

Küçük ve tanıdık bir grupta izin eklentisine gerek kalmayabilir: panelin Oyuncular bölümünden birkaç kişiyi operatör yapmak yeterli olur.

Yeni bir sunucuda genelde ilk kurulan eklenti türleri

  • Arazi/bölge koruma — oyuncuların yapılarını başkalarının bozmasını engeller. Açık bir topluluk sunucusunda ilk sıradadır.
  • Yönetim ve temel komutlar — ışınlanma, ev noktası, oyuncu bilgisi gibi günlük ihtiyaçları toplar.
  • İzin yönetimi — yukarıda anlattığımız grup ve yetki düzeni.
  • Yerde biriken eşya temizliği — performans için en ucuz kazançlardan biri.
  • Kayıt ve geri alma — kim neyi ne zaman değiştirdi; griefing sonrası kurtarmayı çok kolaylaştırır.

Kaç eklenti fazla?

Paket kartlarındaki eklenti sayıları bir öneridir, kapı kapatan bir sınır değil. Daha fazlasını kurabilirsin; panel yalnız performansın etkilenebileceğini hatırlatır.

Yine de sayı tek başına belirleyici değildir: kötü yazılmış tek bir eklenti, on hafif eklentiden fazla yük bindirebilir. Sunucun ağırlaştıysa sayıyı azaltmadan önce hangisinin yük ürettiğini bulmak daha akıllıcadır — performans rehberi teşhis adımlarını anlatıyor.

Örnek: WorldGuard kurulumunda eksik bağımlılık

Altı kişilik bir survival sunucusunda doğma noktasını korumaya karar verdin ve iş için WorldGuard'ı seçtin. Bu örnek, bağımlılığı unutulmuş bir kurulumun konsolda nasıl göründüğünü ve nasıl toparlandığını adım adım gösterir.

  1. Yedekler bölümünde Yedek Al'a bas ve yedeğe "worldguard öncesi" gibi bir etiket ver. Bir şey ters giderse bu ana dönersin.
  2. Eklentiler bölümünde WorldGuard'ı ara, sürüm rozetinin sunucunla uyumlu olduğunu kontrol et ve kur. Ardından sunucuyu yeniden başlat.
  3. Konsolda WorldGuard'ın açılış satırı yerine UnknownDependencyException içeren bir hata görürsün; hatada WorldEdit adı geçer. WorldGuard yüklenmemiştir, ama sunucu ve diğer eklentiler çalışmaya devam eder.
  4. Mağazada WorldEdit'i ara, sunucunun sürümüyle uyumlu olanı kur ve yeniden başlat.
  5. Bu kez konsolda önce WorldEdit'in, sonra WorldGuard'ın Enabling satırı çıkar. Kırmızı satır yoksa kurulum tamamdır.
  6. Oyunda //wand ile seçme aracını al, alanın karşılıklı iki köşesini işaretle ve /rg define spawn yaz. Bölge tanımlandığı anda, bölgeye üye olmayan oyuncular orada blok kıramaz.
  7. Bölge komutlarını yalnız yönetici grubuna bırak. Bir komutun hangi yetki düğümünü sorduğunu LuckPerms'in lp verbose on komutuyla görürsün.

Bayraklarla ince ayar ve oyunculara kendi bölgelerini verme WorldGuard ile bölge koruma yazısında. İlk adımda aldığın yedeğe nasıl döneceğini yedek alma ve geri yükleme yazısında anlattık.

Sık karşılaşılan sorunlar

  • Eklenti kuruldu ama çalışmıyor — konsola bak; büyük olasılıkla sürüm uyuşmazlığı yüzünden devre dışı bırakılmıştır.
  • Sunucu açılışta duruyor — son kurduğun eklentiyi devre dışı bırak ve tekrar başlat.
  • Komut çalışmıyor — çoğu zaman yetki sorunudur; izin eklentisinden ilgili yetkiyi grubuna ver.
  • İki eklenti çakışıyor — aynı işi yapan iki eklenti aynı anda kuruluysa biri diğerini bozabilir. Birini kaldır.
  • Eklenti bölümü açılmıyor — sunucu yazılımın eklenti ailesinden değildir. Yazılım bölümünden Paper ya da Purpur'a geç.
  • Konsolda UnknownDependencyException — eklentinin ihtiyaç duyduğu başka bir eklenti eksik. Hatada adı geçen eklentiyi kur ve yeniden başlat.
  • Ayar dosyasını düzenledikten sonra eklenti açılmıyor — büyük olasılıkla bir YAML yazım hatası var. Konsoldaki hata çoğu zaman bozuk yerin satır ve sütun numarasını verir; o satırdaki girintiye ve iki nokta işaretine bak ya da düzenlemeden önce aldığın kopyayı geri koy.

Eklenti kullanımı tüm paketlerde desteklenir; mod yazılımları için 8 GB ve üzeri bir paket gerekir. Yeni bir eklenti kurduktan sonra sunucuyu birkaç gün izlemek, hem uyum hem performans sorunlarını erken yakalamanı sağlar.

Sık sorulan sorular

Spigot için yazılmış bir eklenti Paper'da çalışır mı?

Çoğu zaman evet. Paper, Spigot'un üzerine kurulmuştur ve Bukkit ile Spigot için yazılmış eklentileri çalıştırır; Purpur da Paper'ın üzerine kurulduğu için aynısı onda da geçerlidir. Ters yön her zaman çalışmaz: yalnız Paper için yazılmış bir eklenti Spigot'ta ya da CraftBukkit'te açılmaz. Hangi yazılımın sana uyduğunu yazılım karşılaştırmasında anlattık.

Eklenti denerken /reload komutunu kullanabilir miyim?

Önerilmez. /reload bütün eklentileri sunucuyu kapatmadan yeniden yükler; birçok eklenti buna hazırlıklı değildir, bellekte eski kopyalar kalabilir ya da eklentiler yarım çalışabilir. Paper ve Spigot da bu komutu çalıştırmadan önce seni uyarır. Yeni bir eklenti için sunucuyu yeniden başlat; yalnız ayar değiştirdiysen eklentinin kendi yeniden yükleme komutunu kullan, örneğin EssentialsX için /essentials reload.

Aynı sunucuda hem eklenti hem mod kullanabilir miyim?

Hayır. Sunucu yazılımı ya eklenti ailesindendir (Paper, Purpur, Spigot, CraftBukkit) ya da bir mod yükleyicisidir (Fabric, Quilt, Forge, NeoForge); panelde ikisini birlikte çalıştıran bir yazılım yoktur. Oyuncuların hiçbir şey kurmamasını istiyorsan eklentiyi, yeni blok ve eşya istiyorsan modu seç. Mod yazılımları 8 GB ve üstü paketlerde açılır.

Bir eklentiyi indirirken nelere dikkat etmeliyim?

Dosyayı yalnız geliştiricinin yayınladığı yerden al: SpigotMC, Modrinth, Hangar ya da projenin kendi sayfası. Başka sitelerde yeniden paylaşılan jar dosyalarına zararlı kod eklenmiş olabilir ve eklentiler sunucunun dosyalarına ve verilerine erişebilir. Sayfada son güncelleme tarihine, desteklenen sürümlere ve geliştiricinin sorulara cevap verip vermediğine bak; uzun süredir güncellenmeyen bir eklenti, yeni Minecraft sürümünde genellikle ilk bozulan olur.

Eklenti ayarlarım ve verilerim yedeğe girer mi?

Evet. Yedekler bölümünden aldığın yedek dünyaları, eklentileri ve yapılandırmayı tek bir zip'te toplar; plugins klasöründeki ayar ve veri dosyaları da buna dahildir. Yalnız bir eklentinin ayarını eski hâline döndürmek istiyorsan bütün yedeği geri yükleme: yedeği indir, ilgili dosyayı içinden çıkar ve Dosyalar bölümünden yerine yükle.