Web Panelden Minecraft Plugin Yükleme

Web panelden Minecraft plugin yükleme üç adımdan oluşur: eklentinin .jar dosyasını indirmek, panelin dosya yöneticisindeki plugins klasörüne yüklemek ve sunucuyu yeniden başlatmak. Tek bir komut yazmanız gerekmez, işlem bir dakikadan kısa sürer.

Bu sayfada yükleme adımlarının yanı sıra sık atlanan noktaları da göreceksiniz: eklentinin sunucu sürümünüzü destekleyip desteklemediğini nasıl anlarsınız, yüklenip yüklenmediğini nasıl doğrularsınız, ayar dosyasını nereden düzenlersiniz ve eklenti çalışmadığında hangi sırayla bakmanız gerekir.

Paneli yeni kullanmaya başladıysanız web panel ile Minecraft sunucusu kurma sayfası sekmelerin ne işe yaradığını anlatıyor; buradaki adımlar oradaki ekranlara göre yazıldı.

Plugin (Eklenti) Nedir, Moddan Farkı Ne?#

Plugin, Türkçesiyle eklenti, sunucuya yeni özellikler kazandıran küçük bir Java programıdır: ekonomi sistemi, bölge koruma, yetki yönetimi, ışınlanma komutları gibi. En önemli özelliği yalnızca sunucu tarafında çalışmasıdır — oyuncular hiçbir şey kurmaz, normal Minecraft istemcisiyle bağlanır.

Mod ise oyunun kendisini değiştirir; sunucuda kurulu bir modun aynısı oyuncunun bilgisayarında da kurulu olmak zorundadır. İkisi aynı sunucuda çalışmaz.

Yüklemeden Önce: 3 Kontrol#

Yanlış jar’ı yüklemek en sık yapılan hata. Aşağıdaki üç şeyi indirme sayfasında kontrol edin.

1. Sunucu yazılımınız uygun mu?#

Konsolda sunucu açılırken yazan satıra bakın. This server is running Paper version 26.2-112 gibi bir satır görüyorsanız eklenti yükleyebilirsiniz. Vanilla sunucuda böyle bir satır çıkmaz ve eklenti desteği yoktur; önce Paper’a geçmeniz gerekir.

2. Eklenti sürümü sunucu sürümünüzü destekliyor mu?#

İndirme sayfalarında “Supported versions” veya “Game versions” alanı bulunur. Sunucunuz 26.2 ise eklentinin 26.2 yazan sürümünü indirin. Bu nokta 2026’da özellikle önemli: Minecraft 26.1 ile Mojang obfuscated sunucu jar’ı yayınlamayı bıraktı, bu bir ABI kırılmasıdır. Eski derlemeler yeniden derlenmeden 26.1 ve 26.2’de yüklenmez.

3. Bağımlılığı var mı?#

Bazı eklentiler tek başına çalışmaz. En bilinen örnekler: WorldGuard, WorldEdit olmadan açılmaz; ekonomi eklentilerinin çoğu Vault ister; birçok eklenti değişken (placeholder) için PlaceholderAPI arar. İndirme sayfasındaki “Dependencies” bölümünü okuyun.

Eklentiyi Nereden İndirmelisiniz?#

Sunucuya yüklediğiniz her jar dosyası, sunucunuzda tam yetkiyle kod çalıştırabilir. Bu yüzden kaynak seçimi bir güvenlik meselesidir. Yalnızca aşağıdaki resmî kanalları kullanın.

Adım Adım: Panelden Plugin Yükleme#

Elinizde jar dosyası varsa yükleme işlemi altı adım sürer. Sunucuyu bu sırada durdurmanız şart değil ama temiz bir kurulum için önerilir.

1. Yedek alın#

   Yeni bir eklenti sunucunun davranışını değiştirir. “Yedekler (Backups)” sekmesinden tek tıkla yedek oluşturun. Beş saniyelik bu işlem, kötü bir eklentinin dünyanızı bozması ihtimaline karşı sigortanızdır.

2. Dosyalar sekmesini açın#

   Sol menüden Dosyalar (Files) sekmesine girin. Karşınıza sunucunun kök dizini gelir. Burada plugins, world, logs, cache klasörlerini ve server.properties, eula.txt dosyalarını görürsünüz.

   /home/container
   <-- plugins/
   <-- world/
   <-- world_nether/
   <-- world_the_end/
   <-- logs/
   <-- eula.txt
   <-- server.properties
   <-- server.jar

3. plugins klasörüne girin#

   plugins klasörünün adına tıklayarak içine girin. Klasör hiç yoksa sunucunuz henüz bir kez bile başlatılmamış demektir; “Konsol” sekmesinden başlatıp durdurun, klasör kendiliğinden oluşur.

4. Jar dosyasını yükleyin#

   Sağ üstteki Yükle (Upload) düğmesine basıp dosyayı seçin ya da doğrudan tarayıcı penceresine sürükleyip bırakın. Yükleme çubuğu dolduğunda dosya listede görünür. Birden fazla eklentiyi aynı anda sürükleyebilirsiniz.

5. Dosya adını ve uzantısını kontrol edin#

   Dosyanın uzantısı .jar olmalı. Tarayıcı bazen dosyayı .jar.txt ya da .zip olarak kaydeder; böyle bir şey görürseniz dosya adına sağ tıklayıp Yeniden Adlandır ile düzeltin. Eklenti bir ZIP içinde geldiyse önce açın, jar dosyasını içinden çıkarın.

6. Sunucuyu yeniden başlatın#

   Konsol sekmesine dönüp Yeniden Başlat (Restart) düğmesine basın. Eklentiler yalnızca sunucu açılışında yüklenir; dosyayı klasöre atmak tek başına yeterli değildir. Konsolu izleyin, eklentinin adını göreceksiniz.

   [Server thread/INFO]: [LuckPerms] Loading server plugin LuckPerms v5.5.57
   [Server thread/INFO]: [WorldEdit] Loading server plugin WorldEdit v7.4.5
   [Server thread/INFO]: [Essentials] Enabling Essentials v2.22.0
   [Server thread/INFO]: Done (12.104s)! For help, type "help"

Eklenti Gerçekten Yüklendi mi? Nasıl Kontrol Edilir#

Yüklenip yüklenmediğini anlamanın en hızlı yolu konsol komutudur. “Konsol” sekmesindeki komut kutusuna eğik çizgi olmadan şunu yazın:

plugins

Sunucu size yüklü eklentilerin listesini döner. Renkler önemlidir:

• Yeşil isim: Eklenti yüklendi ve etkin.
• Kırmızı isim: Eklenti bulundu ama etkinleştirilemedi. Konsolda hata satırı vardır.
• Listede hiç yok: Jar dosyası okunamadı ya da yanlış klasörde.

Tek bir eklentinin sürümünü öğrenmek isterseniz version EssentialsX gibi bir komut kullanabilirsiniz. Konsolun daha ayrıntılı kullanımı için panel konsolundan komut çalıştırma sayfasına bakın.

Eklenti Ayarlarını Düzenleme#

Her eklenti ilk açılışında plugins içinde kendi adıyla bir klasör oluşturur. Ayarlar bu klasördeki config.yml dosyasındadır. Panelde dosyaya tıklayıp doğrudan düzenleyebilirsiniz.

plugins/
<-- Essentials/
<--<-- config.yml
<--<-- userdata/
<-- LuckPerms/
<--<-- config.yml
<-- WorldGuard/
<--<-- config.yml
<-- LuckPerms-5.5.57.jar
<-- WorldEdit-7.4.5.jar

YAML biçimindeki bu dosyalarda birkaç kural vardır ve ihlal edildiğinde eklenti hiç açılmaz:

# Dogru kullanim
spawn-on-join: true
teleport-cooldown: 5
kits:
  baslangic:
    delay: 3600
    items:
      - stone_sword 1
      - bread 16

# Yanlis: girinti icin Tab kullanmak
# Yanlis: iki nokta ustuste sonrasi bosluk birakmamak

Dosyayı kaydettikten sonra sunucuyu yeniden başlatın. Bazı eklentiler /essentials reload gibi kendi yeniden yükleme komutlarını destekler ama en güvenilir yol yeniden başlatmaktır. Dosya yöneticisinin tüm özellikleri için panel dosya yöneticisi kullanımı sayfasına bakabilirsiniz.

Yeni Başlayanlar İçin İlk 5 Eklenti#

Yeni açılmış bir survival sunucusunda bu beş eklenti işlerin yüzde sekseninizi karşılar. Hepsi ücretsizdir ve resmî kaynakları vardır.

Bu eklentilerin kurulumu ve yapılandırması için ayrı rehberlerimiz var: EssentialsX kurulumu, LuckPerms ile yetki sistemi ve WorldEdit ve WorldGuard ile bölge koruma. Daha geniş bir liste isterseniz en iyi Minecraft pluginleri sayfasına bakın.

Eklenti Güncelleme ve Kaldırma#

Güncelleme#

Doğru sıra şudur: sunucuyu durdurun, plugins klasöründeki eski jar dosyasını silin, yeni sürümü yükleyin, sunucuyu başlatın. Eski dosyayı silmeyi unutmak en sık yapılan hatadır; iki sürüm yan yana durduğunda sunucu genelde ikisini de yüklemez.

Eklenti klasöründeki config.yml dosyasına dokunmanız gerekmez; yeni sürüm eksik anahtarları kendisi ekler. Büyük sürüm atlamalarında (örneğin 4.x’ten 5.x’e) eklentinin kendi güncelleme notlarını okuyun.

Kaldırma#

Sunucuyu durdurun, jar dosyasını silin, sunucuyu başlatın. Eklentinin klasörü (plugins/EklentiAdi/) yerinde kalır; fikrinizi değiştirip geri yüklerseniz ayarlarınız korunur. Tamamen temizlemek isterseniz klasörü de silin.

Eklenti Yüklenmiyorsa: 7 Sebep#

1. Sunucu yeniden başlatılmadı#

En sık sebep bu. Jar dosyasını klasöre atmak yeterli değildir; eklentiler yalnızca sunucu açılışında okunur.

2. Dosya yanlış klasörde#

Jar, plugins klasörünün doğrudan içinde olmalı. Alt klasöre (örneğin plugins/yeni/) atılan jar yüklenmez. Sunucu kök dizinine atılan jar da yüklenmez.

3. Sürüm uyumsuzluğu#

Konsolda şu tarz bir satır görürsünüz. Eklentinin sunucu sürümünüzü destekleyen yapısını indirin.

[Server thread/ERROR]: Could not load 'plugins/OrnekPlugin.jar' in folder 'plugins'
org.bukkit.plugin.InvalidPluginException: java.lang.UnsupportedClassVersionError
  ... Caused by: java.lang.NoClassDefFoundError: net/minecraft/server/level/ServerLevel

4. Bağımlılık eksik#

Unknown dependency: WorldEdit gibi bir satır görüyorsanız önce o eklentiyi yükleyin. Bağımlılıklar her zaman ana eklentiden önce yüklenmelidir; sunucu bu sırayı kendisi ayarlar, sizin yapmanız gereken tek şey ikisini de klasöre koymaktır.

5. Dosya bozuk indi#

Yarım inen bir jar dosyası Zip file is corrupted hatası verir. Dosyayı silip yeniden indirin. İndirme sırasında tarayıcı sekmesini kapatmayın.

6. Yanlış sunucu yazılımı#

Bukkit eklentisini Forge sunucusuna atmışsanız hiçbir şey olmaz. Bir de ters durum var: Velocity ve BungeeCord proxy eklentileri normal Paper sunucusuna atıldığında yüklenmez, çünkü farklı bir platform için derlenmişlerdir.

7. Aynı eklentinin iki kopyası#

Klasörde Plugin-1.2.jar ve Plugin-1.3.jar birlikte duruyorsa temizleyin. Panelin dosya listesini sürüm yükselttikçe gözden geçirmeyi alışkanlık hâline getirin.

Bunların hiçbiri sorunu çözmediyse konsolun tamamını okuyun. Hata satırı genelde eklentinin adıyla birlikte gelir ve size ne eksik olduğunu doğrudan söyler. Genel eklenti kurulumu bilgisi için Minecraft sunucusuna plugin kurulumu ana rehberine de bakabilirsiniz.

Kaç Eklenti Yüklemek Doğru?#

Her eklenti belleğe ve tick süresine bir maliyet ekler. 15-25 eklentili bir Paper sunucusu 10-12 GB RAM ile rahat çalışır; 60 eklentiye çıktığınızda aynı donanımda TPS düşmeye başlar.

Sağlıklı bir yaklaşım şudur: her eklentiyi ekledikten sonra bir hafta gözlemleyin, gerçekten kullanılmayanları kaldırın. Performans sorununu ölçmek için spark profiler kurun; hangi eklentinin ana iş parçacığını meşgul ettiğini rakamla gösterir.

Eklenti sayısı arttıkça RAM ihtiyacınız da artar. 30 oyuncuyu geçen eklentili sunucularda 16 GB’lık bir Minecraft sunucu paketi ve Ryzen 9 sınıfı işlemci belirgin fark yaratır; Minecraft’ın ana tick döngüsü tek çekirdekte çalıştığı için çekirdek sayısı değil saat hızı belirleyicidir.

Özetle#

Panelden plugin yükleme, jar dosyasını plugins klasörüne atıp sunucuyu yeniden başlatmaktan ibarettir. İşin püf noktası yüklemede değil, doğru jar’ı seçmekte: eklentinin sunucu sürümünüzü desteklediğinden ve bağımlılıklarının kurulu olduğundan emin olun.

Aklınızda kalması gerekenler: eklentiler yalnızca Paper, Purpur, Spigot ve Bukkit tabanlı sunucularda çalışır; dosya plugins klasörünün doğrudan içine gider; sunucu yeniden başlatılmadan eklenti devreye girmez; konsoldaki plugins komutu size gerçeği söyler; ayarlar config.yml dosyasındadır ve YAML’de Tab kullanılmaz.

Sıradaki adımlar için panel dosya yöneticisi kullanımı ve panelden yedek alma sayfalarına geçebilirsiniz. Bir eklenti sunucunuzu açılmaz hâle getirdiyse destek talebi açmaktan çekinmeyin.