Minecraft Sunucusuna Eklenti (Plugin) Ekleme, Kaldırma ve Güncelleme

Minecraft sunucunuza eklenti eklemek, aslında tek bir .jar dosyasını doğru klasöre koyup sunucuyu yeniden başlatmaktan ibarettir. Bu rehberde hangi butona tıklayacağınızdan konsoldaki hata mesajlarının ne anlama geldiğine kadar her adımı tek tek anlatıyoruz.

Eklenti (plugin) nedir, .jar dosyası nedir?

Minecraft sunucusunda eklenti (İngilizcesi plugin), sunucuya yeni özellikler kazandıran küçük bir programdır. Oyuncuların ev kurabilmesi, para kazanabilmesi, arazi koruyabilmesi, sohbette rütbelerinin görünmesi, mağaza açılması, görev alması gibi her şey eklentilerle olur. Minecraft kendi başına bunların hiçbirini yapmaz.

Bir eklenti size tek bir dosya olarak gelir ve bu dosyanın uzantısı .jar'dır. Örnek dosya adı: EssentialsX-2.21.0.jar. Bu dosyayı bilgisayarınızda açmanız, çift tıklamanız veya "kurmanız" gerekmez. Sunucudaki doğru klasöre koymanız yeterlidir.

Başlamadan önce bilmeniz gereken dört şey:

• Eklenti ile mod aynı şey değildir. Eklenti sadece sunucuya kurulur, oyuncular hiçbir şey indirmez ve normal Minecraft ile girer. Mod (Forge/Fabric) ise hem sunucuya hem oyuncunun bilgisayarına kurulur. Bu rehber eklentiler içindir.
• Eklentiler yalnızca Bukkit tabanlı sunucularda çalışır. Spigot, Paper, Purpur bu ailedendir. Verisunucu Minecraft paketlerinin tamamı Paper veya Purpur üzerine kuruludur, yani eklenti desteklidir.
• İndirdiğiniz dosya .zip ise doğrudan yüklemeyin. Bazı eklentiler sıkıştırılmış olarak gelir. Bilgisayarınızda sağ tıklayıp "Tümünü ayıkla" deyin, içinden çıkan .jar dosyasını yükleyin.
• Her eklentiyi resmî sayfasından indirin. Güvenilir kaynaklar SpigotMC, Modrinth, Hangar ve eklentinin kendi GitHub sayfasıdır. Rastgele sitelerden indirilen .jar dosyaları sunucunuza zararlı kod bulaştırabilir.

plugins klasörü nerede, içinde ne var?

Sunucunuzun ana dizininde (yani sunucu açıldığında ilk gördüğünüz dosya listesinde) plugins adında bir klasör vardır. Bütün eklentiler istisnasız buraya konur. Başka bir klasöre koyduğunuz eklenti çalışmaz, hata bile vermez, sadece hiç yokmuş gibi davranır.

Bu klasörü görmek için:

1. Verisunucu müşteri panelinden oyun sunucusu panelinize giriş yapın.
2. Sunucu listesinden Minecraft sunucunuzun adına tıklayın.
3. Üstteki sekmelerden Dosyalar (bazı panellerde Dosya Yöneticisi veya Files yazar) sekmesine tıklayın.
4. Karşınıza gelen listede plugins yazan klasörü göreceksiniz. Adının üzerine tek tıklayarak içine girin.

Ana dizinde göreceğiniz diğer dosya ve klasörler ve ne işe yaradıkları:

• plugins - Bütün eklentiler burada durur. Bu rehberin konusu bu klasördür.
• world, world_nether, world_the_end - Oyun dünyanız. Silerseniz haritanız sıfırlanır.
• server.properties - Sunucunun temel ayarları (oyuncu limiti, zorluk, dünya adı gibi).
• logs - Sunucunun tuttuğu kayıt dosyaları. Hata ararken buraya bakacağız.
• eula.txt - Mojang kullanım şartlarının kabul kaydı.
• Uzantısı .jar olan büyük bir dosya (paper.jar, purpur.jar gibi) - Sunucu yazılımının kendisi. Bunu asla silmeyin, eklenti sanıp taşımayın.

plugins klasörünün içine girdiğinizde iki tür şey görürsünüz: .jar dosyaları (eklentinin kendisi) ve klasörler. Örneğin EssentialsX-2.21.0.jar dosyasının yanında Essentials adında bir klasör olur. Bu klasörü eklenti ilk çalıştığında kendisi oluşturur; ayar dosyaları, dil dosyaları ve oyuncu verileri orada tutulur. Yani .jar dosyası programın kendisi, klasör ise o programın hafızasıdır. Bu ayrım kaldırma ve güncelleme bölümlerinde çok önemli olacak.

Adım adım eklenti ekleme

Eklenti eklemenin en kolay yolu panelin dosya yöneticisidir. Hiçbir program indirmenize gerek yoktur. Aşağıdaki adımları sırayla, atlamadan uygulayın.

1. Eklentiyi bilgisayarınıza indirin. Eklentinin resmî sayfasına gidin ve indirme bölümünde sunucunuzun Minecraft sürümünü destekleyen dosyayı seçin. Sayfada genelde "Supported versions" veya "Supported Minecraft versions" başlığı altında 1.21.x gibi bir liste bulunur. Sunucunuz 1.21.8 ise, listede 1.21.8 yazmalıdır.
2. İndirilen dosyanın uzantısını kontrol edin. Windows'ta indirilenler klasöründe dosyaya sağ tıklayıp "Özellikler" deyin. "Dosya türü" satırında .jar yazmalıdır. Eğer .zip yazıyorsa dosyayı sağ tıklayıp "Tümünü ayıkla" seçin ve içinden çıkan .jar dosyasını kullanın.
3. Panelde sunucunuzu açın. Oyun sunucusu panelinize girin ve sunucunuzun adına tıklayın.
4. Sunucuyu durdurun. Konsol sekmesindeyken sağ üstteki kırmızı Durdur (Stop) butonuna basın. Konsolda sunucu kapanana kadar bekleyin. Kapandığında sunucu durumu "Çevrimdışı" (Offline) olarak görünür. Sunucu açıkken dosya yüklerseniz eklenti çoğu zaman fark edilmez, bazen de dosya yarım kalır.
5. Dosyalar sekmesine geçin. Üstteki menüden Dosyalar'a tıklayın.
6. plugins klasörüne girin. Listedeki plugins yazısına tıklayın. Artık üstte yolun /plugins olarak göründüğünü doğrulayın. Yanlış klasöre yükleme yapmamak için bu kontrolü mutlaka yapın.
7. Yükle butonuna basın. Sağ üst köşede Yükle (Upload) yazan bir buton vardır. Ona tıklayın; açılan pencerede bilgisayarınızdan .jar dosyasını seçin. Alternatif olarak dosyayı doğrudan tarayıcı penceresinin içine sürükleyip bırakabilirsiniz.
8. Yüklemenin bitmesini bekleyin. Ekranda ilerleme çubuğu %100 olana kadar sayfayı kapatmayın. Yükleme bitince dosya listede görünecektir.
9. Dosyanın boyutunu kontrol edin. Listede dosyanın yanında boyutu yazar. Eğer 0 B veya birkaç KB gibi anlamsız derecede küçük görünüyorsa yükleme yarım kalmıştır. Dosyayı silip yeniden yükleyin. Normal bir eklenti genelde 100 KB ile 20 MB arasındadır.
10. Sunucuyu başlatın. Konsol sekmesine dönün ve yeşil Başlat (Start) butonuna basın.
11. Konsolu izleyin. Sunucu açılırken konsolda akan yazıların içinde eklentinizin adını arayın. [Sunucu] Enabling EssentialsX v2.21.0 benzeri bir satır görüyorsanız eklenti başarıyla yüklenmiştir. En sonda Done (12.345s)! For help, type "help" satırını görmek sunucunun sorunsuz açıldığı anlamına gelir.

FTP ile yükleme (isteğe bağlı): Aynı anda 20-30 eklenti yükleyecekseniz tarayıcı yerine FileZilla gibi bir FTP programı daha hızlıdır. Panelde Ayarlar veya SFTP bölümünde sunucu adresi, port ve kullanıcı adı yazar; şifreniz panel şifrenizdir. Bağlandıktan sonra yine plugins klasörüne girip dosyaları sürüklemeniz yeterlidir.

Sunucuyu doğru şekilde yeniden başlatma

Eklentiler yalnızca sunucu açılırken yüklenir. Sunucu çalışırken plugins klasörüne bir dosya atmanız hiçbir şey yapmaz; eklenti ancak sunucu bir sonraki açılışında devreye girer. Bu yüzden her eklenti ekleme, kaldırma ve güncelleme işleminden sonra sunucuyu yeniden başlatmanız gerekir.

Doğru yöntem şudur:

1. Panelde Konsol sekmesine gidin.
2. Durdur (Stop) butonuna basın ve sunucu tamamen kapanana kadar bekleyin. Durum "Çevrimdışı" olmalıdır.
3. Dosya işlemlerinizi yapın (eklenti yükleyin, silin, ayar dosyası düzenleyin).
4. Başlat (Start) butonuna basın.

Panelde ayrıca Yeniden Başlat (Restart) butonu vardır. Bu buton sunucuyu kapatıp tekrar açar ve dosya işlemi yapmayacaksanız (örneğin sadece bir ayarı yürürlüğe koyacaksanız) kullanışlıdır. Ancak dosya yükleyeceğiniz zaman Durdur - yükle - Başlat sırasını tercih edin; yükleme sırasında sunucunun kapalı olduğundan böylece emin olursunuz.

Önemli uyarı - /reload komutunu kullanmayın. Oyun içinde veya konsolda çalıştırılan /reload komutu eklentileri kapatıp yeniden açmaya çalışır. Kâğıt üzerinde pratik görünür ama uygulamada:

• Bazı eklentiler yarım kapanır ve arkada hayalet süreçler bırakır.
• Oyuncu verileri (para, ev, kit süreleri) kaydedilmeden silinebilir.
• Sunucu kasar, hatta donar.
• Ortaya çıkan hataların gerçek sebebini bulmak imkânsız hâle gelir.

Bu yüzden Paper ve Purpur, /reload yazdığınızda konsola kalın harflerle uyarı basar. Yeni eklenti eklerken tek doğru yol sunucuyu kapatıp açmaktır. Sadece bir eklentinin ayar dosyasını değiştirdiyseniz, o eklentinin kendi yenileme komutunu kullanabilirsiniz; örneğin /essentials reload veya /papi reload gibi. Bu komutlar yalnızca o eklentiyi etkiler ve güvenlidir.

Eklenti yüklendi mi? /plugins komutu ile kontrol

Eklentinin gerçekten çalışıp çalışmadığını öğrenmenin en hızlı yolu /plugins komutudur. Kısaltması /pl şeklindedir, ikisi de aynı işi yapar.

1. Minecraft oyununuzu açın ve sunucunuza girin.
2. Klavyeden T tuşuna basarak sohbeti açın.
3. /plugins yazıp Enter'a basın.
4. Sohbette "Plugins (34):" gibi bir satır ve ardından eklenti isimleri listelenir.

Listedeki isimlerin renkleri size durumu söyler:

• Yeşil isim: Eklenti yüklendi ve çalışıyor. İstediğiniz budur.
• Kırmızı isim: Eklenti sunucu tarafından tanındı ama devre dışı kaldı. Genellikle bir bağımlılık eksiktir veya ayar dosyasında hata vardır. Konsol logunu okumanız gerekir.
• İsim listede hiç yok: Sunucu o dosyayı hiç görmedi. Muhtemelen yanlış klasöre yüklediniz, dosya .jar değil, dosya bozuk indi ya da sunucuyu yeniden başlatmadınız.

Bu komutu oyun içinde yazabilmek için OP yetkiniz olmalıdır. OP değilseniz "Bu komutu kullanma izniniz yok" benzeri bir mesaj alırsınız. Aynı komutu panelin Konsol sekmesindeki yazı kutusuna da yazabilirsiniz; konsolda komutları eğik çizgi olmadan yazın, yani sadece plugins yazıp Enter'a basın. Konsol her zaman en yetkili kullanıcıdır, orada izin sorunu yaşamazsınız.

Tek bir eklentinin sürümünü öğrenmek isterseniz /version EssentialsX yazın. Eklentinin adını, sürüm numarasını ve yazarını gösterir. Güncelleme yaptıktan sonra doğru sürümün yüklendiğini bu komutla doğrulayabilirsiniz.

Eklenti kaldırma

Bir eklentiyi kaldırmak, .jar dosyasını silmekten ibarettir. Ama silmeden önce iki şeyi düşünmeniz gerekir: verileri saklamak isteyip istemediğiniz ve başka eklentilerin o eklentiye bağımlı olup olmadığı.

1. Panelde Konsol sekmesinden Durdur butonuna basın, sunucu tamamen kapansın.
2. Dosyalar sekmesine gidin ve plugins klasörüne girin.
3. Kaldırmak istediğiniz eklentinin .jar dosyasını bulun. Satırın en sağındaki üç noktaya tıklayın ve Sil (Delete) seçeneğini seçin.
4. Aynı isimli klasörü ne yapacağınıza karar verin. Örneğin Jobs5.2.4.5.jar dosyasını sildiyseniz yanında Jobs klasörü kalmıştır. Bu klasörde ayarlar ve oyuncu verileri durur.
   • İleride bu eklentiyi geri kurma ihtimaliniz varsa klasörü silmeyin. Boş yere yer kaplar ama hiçbir zarar vermez ve eklentiyi geri kurduğunuzda her şey kaldığı yerden devam eder.
   • Tamamen temizlik yapmak istiyorsanız klasörü de silin. Ancak o eklentiye ait bütün oyuncu verileri (kazanılmış meslek seviyeleri, biriktirilmiş para, kurulmuş araziler) geri dönüşü olmadan silinir.
5. Başlat butonuna basın.
6. Oyuna girip /plugins yazın. Sildiğiniz eklentinin listeden kalktığını doğrulayın.

Silmeden önce mutlaka kontrol edin - bağımlılıklar. Bazı eklentiler tek başına bir işe yaramaz; diğer eklentilerin çalışması için gereken altyapıyı sağlar. Bunlardan birini silerseniz o eklenti değil, ona bağlı beş on eklenti birden çöker. Verisunucu paketlerinde sık geçen altyapı eklentileri şunlardır:

• Vault - Para sistemini diğer eklentilere bağlar. Silerseniz mağaza, meslek, ödül sistemlerinin tamamı durur.
• PlaceholderAPI - Sohbette, skorbordda ve TAB listesinde görünen değişkenleri sağlar. Silerseniz her yerde ham metin (%player_name% gibi) görünmeye başlar.
• ProtocolLib - Bazı eklentilerin ağ katmanına erişmesini sağlar. Silerseniz hologram, sahte blok ve menü eklentileri hata verir.
• LuckPerms - Rütbe ve yetki sistemi. Silerseniz sunucudaki bütün yetkilendirme çöker, yetkililer yetkisiz kalır.
• CMILib, SCore, BlueSlimeCore, nightcore gibi "Core" veya "Lib" içeren isimler - Bunlar da kütüphanedir, tek başlarına bir özellik sunmazlar ama silinemezler.

Kaldıracağınız eklentinin altyapı olup olmadığından emin değilseniz, önce plugins klasöründe .jar dosyasını silmek yerine adının sonuna bir ek koyup devre dışı bırakabilirsiniz. Dosyaya sağ tıklayıp Yeniden Adlandır (Rename) deyin ve Jobs5.2.4.5.jar adını Jobs5.2.4.5.jar.kapali yapın. Artık uzantısı .jar olmadığı için sunucu onu görmez. Bir şeyler ters giderse adı geri düzelterek eski hâline dönebilirsiniz. Bu yöntem yeni başlayanlar için silmekten çok daha güvenlidir.

Eklenti güncelleme

Güncelleme, eski .jar dosyasını silip yerine yenisini koymaktır. Ayar dosyalarına ve oyuncu verilerine dokunmazsınız; onlar eklentinin klasöründe durur ve yeni sürüm onları olduğu gibi kullanmaya devam eder.

1. Önce yedek alın. Panelde Yedekler (Backups) sekmesine gidip Yedek Oluştur deyin. Güncelleme ters giderse tek tıkla geri dönebilirsiniz. Yedek özelliği yoksa en azından plugins klasöründeki ilgili eklenti klasörünü bilgisayarınıza indirin.
2. Yeni sürümü indirin. Eklentinin resmî sayfasından, sunucunuzun Minecraft sürümünü destekleyen en güncel .jar dosyasını indirin.
3. Sunucuyu durdurun. Konsol sekmesinden Durdur butonuna basın.
4. Eski .jar dosyasını silin. plugins klasöründe eski dosyayı bulun ve silin. Bu adımı atlamayın. Dosya adı sürümle birlikte değiştiği için (EssentialsX-2.20.1.jar ve EssentialsX-2.21.0.jar gibi) yenisini yüklerseniz ikisi birden klasörde kalır ve sunucu aynı eklentiyi iki kez yüklemeye çalışıp hata verir.
5. Yeni .jar dosyasını yükleyin. Yükle butonuna basıp yeni dosyayı seçin, %100 olana kadar bekleyin.
6. Eklentinin klasörünü silmeyin. Essentials, Jobs gibi klasörler ayarlarınızı ve oyuncu verilerinizi taşır. Silerseniz sunucunuz sıfırdan kurulmuş gibi olur.
7. Başlat butonuna basın ve konsolu izleyin.
8. Oyuna girip /version EklentiAdi yazarak yeni sürüm numarasının göründüğünü doğrulayın.

Güncellemeden sonra konsolda görebileceğiniz normal uyarılar: Bazı güncellemeler ayar dosyasına yeni satırlar ekler. Eklenti bunu fark edip "config.yml is outdated" veya "Yeni ayarlar eklendi" gibi bir uyarı basabilir. Çoğu eklenti eksik satırları kendisi tamamlar, bir şey yapmanıza gerek kalmaz. Bazıları ise eski dosyayı config.yml.old olarak yedekleyip yenisini oluşturur; bu durumda özelleştirdiğiniz ayarları eski dosyadan yenisine elle taşımanız gerekir.

Hazır paketlerdeki güncelleme dosyaları: Verisunucu Minecraft paketlerinin bazılarında (örneğin OneBlock ve Modern Survival paketlerinde) ana klasörün yanında UPDATE FILES adında ayrı bir klasör bulunur. Bu klasör paket geliştiricisinin sonradan yayımladığı yeni sürüm .jar dosyalarını ve güncellenmiş ayar dosyalarını içerir. Bunları sunucuya yüklerken de yukarıdaki sırayı izleyin: önce eski .jar dosyasını silin, sonra yenisini yükleyin. Ayar dosyalarını üzerine yazmadan önce mutlaka yedek alın, çünkü kendi yaptığınız değişiklikler kaybolacaktır.

Eklenti çalışmıyorsa konsol logunda ne aranır?

Eklenti listede görünmüyorsa veya kırmızı görünüyorsa, sebebini konsol logu söyler. Log, sunucunun kendi kendine tuttuğu not defteridir; her açılışta ne yaptığını satır satır yazar. Bakması korkutucu görünse de aradığınız satırı bulmak kolaydır.

Loga iki yerden ulaşırsınız:

1. Canlı konsol: Panelde Konsol sekmesi. Sunucu açılırken akan yazılar burada görünür. Sunucuyu başlattıktan sonra ilk 30 saniyeyi buradan izleyin.
2. Kayıtlı log dosyası: Panelde Dosyalar sekmesi, sonra logs klasörü, içindeki latest.log dosyası. Bu dosya en son açılışın tam kaydıdır. Üzerine tıklayıp okuyabilir, sağdaki üç noktadan indirip Not Defteri ile de açabilirsiniz.

Log içinde ne arayacaksınız: Tarayıcıda log dosyası açıkken klavyeden Ctrl + F tuşlarına basın, çıkan arama kutusuna sırayla şunları yazıp arayın:

• Eklentinin adı (örneğin Citizens). Adının geçtiği satırlar size doğrudan durumu söyler.
• ERROR - Ciddi hatalar. Bu satırlar mutlaka okunmalıdır.
• Could not load - Yüklenemeyen eklentileri gösterir.
• Caused by - Hatanın gerçek sebebini yazan satır budur. Uzun hata yığınlarında en çok işe yarayan anahtar kelimedir.

Sık karşılaşılan konsol mesajları ve anlamları:

• [Sunucu] Enabling EssentialsX v2.21.0 - Her şey yolunda, eklenti açıldı.
• Done (18.204s)! For help, type "help" - Sunucu tamamen açıldı ve oyuncu kabul etmeye hazır.
• Could not load 'plugins/OrnekEklenti.jar' in folder 'plugins' - Eklenti yüklenemedi. Bu satırın hemen altındaki satır sebebini söyler, oraya bakın.
• Unknown dependency 'Vault'. Please download and install this plugin to run 'OrnekEklenti' - Eklenti başka bir eklentiye ihtiyaç duyuyor ve o eklenti sunucuda yok. Adı geçen eklentiyi (burada Vault) indirip plugins klasörüne koyun.
• does not contain a plugin.yml veya Invalid plugin.yml - Yüklediğiniz dosya geçerli bir eklenti değil. Ya indirme yarım kaldı, ya .zip dosyasını .jar sanıp yüklediniz, ya da yanlış dosyayı indirdiniz. Dosyayı silip yeniden indirin.
• java.lang.UnsupportedClassVersionError: ... has been compiled by a more recent version of the Java Runtime (class file version 65.0) - Sunucunuzun Java sürümü düşük. Bir sonraki bölümde detaylı anlatılıyor.
• java.lang.NoSuchMethodError veya java.lang.NoClassDefFoundError - Eklenti, sunucuda bulamadığı bir işlevi çağırıyor. Neredeyse her zaman sürüm uyumsuzluğu ya da eksik bağımlılık demektir.
• Plugin already initialized veya aynı eklentinin iki kez listelenmesi - plugins klasöründe aynı eklentinin iki farklı sürümü duruyor. Eski olanı silin.
• Ambiguous plugin name 'X' for files ... - Yine aynı eklentiden iki dosya var demektir; mesajda iki dosyanın adı yazar, birini silin.

Hata mesajını nasıl kullanacaksınız: Caused by satırındaki metni kopyalayıp arama motorunda aratmak çoğu zaman doğrudan çözümü verir. Aramaya eklentinin adını da ekleyin. Çözemezseniz, konsoldaki ilgili 20-30 satırı kopyalayıp Verisunucu destek talebine ekleyin; hatanın tamamı olmadan tanı koymak mümkün olmaz.

Sürüm uyumsuzluğu nasıl anlaşılır?

Eklentilerin çalışmamasının bir numaralı sebebi sürüm uyumsuzluğudur. Burada üç ayrı sürüm birbirine uymak zorundadır: Minecraft sürümü, eklentinin desteklediği sürüm ve Java sürümü.

1. Sunucunuzun Minecraft sürümünü öğrenin. Oyun içinde /version yazın. Konsolda ise sunucu açılırken en üstteki satırlarda yazar. Şuna benzer bir çıktı görürsünüz: This server is running Paper version 1.21.8. Buradaki 1.21.8 sizin Minecraft sürümünüzdür.

Verisunucu hazır paketlerinin sürümleri şöyledir:

• Elite Survival - 1.21.11 (Purpur)
• Modern Survival - 1.21.11
• Lifesteal - 1.21.8 (Paper)
• OneBlock - 1.21.8
• Premium SkyBlock - 1.21.4 (Paper)
• Klasik Survival - 1.21.1 (Paper)

2. Eklentinin desteklediği sürümü kontrol edin. Eklentinin indirme sayfasında "Supported versions" veya "Tested Minecraft Versions" başlığı altında bir sürüm listesi bulunur. Sizin sürümünüz bu listede yoksa eklenti büyük ihtimalle çalışmaz. Konsolda şu mesajı görürseniz doğrudan bunu söylüyordur: Loaded class ... Unsupported API version veya The server may not be compatible with this plugin.

Paper, Purpur ve Spigot birbirine uyumludur. Purpur, Paper'ın gelişmiş bir sürümüdür; Paper, Spigot'un gelişmiş bir sürümüdür. Yani "Spigot için" yazan bir eklenti Paper'da da Purpur'da da çalışır. Tersi her zaman geçerli değildir: özellikle "Paper only" yazan eklentiler Spigot'ta çalışmaz. Verisunucu paketleri Paper ve Purpur kullandığı için bu üç etiketin hepsi sizin için uygundur. Ancak "Forge", "Fabric", "NeoForge", "Mod" etiketli dosyalar eklenti değil moddur, sunucunuzda kesinlikle çalışmaz.

3. Java sürümünü kontrol edin. Minecraft 1.21.x sürümleri Java 21 gerektirir. Sunucunuz daha eski bir Java ile çalışıyorsa hem sunucu hem eklentiler açılmaz. Bu durumun konsoldaki karşılığı şudur:

java.lang.UnsupportedClassVersionError: com/ornek/Eklenti has been compiled by a more recent version of the Java Runtime (class file version 65.0), this version of the Java Runtime only recognizes class file versions up to 61.0

Bu mesajdaki sayılar Java sürümlerinin kod karşılığıdır:

• class file version 52 = Java 8
• class file version 55 = Java 11
• class file version 61 = Java 17
• class file version 65 = Java 21

Yukarıdaki örnek mesaj şunu diyor: "Bu eklenti Java 21 ile derlenmiş ama sunucunda Java 17 var." Çözüm, sunucunun Java sürümünü yükseltmektir. Panelde Başlangıç (Startup) sekmesinde "Docker Image" veya "Java Version" adında bir seçim kutusu vardır; buradan Java 21 seçeneğini işaretleyip sunucuyu yeniden başlatın. Bu seçeneği bulamazsanız Verisunucu destek ekibinden Java sürümünüzün yükseltilmesini talep edin.

Ters yönde bir uyumsuzluk da mümkündür. Eklenti çok eski bir Minecraft sürümü için yazılmışsa (örneğin 1.16 için) 1.21 sunucunuzda açılır gibi görünüp komutları çalıştırdığınızda hata verebilir. Konsolda NoSuchMethodError görüyorsanız neredeyse kesinlikle bu durumdasınızdır. Çözüm, eklentinin güncel sürümünü bulmak; güncel sürümü yoksa aynı işi yapan başka bir eklentiye geçmektir.

Verisunucu hazır paketlerinde eklenti eklerken dikkat edilecekler

Verisunucu Minecraft paketleri, içindeki onlarca eklenti birbirine ayarlanmış hâlde teslim edilir. Bu paketlere yeni eklenti eklerken bilmeniz gereken birkaç özel durum vardır.

1. Paketi sunucuya yüklerken üst klasörü yüklemeyin. Paket dosyasını açtığınızda içinde tek bir üst klasör görürsünüz. Bu klasörün adı pakete göre değişir: bazı paketlerde SETUP FILES, bazılarında Setup (v3.0) veya doğrudan paketin adı yazar. Sunucuya yüklemeniz gereken şey bu klasörün içeriğidir, klasörün kendisi değildir.

• Doğru sonuç: Sunucu ana dizininde plugins, world, server.properties dosya ve klasörlerini görüyorsunuz.
• Yanlış sonuç: Sunucu ana dizininde tek bir SETUP FILES klasörü görüyorsunuz. Bu durumda sunucu hiçbir eklentiyi bulamaz, boş bir sunucu olarak açılır. Klasörün içine girip bütün dosyaları bir üst dizine taşımanız gerekir.

2. Citizens eklentisi dört pakette gelmez, ayrıca indirmeniz gerekir. Bu paketlerdeki NPC'ler (köylü kılığında duran, tıklayınca menü açan karakterler) Citizens adlı eklenti ile çalışır. Lisans nedeniyle Citizens paketlerin içine konulamaz. Eklenti tamamen ücretsizdir, ama siz indirmediğiniz sürece NPC'lerin hiçbiri görünmez ve sunucunuz eksik görünür.

• Elite Survival - Citizens gerekli. Pakette 151 adet NPC tanımlıdır.
• Klasik Survival - Citizens gerekli. Pakette 13 adet NPC tanımlıdır.
• Lifesteal - Citizens gerekli.
• Premium SkyBlock - Citizens gerekli.
• Modern Survival - Gerekmez. Bu paket FancyNpcs kullanır ve o eklenti paketin içinde gelir.
• OneBlock - Gerekmez. Bu paket de FancyNpcs kullanır ve o eklenti paketin içinde gelir.

Citizens kurulumu diğer eklentilerle birebir aynıdır: resmî sayfasından sunucunuzun sürümüne uygun Citizens.jar dosyasını indirin, sunucuyu durdurun, plugins klasörüne yükleyin, sunucuyu başlatın. Ardından /plugins yazıp Citizens'ın yeşil göründüğünü doğrulayın. NPC'ler sunucuya kayıtlı olduğu için ilk açılışta kendiliğinden yerlerine gelir; ayrıca bir şey yapmanız gerekmez. Modern Survival ve OneBlock paketlerinde Citizens'a gerek yoktur, gereksiz yere kurmayın.

3. Yer tutucu adresleri kendi adreslerinizle değiştirin. Paketler örnek adreslerle gelir: play.survival.net, store.yourserver.net, discord.gg/yourserver gibi. Bunlar sizin adresleriniz değildir, sadece yer tutucudur. Menülerde, duyurularda, tabelalarda ve sohbette görünürler. Kendi sunucu adresinizi, mağaza adresinizi ve Discord davet bağlantınızı ilgili ayar dosyalarında bulup değiştirmeniz gerekir. Değiştirmezseniz oyuncularınız var olmayan adreslere yönlendirilir.

4. Türkçe dil dosyaları hazır gelir, yeni eklenti kurarsanız İngilizce olur. Verisunucu paketlerinde EssentialsX, BentoBox, Jobs, AuraSkills gibi ana eklentilerin Türkçe dil dosyaları aktif edilmiş hâlde teslim edilir. Ancak sonradan kendiniz bir eklenti kurarsanız o eklenti varsayılan olarak İngilizce gelir. Türkçeleştirmek için genellikle o eklentinin klasöründeki messages.yml, lang.yml veya locale klasöründeki dosyayı düzenlemeniz gerekir.

5. Paketler kurumsal teslim ayarlarıyla gelir. Verisunucu paketleri TAB listesinde verisunucu.net markası ve sohbette 4 adet kurumsal duyuru ile teslim edilir. Bunlar TAB ve duyuru eklentilerinin ayar dosyalarında tanımlıdır; kendi sunucu bilgilerinizle değiştirebilirsiniz.

6. Yeni eklenti eklemeden önce mutlaka yedek alın. Hazır paketler dengeli bir bütündür. Dışarıdan eklediğiniz bir eklenti, pakette zaten var olan bir eklentiyle çakışabilir. Örneğin pakette hâlihazırda bir ekonomi eklentisi varken ikinci bir ekonomi eklentisi kurarsanız para sistemi ikiye bölünür. Aynı işi yapan iki eklenti kurmaktan kaçının; ekleyeceğiniz eklentinin işlevinin pakette zaten olup olmadığını /plugins listesinden kontrol edin.

Sık yapılan hatalar

Yeni sunucu sahiplerinin eklentilerle yaşadığı sorunların büyük kısmı aşağıdaki on maddenin içindedir. Bir eklenti çalışmıyorsa önce bu listeyi gözden geçirin.

• Sunucuyu yeniden başlatmamak. Dosyayı yüklediniz ama sunucu hâlâ eski hâlde çalışıyor. Eklenti ancak yeniden başlatmadan sonra devreye girer.
• Yanlış klasöre yüklemek. .jar dosyası ana dizine veya logs gibi başka bir klasöre yüklenmiş. Dosya mutlaka plugins klasörünün doğrudan içinde olmalı, alt klasörlerinde değil.
• .zip dosyasını olduğu gibi yüklemek. Sunucu .zip dosyalarını eklenti olarak tanımaz. Önce ayıklayın, içinden çıkan .jar dosyasını yükleyin.
• Aynı eklentinin iki sürümünü klasörde bırakmak. Güncelleme yaparken eski dosyayı silmeyi unutmak en sık yapılan hatadır. Sunucu "Ambiguous plugin name" hatası verir.
• Sunucu açıkken dosya yüklemek. Dosya yarım yüklenebilir veya sunucu tarafından kilitlenebilir. Her zaman önce durdurun.
• /reload komutuna güvenmek. Yeni eklentiyi devreye almaz, üstelik veri kaybına yol açabilir.
• Bağımlılığı kurmadan eklenti kurmak. Vault, PlaceholderAPI, ProtocolLib gibi altyapı eklentileri eksikse ana eklenti kırmızı görünür ve çalışmaz.
• Yanlış Minecraft sürümü için dosya indirmek. 1.20 için yazılmış bir eklenti 1.21.8 sunucuda açılmayabilir ya da komutları hata verir.
• Java sürümünü kontrol etmemek. 1.21.x sunucular Java 21 ister. Eski Java ile eklentiler UnsupportedClassVersionError verir.
• Konsolu hiç okumamak. Sunucu sorunun sebebini zaten yazmıştır. Konsolda eklentinin adını aratmak çoğu problemi bir dakikada çözer.

Bu listedeki her şeyi kontrol ettiğiniz hâlde eklenti çalışmıyorsa, logs klasöründeki latest.log dosyasını indirin ve Verisunucu destek talebinize ekleyin. Hangi eklentiyi kurduğunuzu, hangi paketi kullandığınızı ve konsolda gördüğünüz hata satırını da yazarsanız çözüm çok daha hızlı olur.

Sıkça Sorulan Sorular