Blog’a Dön

Minecraft Plugin Kurulumu: Sunucuya Eklenti Nasıl Yüklenir?

Paper, Spigot ve Purpur sunucular için Minecraft plugin kurulumu: güvenli indirme, sürüm ve bağımlılıklar, plugins klasörü, güncelleme ve sık hatalar.

Nodesty Ekibi8 dk okumaOyun sunucuları
Koyu Nodesty arka planında Minecraft Plugins yazısı ile Paper ve plugins klasörü

Minecraft plugin kurulumu, sade bir survival dünyasını rütbeleri, evleri, korumalı bölgeleri ve ekonomisi olan bir sunucuya dönüştürmenin yoludur. Kurulumun kendisi kısadır: Bir .jar dosyası indirir, sunucunun plugins klasörüne koyar ve sunucuyu yeniden başlatırsınız. Sorunların çoğu bunun çevresinde çıkar: yanlış sunucu yazılımı, başka bir Minecraft sürümü için hazırlanmış bir plugin ya da eksik bir bağımlılık.

Bu rehberde plugin (eklenti) ile mod arasındaki farkı, sunucu yazılımınızı ve sürümünüzü kontrol etmeyi, güvenli indirme kaynaklarını, eklenti kurmayı, yapılandırmayı, güncellemeyi ve kaldırmayı, başlangıç için kısa bir eklenti listesini ve en sık hataları anlatıyoruz. Sunucunuzu henüz kurmadıysanız önce Minecraft sunucu nasıl kurulur? rehberimize göz atın.

Plugin ile mod arasındaki fark

Bu iki kelime sık sık karıştırılır, ama farklı sistemlerdir:

Plugin (eklenti)Mod
Sunucu yazılımıPaper, Spigot, PurpurForge, NeoForge, Fabric
Kurulduğu yerYalnızca sunucu, plugins klasörüSunucu ve genellikle her oyuncunun istemcisi
Oyuncuya gerekenNormal, değiştirilmemiş Minecraft istemcisiAynı modlar ya da modpack
Tipik kullanımRütbe, ekonomi, koruma, yönetim araçlarıYeni bloklar, eşyalar, yaratıklar ve boyutlar

Eklentiler oyun dosyalarını değiştirmeden sunucunun davranışını değiştirir; bu yüzden normal istemcisi olan herkes sunucuya girebilir. Mojang'ın vanilla sunucusu eklenti yüklemez, Forge ve Fabric sunucuları da yüklemez. Modpack oynamak istiyorsanız bunun yerine Minecraft modpack sunucusu rehberimizi izleyin.

Sunucu yazılımınızı ve sürümünüzü kontrol edin

Bir şey indirmeden önce sunucunuzun ne çalıştırdığını öğrenin. Sunucu konsoluna şunu yazın (oyun içinde başına eğik çizgi ekleyin: /version):

version

Eklenti destekleyen bir sunucu, yazılımın adını (Paper, Spigot ya da Purpur) ve Minecraft sürümünü yazar. İkisini de not edin. Yanıtta bu adlardan biri geçmiyorsa ve sunucu dizininde plugins klasörü yoksa sunucu eklenti yükleyemez.

  • Paper, Bukkit, Spigot ve Paper için yazılmış eklentileri çalıştırır. Çoğu sunucu için en iyi seçimdir.
  • Purpur, Paper üzerine kuruludur ve aynı eklentileri çalıştırır.
  • Spigot, Bukkit ve Spigot eklentilerini çalıştırır, ancak Paper API'sine ihtiyaç duyan eklentileri çalıştırmaz.

Vanilla'dan geçmek için papermc.io adresinden Minecraft sürümünüze uygun Paper jar dosyasını indirin, dünyanızı yedekleyin ve eski sunucu jar dosyası yerine bu dosyayı kullanın.

Eklentileri güvenle nereden indirirsiniz?

Eklenti, sunucunuzla aynı yetkilerle çalışan bir programdır: Dosyalarınızı okuyabilir, konsol komutu çalıştırabilir ve herhangi birine OP verebilir. Yalnızca geliştiricinin eklentiyi kendisinin yayımladığı kaynaklardan indirin:

  • Modrinth (modrinth.com/plugins): Platforma ve Minecraft sürümüne göre filtreleme sunar.
  • Hangar (hangar.papermc.io): PaperMC projesinin eklenti deposudur.
  • SpigotMC (spigotmc.org/resources): Ücretli (premium) eklentileri de içeren en eski ve en büyük katalogdur.
  • Projenin kendi sitesi ya da GitHub sürümleri: Örneğin LuckPerms, EssentialsX ve Geyser sürümlerini kendi sitelerinde yayımlar.

Sızdırılmış ya da "nulled" premium eklentilerden uzak durun. Leak sitelerinden, Discord sunucularından ya da video açıklamalarından gelen ücretli eklentilerin bedava kopyaları, zararlı yazılım yaymanın yaygın bir yoludur: Jar dosyası, bir yabancıya OP veren, dosyalarınızı çalan ya da sunucunuzu saldırılarda kullanan bir arka kapıyla yeniden paketlenir. Üstelik güncelleme ve destek de alamazsınız. Ücretli bir eklenti bütçenizi aşıyorsa yukarıdaki platformlarda ücretsiz bir alternatif arayın.

Hangi platform olursa olsun, kurmadan önce son güncelleme tarihine, indirme sayısına ve yorumlara bakın.

Sürümü eşleştirin ve bağımlılıkları kontrol edin

Eklentinin indirme sayfasında üç şeye bakın:

  1. Minecraft sürümü. Sunucunuzun sürümünü listeleyen dosyayı seçin. Yalnızca resmî API'yi kullanan eklentiler çoğu zaman yeni sürümlerde de çalışmaya devam eder; sunucunun iç yapısına bağlanan eklentiler ise tam sizin sürümünüz için hazırlanmış bir dosya ister.
  2. Platform. Pek çok proje Paper, Velocity, BungeeCord, hatta Fabric için ayrı dosyalar sunar. Paper, Spigot ya da Purpur sunucusunda Paper, Spigot ya da Bukkit olarak işaretlenmiş dosyayı alın. Proxy dosyaları proxy'ye kurulur; bunu Minecraft Velocity ağı rehberimizde anlattık.
  3. Bağımlılıklar. Bazı eklentiler yalnızca başka bir eklenti kuruluyken çalışır. En sık karşılaşılanlar Vault (ekonomi, yetki ve sohbet eklentileri arasında köprü), ProtocolLib (ağ paketlerine erişim) ve PlaceholderAPI'dir (metinlerde oyuncunun rütbesi ya da bakiyesi gibi yer tutucular). Zorunlu bağımlılıklar da plugins klasöründe bulunmalıdır; isteğe bağlı olanlar yalnızca ek özellikleri açar.

Adım adım eklenti kurulumu

Bir eklenti yalnızca sunucu açılırken yüklenir; bu yüzden her kurulum bir yeniden başlatmayla biter.

  1. Sunucuyu durdurun: Konsola stop yazın. Yeni bir eklentiyi sunucu çalışırken yükleyip ardından yeniden başlatabilirsiniz de, ama o an yüklü olan bir eklentinin jar dosyasının üzerine asla yazmayın.
  2. .jar dosyasını plugins klasörüne yükleyin. Panelinizin dosya yöneticisini ya da FileZilla, WinSCP gibi bir SFTP programını kullanın; nasıl bağlanacağınızı FTP ve SFTP nedir? rehberimizde gösterdik. Terminalden scp de aynı işi görür (yolu kendi sunucu klasörünüze göre değiştirin):
    scp OrnekEklenti-1.0.jar minecraft@203.0.113.10:~/server/plugins/
    
  3. Dosyayı kontrol edin. Adı .jar ile bitmeli ve bir alt klasörde değil, doğrudan plugins içinde durmalıdır. İndirdiğiniz dosya bir .zip ise açın ve içindeki jar dosyasını yükleyin.
  4. Sunucuyu başlatın. İlk açılışta çoğu eklenti, yapılandırma dosyalarıyla birlikte kendi klasörünü (plugins/<EklentiAdı>) oluşturur.

Eklentinin çalıştığını kontrol edin

Eklentileri konsolda (ya da oyun içinde /plugins ile) listeleyin:

plugins
  • Yeşil, eklentinin etkin olduğunu gösterir.
  • Kırmızı, eklentinin bulunduğunu ama etkinleştirilemediğini gösterir.
  • Eklenti listede hiç yoksa sunucu dosyayı yükleyememiştir.

Paper'ın güncel sürümleri listeyi Paper eklentileri ve Bukkit eklentileri olarak ikiye ayırır; bu normaldir. version EklentiAdı komutu bir eklentinin hangi sürümünün kurulu olduğunu gösterir.

Kırmızı görünen ya da listede olmayan eklentilerde sebep konsolda ve logs/latest.log dosyasında yazar. Linux'ta günlüğü sunucu klasöründen arayabilirsiniz:

grep -iE "error|exception|could not load" logs/latest.log

Eklentinin adının geçtiği ilk hatayı okuyun; sebep çoğunlukla açıkça yazar.

Eklentiyi yapılandırma

Ayarlar plugins/<EklentiAdı>/config.yml dosyasında durur; büyük eklentiler yanına başka dosyalar da ekler. Bunlar YAML dosyalarıdır ve YAML biçim konusunda katıdır:

settings:
    teleport-delay: 3
    join-message: '&eSunucuya hoş geldiniz!'
  • Girintiyi sekmeyle değil boşlukla yapın ve değiştirdiğiniz satırın çevresindeki girintiyi koruyun.
  • &, : ya da # gibi karakterler içeren metinleri tırnak içine alın.

Bozuk bir dosya eklentinin açılışta hata vermesine ya da varsayılan ayarlara dönmesine yol açar; büyük değişikliklerden önce dosyanın bir kopyasını alın.

Değişiklikleri uygulamak için sunucuyu yeniden başlatın. Pek çok eklentinin /essentials reload ya da /wg reload gibi kendi yenileme komutu da vardır; küçük değişiklikler için bunlar yeterlidir. Genel /reload komutunu kullanmayın: Sunucu çalışırken bütün eklentileri yeniden yükler; bu da bellek sızıntısına, iki kez çalışan görevlere ve bozuk verilere yol açabilir. Paper tam da bu yüzden bir uyarı gösterir ve onay ister.

Eklentileri güncelleme

  1. Eklentinin sürüm notlarını okuyun; yeni sürümün yapılandırmayı değiştirip değiştirmediği ya da daha yeni bir sunucu isteyip istemediği orada yazar.
  2. Sunucuyu durdurun.
  3. plugins klasörünü yedekleyin:
    tar -czf ~/plugins-yedek-$(date +%F).tar.gz -C ~/server plugins
    
  4. Eski jar dosyasını silin ve yenisini yükleyin. plugins/<EklentiAdı> klasörüne dokunmayın; ayarlarınız ve verileriniz oradadır.
  5. Sunucuyu başlatın, plugins çıktısını ve günlüğü kontrol edin.

Sunucuyu yeni bir Minecraft sürümüne geçirmeden önce kullandığınız bütün eklentilerin o sürümü desteklediğini kontrol edin; ardından önce sunucu yazılımını, hemen sonra eklentileri güncelleyin. Sunucudan bağımsız tutulan yedekleri Sunucu yedekleme rehberimizde anlattık.

Eklenti kaldırma

Sunucuyu durdurun ve eklentinin jar dosyasını plugins klasöründen silin. Eklentinin klasörü, ayarları ve verileriyle birlikte yerinde kalır; yalnızca bir daha gerekmeyeceğinden eminseniz silin. Vault ya da ProtocolLib gibi bir kütüphaneyi kaldırmadan önce başka bir eklentinin ona bağımlı olmadığından emin olun; aksi hâlde o eklentiler bir sonraki açılışta yüklenmez.

Başlangıç için popüler eklentiler

EklentiNe işe yarar?
EssentialsX/home, /spawn ve /tpa gibi temel komutlar, ayrıca kit ve warp
LuckPermsGruplar, rütbeler ve yetkiler
VaultEkonomi, yetki ve sohbet eklentilerini birbirine bağlar; pek çok eklenti ister
WorldEditOyun içinde geniş alanları düzenler: kopyala, yapıştır, doldur ve değiştir
WorldGuardSpawn gibi bölgeleri korur; WorldEdit gerektirir
CoreProtectBlok değişikliklerini kaydeder ve griefing'i geri alır
Geyser + FloodgateBedrock oyuncularını Java sunucusuna alır; Floodgate, Java hesabı gereğini kaldırır

Vault tek başına bir ekonomi sağlamaz; EssentialsX gibi bir ekonomi eklentisine ihtiyaç duyar. Rütbe kurulumunu LuckPerms kullanımı rehberimizde, hazır gelen yönetim komutlarını ise Minecraft sunucu komutları rehberimizde anlattık.

Sık karşılaşılan hatalar

  • Yanlış sunucu yazılımı: Paper sunucusunun plugins klasörüne konan bir Forge ya da Fabric modu veya bir Velocity ya da BungeeCord eklentisi yüklenmez; konsol, jar dosyasında plugin.yml bulunmadığını bildirir.
  • Sürüm uyuşmazlığı: Eklenti başka bir Minecraft sürümü için hazırlanmıştır. Kırmızı kalır ya da yüklenir ama oyuncular kullandığında hata verir. Kendi sürümünüze uygun dosyayı indirin ya da güncel bir fork arayın.
  • Eksik bağımlılık: Günlükte UnknownDependencyException hatası ve eksik eklentinin adı görünür. O eklentiyi kurup sunucuyu yeniden başlatın.
  • UnsupportedClassVersionError: Eklenti, sunucunuzun çalıştığı Java sürümünden daha yeni bir sürüm için derlenmiştir. Class file version 65 Java 21, 61 ise Java 17 demektir. Minecraft sürümünüz destekliyorsa eklentinin istediği Java sürümünü kurun ve başlatma betiğinin onu kullandığından emin olun.
  • Çift jar dosyası: Örneğin bir güncellemeden sonra klasörde aynı eklentinin iki sürümü kalır. Konsol belirsiz eklenti adı (ambiguous plugin name) uyarısı verir ve hangisinin yüklendiğinden emin olamazsınız. Eski dosyayı silin.
  • Bozuk yapılandırma: Bir düzenlemeden sonra eklenti, satır numarasını veren bir YAML hatasıyla açılmaz. Girintiyi düzeltin ya da kopyanızı geri yükleyin.

Çok fazla eklenti ve performans

Her eklenti sunucunun her tick'ine iş ekler ve kötü yazılmış tek bir eklenti bütün sunucuyu yavaşlatabilir. Yalnızca gerçekten kullandıklarınızı kurun ve aynı işi iki kez yapan eklentilerden, örneğin iki ekonomi ya da iki ışınlanma eklentisinden kaçının.

Hangi eklentinin en çok yük bindirdiğini öğrenmek için ölçün. Paper, 1.21 sürümünden beri spark profil aracıyla birlikte gelir; spark burada eski Timings sisteminin yerini almıştır:

/spark profiler start
/spark profiler stop

Profil aracını sunucu yoğunken birkaç dakika çalıştırın; durdurma komutundan sonra spark, her eklentinin tick süresinden ne kadar pay aldığını gösteren bir raporun bağlantısını verir. Spigot'ta ve Paper'ın eski sürümlerinde /timings on yazıp birkaç dakika sonra /timings paste komutunu kullanın ya da spark'ı eklenti olarak kurun. Sonraki adımlar Minecraft sunucu lag sorunu rehberimizdedir.

Nodesty'de Minecraft sunucusu

Nodesty Minecraft sunucu kiralama paketleri, Frankfurt'ta 5,7 GHz'e çıkan AMD Ryzen 9 9950X işlemci, NVMe disk ve DDoS korumasıyla çalışır. Paper ile dakikalar içinde başlayabilir, eklentilerinizi plugins klasörüne yükleyip sunucunuzu tam yönetici erişimiyle yönetebilirsiniz. Oyun sunucularında günlük yedekler ücretsizdir ve 7 gün saklanır; böylece ters giden bir eklenti güncellemesi dünyanıza mal olmaz.

Minecraft, Mojang AB'nin ticari markasıdır. Nodesty, Mojang ve Microsoft ile bağlantılı değildir ve onlar tarafından onaylanmamıştır.

Sıkça Sorulan Sorular

Vanilla Minecraft sunucusuna plugin kurabilir miyim?

Hayır. Mojang'ın resmî sunucu dosyası plugin yüklemez. Paper, Spigot ya da Purpur gibi Bukkit uyumlu bir sunucu yazılımına ihtiyacınız vardır. Geçiş kolaydır; sunucu jar dosyasını aynı Minecraft sürümünün Paper jar dosyasıyla değiştirirsiniz ve dünyanız yerinde kalır. Geçmeden önce dünya klasörünü yedekleyin.

Plugin kurulu bir sunucuya girmek için oyuncuların bir şey kurması gerekir mi?

Hayır. Pluginler yalnızca sunucuda çalışır; oyuncular desteklenen bir sürümdeki normal, değiştirilmemiş Minecraft istemcisiyle bağlanır. Modlardan en büyük farkı budur, çünkü modların genellikle her oyuncunun bilgisayarına da kurulması gerekir.

Aynı sunucuda hem plugin hem mod kullanabilir miyim?

Doğrudan hayır. Pluginler Paper, Spigot ya da Purpur ister; modlar ise Forge, NeoForge ya da Fabric ister ve bu iki sistem birbirinin dosyalarını yüklemez. İkisini birleştirmeye çalışan hibrit sunucu yazılımları vardır, ancak sık sık uyumluluk sorunu çıkarırlar; ilk sunucunuz için önermiyoruz.

Pluginim plugins listesinde neden kırmızı görünüyor?

Kırmızı, pluginin bulunduğu ama etkinleştirilemediği anlamına gelir. En sık sebepler Vault gibi eksik bir bağımlılık, başka bir Minecraft sürümü için hazırlanmış bir plugin dosyası ya da eski bir Java sürümüdür. logs/latest.log dosyasını açıp plugin adının geçtiği ilk hatayı okuyun; sebep çoğunlukla orada yazar.

Plugin ekledikten sonra reload komutunu kullanmak güvenli mi?

Hayır. reload komutu sunucu çalışırken bütün pluginleri kaldırıp yeniden yükler ve pek çok plugin buna göre yazılmamıştır. Bellek sızıntısına, iki kez çalışan görevlere ve bozuk verilere yol açabilir; Paper da bu komuta karşı uyarır. Bunun yerine sunucuyu yeniden başlatın.

Plugini güncellediğimde ayarlarım silinir mi?

Yalnızca jar dosyasını değiştirdiğiniz sürece hayır. Ayarlar ve veriler plugins klasörünün içindeki pluginin kendi klasöründe durur ve yerinde kalır. Yine de güncellemeden önce plugins klasörünü yedekleyin, çünkü büyük bir sürüm yapılandırma ya da veri biçimini değiştirebilir.

Nodesty

Yazar hakkında

Nodesty Ekibi · Altyapı ve Destek

Nodesty ekibi sunucularımızı, ağımızı ve DDoS korumamızı her gün işletir ve müşteri destek taleplerini 7/24 yanıtlar. Bu rehberler o deneyimden yazılır.

İlgili yazılar

Sunucunuzu şimdi başlatın.

Nodesty'nin üstün altyapısı ile projelerinizi özgürce inşa edin ve sınır tanımadan ölçeklendirin.

                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                             ············································                                                   
                                                ··································································································..........···························                                     
                                       ················..........................................................................................................................··············                             
                                  ·············.................::::::::::::::::::::::::::::::::::::::::::::::....................:::::::::::::::::::::::::::::::::::::::................···········                        
                             ············................:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::............·········                     
                         ············.................:::::::::::::::::::::::::::::::::::::::::::::::::::------------::::::::::::::::::::::::::::::----------------:::::::::::::::::::::..........········                  
                    ············......................::::::::::::::::::::::::::::::::::::------------------------------------------------------------------------------------:::::::::::::.........········                
                ··········.............................................::::::::::::::::::-------------==========================================-----------------------------------:::::::::::........·······               
             ········..................:.....................................::::::::::--------=======+++++++++++++++++++++++++++++++++++++=========================------------------::::::::::.......·······              
           ······.........::::::::::::::::::::................................:::::::-----=====++++xxxxxx**************************xxxxxxxxx++++++++++++++===================------------::::::::.......·······             
          ·····.......:::::::::::::::::::::::::::.............................:::::----===+++xxx****%%%%&&&&&&#############&&&&&&&%%%%%*******xxxxxxxx++++++++++++++==============----------:::::::......······             
         ····......::::::::-------------:::::::::::..........................::::---===+++xx***%%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@####&&&&&%%%%*******xxxxxxxxx+++++++++++++===========--------::::::......·····             
        ····.....:::::::--------------------:::::::::.......................::::---===++xxx**%%&&&###@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&%%%%%********xxxxxxxxxxx++++++++++++========------::::::.....······            
        ····.....:::::--------------------------::::::::....................::::---===++xx***%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&&%%%%%**********xxxxxxxxxxxxx+++++++++=======------:::::.....·····            
        ····....::::::-------=============---------:::::::::................:::::---===+++xx***%%%&&&#####@@@@@@@@@@@@@@@@@@@@@@@@@#####&&&&&%%%%%%*************xxxxxxxxxxxxxx+++++++++======-----:::::....·····            
         ····....:::::-------================---------:::::::::...............:::::----===++++xxx***%%%%&&&&&&#################&&&&&&%%%%%%%*******************xxxxxxxxxxxxxxxxx++++++++======----:::::....·····            
         ·····....:::::--------=================---------::::::::::..............:::::::-----====+++++xxxxxx**************************xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx++++++++=====-----::::....·····            
          ·····.....:::::--------=================----------:::::::::::.................:::::::::-------=============++++++++++++++++++++++++++++++++++++xxxxxxxxxxxxxxxxxxxxxxx++++++++======-----::::....·····            
            ·····.....:::::::----------===========-------------::::::::::::.........................::::::::::::::::::------------------=============+++++++++++++++++++++++++++++++++=======-----::::.....·····            
              ······......:::::::---------------------------------:::::::::::::........................................:::::::::::::::-----------============+++++++++++++++++++++========------:::::.....·····             
                 ······........:::::::::---------------------------:::::::::::::::::...........................................:::::::::::::------------=============================--------::::::.....······              
                    ·········.........:::::::::::::::-------------::::::::::::::::::::::::.......................................::::::::::::::::--------------------------------------::::::::......·······                
                          ··········............::::::::::::::::::::::::::::::::::::::::::::::::::................................::::::::::::::::::::::::::-------------:::::::::::::::.........········                   
                                  ············..................:::::::::::::::::::::::::::::::::::::::::::.........................:::::::::::::::::::::::::::::::::::::................···········                        
                                             ················.............................................................................................................·················                                 
                                                           ······················................................................................···························                                                
                                                                               ·········································································