Minecraft Sunucusuna Plugin Kurulumu

Minecraft plugin kurulumu, sunucunuzu vanilla bir dünyadan gerçek bir oyun sunucusuna dönüştüren adımdır ve özü çok basittir: eklentinin .jar dosyasını indirir, sunucu klasörünüzdeki plugins dizinine kopyalar, sunucuyu yeniden başlatırsınız. İşin zor tarafı kopyalama değil; doğru sürümü seçmek, bağımlılıkları eksiksiz kurmak ve eklentinin ürettiği ayar dosyasını bozmadan düzenlemektir.

Bu rehber, 11 Ağustos 2026 itibarıyla güncel kararlı sürüm olan Minecraft 26.2 “Chaos Cubed” temel alınarak yazıldı. 26.1 sürümüyle gelen unobfuscation değişikliği eklenti ekosistemini doğrudan etkilediği için, eski rehberlerdeki “indir at çalışır” yaklaşımı artık her eklenti için geçerli değil. Aşağıda hem kurulumun kendisini hem de 2026’da karşınıza çıkacak uyumluluk tuzaklarını adım adım anlatıyoruz.

Plugin Nedir, Moddan Farkı Nedir?#

Plugin (eklenti), sunucu yazılımının sunduğu API üzerine oturan ve yalnızca sunucu tarafında çalışan bir Java arşividir. Oyuncu tarafında hiçbir şey kurulmaz; kimse ekstra dosya indirmeden sunucunuza girip /home, /spawn veya /shop komutlarını kullanabilir. Bu yüzden survival, skyblock, minigame gibi topluluk sunucularının neredeyse tamamı eklenti tabanlıdır.

Mod ise oyunun kendi kodunu değiştirir. Yeni blok, yeni eşya, yeni boyut ekler ve bu içeriğin istemcide de bulunması gerekir. Bir modu sunucuya kurduğunuzda tüm oyuncular aynı modu aynı sürümde kurmak zorunda kalır. Bu yüzden mod kurulumu ayrı bir konudur ve Forge ya da Fabric tabanlı bir sunucu ister.

Hangi Sunucu Yazılımları Plugin Çalıştırır?#

Mojang’ın resmî sunucu dosyası eklenti API’si içermez. Vanilla server.jar ile bir plugins klasörü oluşturup içine dosya atarsanız hiçbir şey olmaz; sunucu o klasörü hiç okumaz. Eklenti kullanmak istiyorsanız Bukkit soyunu takip eden bir yazılıma geçmelisiniz.

Hangi yazılımın size uygun olduğuna karar veremiyorsanız sunucu yazılımları karşılaştırmamızı okuyun. Pratikte 26.2 döneminde eklentili bir sunucu için Paper ya da Purpur dışında bir seçenek düşünmenize gerek yok.

Eklentiyi Nereden İndirmelisiniz?#

Eklenti indirmenin tek güvenli yolu resmî kaynaktır. “Ücretsiz premium plugin” vaat eden Türkçe forum konuları, Discord sunucularında dolaşan jar dosyaları ve indirme siteleri, arka kapı (backdoor) barındıran eklentilerin en yaygın yayılma yoludur. Sunucuya konsol yetkisiyle yerleşen bir arka kapı, dünyanızı silmekten oyuncu verilerinizi dışarı sızdırmaya kadar her şeyi yapabilir.

Sürüm Uyumu: 26.1 Unobfuscation Kırılması#

Eklenti kurulumunda 2026’nın en kritik konusu bu. Mojang, 26.1 “Tiny Takeover” ile birlikte obfuscated sunucu jar’ı yayınlamayı bıraktı; sunucu kodu artık gerçek sınıf, metot ve alan adlarıyla dağıtılıyor. Bu yalnızca bir sürüm atlaması değil, bir ABI kırılmasıdır. Paper dahili remapper’ını tamamen kaldırdı, Spigot desteğini düşürdü, Fabric tarafında Yarn bırakılıp Mojang Mappings’e geçildi.

Pratik sonucu şudur: 1.21.11 ve öncesi için derlenmiş, sunucunun iç sınıflarına (NMS / craftbukkit paketi) dokunan hiçbir eklenti yeniden derlenmeden 26.1 ve 26.2 üzerinde çalışmaz. Yalnızca Bukkit API’sini kullanan sade eklentiler çoğunlukla sorunsuz açılır, ancak yine de geliştiricinin 26.x etiketli sürümünü indirmek gerekir.

[12:04:31 INFO]: [EskiEklenti] Loading server plugin EskiEklenti v3.1
[12:04:31 ERROR]: Error occurred while enabling EskiEklenti v3.1 (Is it up to date?)
java.lang.NoClassDefFoundError: net/minecraft/server/v1_21_R1/EntityPlayer
        at tr.ornek.eskieklenti.Main.onEnable(Main.java:42) ~[?:?]
        at org.bukkit.craftbukkit.CraftServer.enablePlugin(CraftServer.java:611) ~[paper-26.2.jar:26.2-112]

Yukarıdaki gibi bir NoClassDefFoundError ya da Is it up to date? uyarısı gördüğünüzde yapılacak tek şey eklentinin güncel sürümünü aramaktır. Geliştirici 26.x desteği vermediyse alternatif bulmanız gerekir. Eski sürümde kalmak bir çözüm gibi görünse de güvenlik yamalarından ve yeni eklenti geliştirmelerinden mahrum kalırsınız.

Java sürümü uyuşmazsa eklenti değil sunucunun kendisi açılmaz. Hangi sürümde neyin gerektiğini Minecraft için hangi Java sürümü gerekir sayfasında tablolaştırdık. Sunucu için daima Java 25 LTS kullanın; Java 26 çıktı ama LTS değil.

Adım Adım Plugin Kurulumu#

1. Sunucuyu bir kez çalıştırıp plugins klasörünü oluşturun#

   Yeni kurulmuş bir sunucuda plugins klasörü henüz yoktur. Sunucuyu bir defa başlatıp konsola stop yazarak kapatın; klasör jar dosyasının yanında otomatik oluşur. Klasörü elle de oluşturabilirsiniz, adı tam olarak küçük harfle plugins olmalıdır.

   server/
   ├── paper-26.2-112.jar
   ├── eula.txt
   ├── server.properties
   ├── world/
   ├── logs/
   └── plugins/          <-- eklentiler buraya
   

2. Eklentiyi doğru sürümüyle indirin#

   İndirme sayfasında sürüm filtresini 26.2 olarak ayarlayın. Modrinth ve Hangar bunu açılır menüden yapmanıza izin verir; SpigotMC’de eklentinin “Supported versions” satırını okuyun. Dosya uzantısının .jar olduğundan emin olun.

3. Sunucuyu düzgün kapatın#

   Konsola stop yazın veya panelden Stop düğmesine basın. Süreci zorla sonlandırmak (Görev Yöneticisi’nden kapatmak, kill -9) dünya verisini bozabilir. Kapanma tamamlanana kadar bekleyin.

   > stop
   [12:11:02 INFO]: Stopping the server
   [12:11:02 INFO]: Saving players
   [12:11:03 INFO]: Saving worlds
   [12:11:05 INFO]: ThreadedAnvilChunkStorage: All dimensions are saved

4. .jar dosyasını plugins klasörüne kopyalayın#

   Dosyayı doğrudan plugins klasörünün içine bırakın; alt klasör açmayın. Uzak bir sunucuda çalışıyorsanız WinSCP veya FileZilla ile SFTP üzerinden aktarın. Pterodactyl, Pelican veya Crafty gibi bir panel kullanıyorsanız panelin dosya yöneticisindeki “Upload” düğmesi aynı işi görür.

5. Sunucuyu yeniden başlatın ve konsolu izleyin#

   Açılış sırasında eklentinin yüklendiğini doğrulayın. Konsolda eklentinin adı ve sürüm numarası görünmeli, ardından “Enabling” satırı gelmelidir.

   [12:13:40 INFO]: [LuckPerms] Loading server plugin LuckPerms v5.5.57
   [12:13:41 INFO]: [LuckPerms] Enabling LuckPerms v5.5.57
   [12:13:42 INFO]: [LuckPerms] Loading configuration...
   [12:13:43 INFO]: [LuckPerms] Successfully enabled. (3.42s)
   [12:13:43 INFO]: Done (14.271s)! For help, type "help"

6. /plugins komutuyla listeyi kontrol edin#

   Oyun içinde veya konsolda plugins yazın. Yeşil renkte görünen eklentiler etkin, kırmızı olanlar hata nedeniyle devre dışıdır. Kırmızı bir isim görürseniz logs/latest.log dosyasını açıp ilk hatayı okuyun.

   > plugins
   Server Plugins (5):
    Bukkit Plugins:
     - EssentialsX, LuckPerms, PlaceholderAPI, Vault, WorldEdit

7. Ayar dosyasını düzenleyip yeniden başlatın#

   İlk açılışta eklenti plugins/EklentiAdi/config.yml dosyasını üretir. Ayarları burada değiştirir, sunucuyu tekrar başlatırsınız. Bazı eklentiler /eklentiadi reload komutuyla ayarı canlı yükleyebilir.

Bağımlılıkları Doğru Kurmak#

Bazı eklentiler tek başına çalışmaz, başka bir eklentinin API’sine ihtiyaç duyar. Bağımlılık eksikse eklenti sessizce devre dışı kalır veya açılışta “depend” hatası verir. En sık karşılaşılan bağımlılıklar şunlardır:

Vault

Ekonomi, izin ve sohbet API’lerini birbirine bağlayan köprü. Para eklentileri ve mağaza eklentileri neredeyse istisnasız Vault ister. Güncel sürüm 1.7.3, 26.2 ile uyumlu.

PlaceholderAPI

Scoreboard, sohbet ve tablist eklentilerinin %player_name% gibi değişkenleri okumasını sağlar. 26.2’ye çıkan sunucular mutlaka 2.12.3 sürümüne güncellemelidir; Paper 26.2 sürüm dizgisini değiştirdiği için eski sürümler hata verir.

WorldEdit

WorldGuard’ın zorunlu ön koşuludur. WorldGuard’ı tek başına kurarsanız açılmaz. Kullanımını WorldEdit ve WorldGuard rehberinde anlattık.

LuckPerms

Teknik olarak bağımlılık değildir ama izin sistemi olmadan çoğu eklentinin komutları yalnızca OP’lerde çalışır. Güncel sürüm 5.5.57 ile 26.2 tam desteklenir.

Bir eklentinin neye ihtiyaç duyduğunu indirme sayfasındaki “Dependencies” bölümünden okuyabilirsiniz. Jar dosyasını 7-Zip ile açıp içindeki plugin.yml dosyasına bakarak da doğrulayabilirsiniz:

name: OrnekEklenti
version: 2.4.1
main: tr.ornek.OrnekEklenti
api-version: '1.21'
depend: [Vault, WorldEdit]
softdepend: [PlaceholderAPI, LuckPerms]

depend listesindekiler zorunludur, biri eksikse eklenti açılmaz. softdepend listesindekiler isteğe bağlıdır; varsa ek özellik açılır, yoksa eklenti yine çalışır. api-version satırı ise eklentinin hangi API kuşağına göre yazıldığını gösterir; bu satırı hiç içermeyen çok eski eklentiler modern sunucularda “legacy” modda yüklenir ve materyal adlarında sorun çıkarır.

Config Dosyalarını Bozmadan Düzenleme#

Eklenti ayarları YAML biçimindedir ve YAML girintiye karşı acımasızdır. En sık yapılan üç hata: girintide boşluk yerine TAB kullanmak, iki nokta üst üsteden sonra boşluk bırakmamak, ve içinde iki nokta veya # geçen metni tırnak içine almamak.

# YANLIŞ — TAB girinti ve eksik boşluk
settings:
	spawn-protection:16
	motd:Batihost Test Sunucusu: giriş serbest

# DOĞRU — iki boşluk girinti, iki nokta sonrası boşluk, tırnaklı metin
settings:
  spawn-protection: 16
  motd: "Batihost Test Sunucusu: giriş serbest"

Düzenlemeden önce dosyanın bir kopyasını alın. Bir ayarı bozduğunuzda eklenti açılışta ScannerException veya InvalidConfigurationException fırlatır ve devre dışı kalır. Bu durumda ilgili dosyayı silip sunucuyu yeniden başlatırsanız eklenti varsayılan ayarlarla temiz bir dosya üretir, ama tüm özelleştirmeleriniz gider.

Eklenti verilerinizin ve dünyanızın düzenli yedeği yoksa hiçbir düzenleme güvenli değildir. Büyük bir ayar değişikliğinden önce en azından plugins klasörünün ve world dizininin bir kopyasını alın.

Yetki Sistemini Bağlamadan Kurulum Bitmez#

Eklentiyi plugins klasörüne atmak, oyuncuların onu kullanabileceği anlamına gelmez. Bukkit tabanlı sunucularda her komut ve her özellik bir izin düğümüne (permission node) bağlıdır. Bir izin düğümü hiçbir gruba verilmemişse, o komut yalnızca OP yetkisi olan oyuncularda çalışır. Yeni kurulan bir eklentinin “çalışmadığı” yönündeki şikâyetlerin büyük kısmı aslında eksik izinden kaynaklanır.

Hangi izinlerin bulunduğunu jar içindeki plugin.yml dosyasının permissions bölümünden ya da eklentinin dokümanından öğrenirsiniz. Düğümler nokta ile ayrılmış hiyerarşik bir yapı kullanır ve yıldız karakteriyle toplu verilebilir:

permissions:
  essentials.home:
    description: /home komutunu kullanma izni
    default: true
  essentials.tp:
    description: Oyuncu ışınlama izni
    default: op
  essentials.gamemode.creative:
    default: op

default: true olan düğümler herkeste açıktır, default: op olanlar yalnızca OP’lerde. Tüm oyunculara belirli izinleri vermek için bir izin eklentisi kurmanız gerekir. 2026’da bu işin standardı LuckPerms’tir; kurulum ve grup oluşturma adımlarını LuckPerms ile yetki sistemi kurma rehberinde bulabilirsiniz.

> lp group default permission set essentials.home true
> lp group vip permission set essentials.tp true
> lp group vip parent add default
> lp user Oyuncu123 parent add vip

Proxy Ağlarında Eklenti Kurulumu#

Birden fazla sunucuyu tek adres altında topladığınız BungeeCord veya Velocity ağlarında iki ayrı eklenti dünyası vardır. Proxy’nin kendi plugins klasörü ile arkadaki her Paper sunucusunun plugins klasörü farklıdır ve aynı jar ikisine birden atılmaz. Bir Bukkit eklentisini proxy klasörüne koyarsanız proxy onu tanımaz, sessizce yok sayar.

LuckPerms, ViaVersion ve Geyser gibi çok platformlu projeler indirme sayfasında ayrı jar’lar sunar; “Bukkit”, “Velocity” ve “BungeeCord” yapılarını karıştırmayın. Ağ genelinde tek bir yetki veritabanı kullanmak istiyorsanız LuckPerms’i hem proxy hem alt sunuculara kurup MySQL ya da MariaDB üzerinden ortak veritabanına bağlamanız gerekir.

ag/
├── velocity/
│   ├── velocity.jar
│   └── plugins/            <-- yalnızca Velocity eklentileri
│       └── LuckPerms-Velocity-5.5.57.jar
├── lobi/
│   └── plugins/            <-- Bukkit/Paper eklentileri
└── survival/
    └── plugins/

Eklenti Güncelleme ve Kaldırma#

Güncelleme, eski jar’ı silip yenisini koymaktan ibarettir; ayar dosyalarına dokunmayın çünkü eklenti bunları yeni sürüme uyarlar. Aynı eklentinin iki farklı sürümünü plugins klasöründe bırakmak en sık yapılan hatadır ve Ambiguous plugin name hatasına yol açar.

plugins/
├── LuckPerms-Bukkit-5.5.55.jar   <-- ESKİ, silinmeli
├── LuckPerms-Bukkit-5.5.57.jar
└── LuckPerms/
    ├── config.yml
    └── luckperms-h2-v2.mv.db

Bukkit tabanlı sunucularda ayrıca bir update klasörü özelliği vardır. bukkit.yml içindeki settings.update-folder ayarı varsayılan olarak update değerindedir. Yeni jar’ı plugins/update/ klasörüne koyarsanız, sunucu bir sonraki başlangıçta eski dosyayı otomatik değiştirir. Canlı sunucularda kesinti süresini kısaltmak için pratik bir yöntemdir.

settings:
  update-folder: update
  plugin-profiling: false
  bug-report: true

Eklentiyi tamamen kaldırırken yalnızca jar’ı silmek yetmez. Eklentinin ürettiği veri klasörü (plugins/EklentiAdi/), varsa veritabanı tabloları ve diğer eklentilerin config dosyalarına yazdığı referanslar geride kalır. Ekonomi veya izin eklentisi kaldırıyorsanız önce verilerinizi dışa aktarın.

Sık Karşılaşılan Kurulum Hataları#

Eklenti kurulumu sırasında karşılaşacağınız hataların neredeyse tamamı beş başlıkta toplanır. Aşağıdaki tablo, konsolda gördüğünüz satırdan hızlıca çözüme gitmenizi sağlar.

Konsolda hatayı bulmanın en hızlı yolu logs/latest.log dosyasını açıp içinde ERROR, Caused by ve WARN kelimelerini aramaktır. Yığın izinin (stack trace) ilk satırı hangi eklentinin sorumlu olduğunu köşeli parantez içinde gösterir. Diğer sunucu hataları için Minecraft sunucu hataları ve çözümleri sayfasına göz atın.

/reload Komutu Neden Kullanılmamalı?#

/reload confirm, eklentileri kapatıp yeniden yükleyerek sunucuyu durdurmadan güncelleme yapıyormuş gibi görünür. Gerçekte eski sınıf yükleyicileri bellekte kalır, zamanlanmış görevler iki kez kaydolur, veritabanı bağlantıları kopuk kalır. Sonuç genellikle şudur: sunucu bir süre çalışır, sonra açıklanamayan hatalar üretmeye başlar.

[13:02:11 WARN]: [!!!] The server is running a reload command!
[13:02:11 WARN]: [!!!] Reloading is not supported and may cause data loss.
[13:02:11 WARN]: [!!!] Issues arising from a reload will not be supported.

Doğru yaklaşım şudur: eklenti kendi reload alt komutunu sunuyorsa (örneğin /lp reload veya /essentials reload) yalnızca o eklentinin ayarını yeniden okutmak için onu kullanın. Jar dosyası değiştiyse ya da yeni eklenti eklediyseniz mutlaka tam yeniden başlatma yapın. Kalabalık sunucularda bunu gece saatlerine planlayın ve oyunculara /say ile önceden haber verin.

Eklentiler ve Performans#

“Kaç eklenti kurabilirim?” sorusunun sayısal bir cevabı yoktur. Belirleyici olan eklentinin her tick’te ne kadar iş yaptığıdır. Otuz hafif eklentili bir sunucu, her saniye tüm dünyayı tarayan tek bir kötü yazılmış eklentiden çok daha rahat çalışır. Yavaşlama fark ettiğinizde tahmin yürütmek yerine ölçün.

spark profiler, sunucunun hangi eklentide ne kadar CPU zamanı harcadığını satır satır gösterir. /spark profiler start ile 3-5 dakikalık bir kayıt alıp raporu incelediğinizde suçlu genellikle ilk üç satırda çıkar. Yöntemi spark ve timings raporu analizi sayfasında adım adım anlattık.

Eklentili Sunucu İçin Donanım#

Eklentiler RAM ve tek çekirdek performansı tüketir. Minecraft’ın ana tick döngüsü tek bir çekirdekte çalıştığı için çekirdek sayısı değil saat hızı belirleyicidir. Bu yüzden eklentili bir Paper sunucusunda yüksek frekanslı AMD Ryzen işlemciler, çok çekirdekli ama düşük frekanslı sunucu işlemcilerinden belirgin şekilde iyi sonuç verir.

-Xms ve -Xmx değerlerini daima eşit verin ve işletim sistemine pay bırakın. 8-12 GB heap aralığında G1GC ile Aikar’s Flags hâlâ en sağlam tercihtir; 16 GB üzeri heap veya ağır eklenti yükünde ZGC değerlendirilebilir. JVM bayraklarının ayrıntısı ve doğru heap hesabı için Minecraft sunucu RAM ayarları ve JVM flag’leri sayfasına bakın.

Kendi Eklentinizi Yazmak#

Aradığınız özelliği sunan bir eklenti bulamadıysanız iki yolunuz var. Birincisi Skript: Java bilmeden, İngilizceye yakın bir sözdizimiyle olay ve komut yazmanızı sağlar. Küçük özellikler, özel karşılama mesajları ve basit oyun mekanikleri için fazlasıyla yeterlidir; Skript’in kendisi de plugins klasörüne atılan sıradan bir eklentidir.

İkincisi gerçek bir Bukkit eklentisi geliştirmek. Java ve Maven/Gradle bilgisi ister ama tam kontrol sağlar. 26.x döneminde eklenti geliştirmenin unobfuscation sonrası nasıl değiştiğini ve ilk projenizi nasıl kuracağınızı plugin yazma rehberinde anlattık.

Özetle#

Minecraft plugin kurulumu, doğru sürümü doğru klasöre koyup sunucuyu düzgün yeniden başlatmaktan ibarettir. 2026’da işi zorlaştıran tek şey 26.1 ile gelen unobfuscation kırılmasıdır: eski eklentilerin bir kısmı yeniden derlenmeden çalışmaz, bu yüzden her eklentinin 26.2 etiketli sürümünü indirmeniz gerekir.

Kısa kontrol listesi: sunucu yazılımınız Paper veya Purpur olsun, Java 25 kurulu olsun, eklentileri yalnızca Hangar, Modrinth veya SpigotMC üzerinden indirin, bağımlılıkları eksiksiz kurun, eklentileri teker teker ekleyip konsolu izleyin, /reload yerine tam yeniden başlatma yapın ve düzenli yedek alın. Nereden başlayacağınızı bilmiyorsanız en iyi Minecraft pluginleri listesindeki temel setle başlayın; ilk kuracağınız üç eklenti büyük ihtimalle EssentialsX, LuckPerms ve Vault olacaktır.