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.

İçindekiler
- Plugin ile mod arasındaki fark
- Sunucu yazılımınızı ve sürümünüzü kontrol edin
- Eklentileri güvenle nereden indirirsiniz?
- Sürümü eşleştirin ve bağımlılıkları kontrol edin
- Adım adım eklenti kurulumu
- Eklentinin çalıştığını kontrol edin
- Eklentiyi yapılandırma
- Eklentileri güncelleme
- Eklenti kaldırma
- Başlangıç için popüler eklentiler
- Sık karşılaşılan hatalar
- Çok fazla eklenti ve performans
- Nodesty'de Minecraft sunucusu
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, Purpur | Forge, NeoForge, Fabric |
| Kurulduğu yer | Yalnızca sunucu, plugins klasörü | Sunucu ve genellikle her oyuncunun istemcisi |
| Oyuncuya gereken | Normal, değiştirilmemiş Minecraft istemcisi | Aynı modlar ya da modpack |
| Tipik kullanım | Rü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:
- 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.
- 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.
- 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
pluginsklasö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.
- Sunucuyu durdurun: Konsola
stopyazı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. .jardosyasınıpluginsklasö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. Terminaldenscpde 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/- Dosyayı kontrol edin. Adı
.jarile bitmeli ve bir alt klasörde değil, doğrudanpluginsiçinde durmalıdır. İndirdiğiniz dosya bir.zipise açın ve içindeki jar dosyasını yükleyin. - 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
- 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.
- Sunucuyu durdurun.
pluginsklasörünü yedekleyin:tar -czf ~/plugins-yedek-$(date +%F).tar.gz -C ~/server plugins- Eski jar dosyasını silin ve yenisini yükleyin.
plugins/<EklentiAdı>klasörüne dokunmayın; ayarlarınız ve verileriniz oradadır. - 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
| Eklenti | Ne işe yarar? |
|---|---|
| EssentialsX | /home, /spawn ve /tpa gibi temel komutlar, ayrıca kit ve warp |
| LuckPerms | Gruplar, rütbeler ve yetkiler |
| Vault | Ekonomi, yetki ve sohbet eklentilerini birbirine bağlar; pek çok eklenti ister |
| WorldEdit | Oyun içinde geniş alanları düzenler: kopyala, yapıştır, doldur ve değiştir |
| WorldGuard | Spawn gibi bölgeleri korur; WorldEdit gerektirir |
| CoreProtect | Blok değişikliklerini kaydeder ve griefing'i geri alır |
| Geyser + Floodgate | Bedrock 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
pluginsklasörüne konan bir Forge ya da Fabric modu veya bir Velocity ya da BungeeCord eklentisi yüklenmez; konsol, jar dosyasındaplugin.ymlbulunmadığı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
UnknownDependencyExceptionhatası 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.
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

Minecraft server.properties Ayarları: En Önemli Satırlar
Minecraft server.properties ayarları: dosyanın yeri, güvenli düzenleme ve oynanış, dünya, whitelist, ağ ve performans için hangi değerleri seçmelisiniz.

LuckPerms Kullanımı: Minecraft Sunucusunda Rütbe ve Yetki
Paper sunucular için LuckPerms kullanımı: kurulum, gruplar ve kalıtım, prefix, süreli rütbeler, terfi track yapısı, web editörü ve depolama seçenekleri.

Minecraft Sunucusuna Domain Bağlama: A ve SRV Kaydı
Minecraft sunucusuna domain bağlama: play.ornek.com için A kaydı, farklı port için SRV kaydı, Cloudflare DNS only, Bedrock portu ve dig ile kontrol.