Minecraft sunucularda pluginler; yetki sistemi, ekonomi, koruma, market, event, claim, anti-cheat ve birçok özel sistemi çalıştırır. Pluginlerden biri yüklenmediğinde sunucunun önemli bir bölümü çalışmayabilir.

Plugin hataları genellikle konsolda veya logs/latest.log dosyasında görünür. En sık karşılaşılan hatalar; Could not load plugin, Unsupported API version, Unknown dependency, Invalid plugin.yml ve Java sürüm uyumsuzluklarıdır.

1. Plugin Hatasını Nereden Görebilirsiniz?

Plugin yüklenmiyorsa ilk bakılacak yer sunucu konsolu ve latest.log dosyasıdır.

tail -n 200 logs/latest.log

Canlı takip için:

tail -f logs/latest.log

Plugin adıyla arama yapmak için:

grep -i "pluginadi" logs/latest.log

2. Unsupported API Version Hatası

Bu hata, pluginin desteklediği Minecraft API sürümü ile sunucu sürümünün uyumsuz olduğunu gösterir.

Unsupported API version 1.20

Örneğin plugin 1.20 için hazırlanmış fakat sunucunuz 1.16.5 çalıştırıyor olabilir. Bu durumda plugin yüklenmeyebilir veya hatalı çalışabilir.

Çözüm:

• Pluginin desteklediği Minecraft sürümünü kontrol edin.
• Sunucu sürümünüzle uyumlu plugin sürümünü indirin.
• Çok eski sunucularda yeni pluginlerin çalışmasını beklemeyin.
• Gerekirse pluginin eski sürüm arşivinden uygun versiyon bulun.

3. Unknown Dependency Hatası

Bazı pluginler tek başına çalışmaz. Başka bir pluginin önce yüklenmesini ister. Buna bağımlılık yani dependency denir.

Unknown dependency Vault
Could not load plugin because dependency LuckPerms was not found

Örneğin ekonomi pluginleri çoğu zaman Vault ister. Yetki veya market pluginleri de başka kütüphane pluginlerine ihtiyaç duyabilir.

Çözüm:

• Plugin sayfasında yazan gereksinimleri okuyun.
• Eksik dependency pluginini indirin.
• Dependency pluginin de sunucu sürümünüzle uyumlu olduğundan emin olun.
• Sunucuyu tamamen restart edin.

4. Invalid plugin.yml Hatası

Plugin jar dosyasının içindeki plugin.yml dosyası bozuk, eksik veya hatalıysa plugin yüklenemez.

Invalid plugin.yml
Plugin does not contain a plugin.yml

Bu genellikle şu durumlarda oluşur:

• Yanlış dosya indirilmiştir.
• Plugin yerine kaynak kod zipi plugins klasörüne atılmıştır.
• Jar dosyası bozulmuştur.
• Plugin geliştirici tarafından hatalı paketlenmiştir.

Çözüm olarak pluginin doğru .jar dosyası indirilmelidir. GitHub’dan indirilen source-code.zip doğrudan plugins klasörüne atılmamalıdır.

5. Java Sürüm Uyumsuzluğu

Minecraft sürümü ve pluginler belirli Java sürümleri ister. Yanlış Java sürümü kullanılırsa plugin veya sunucu hiç açılmayabilir.

java -version

Sık görülen hata:

UnsupportedClassVersionError

Bu hata, pluginin daha yeni Java ile derlendiğini fakat sunucuda eski Java kullanıldığını gösterir.

Genel mantık:

• Eski Minecraft sürümleri genellikle eski Java ister.
• Yeni Minecraft sürümleri daha yeni Java ister.
• Plugin açıklamasındaki Java gereksinimi kontrol edilmelidir.
• Hosting panelinde seçili Java sürümü doğrulanmalıdır.

6. Plugin Dosyası Doğru Klasörde mi?

Bukkit, Spigot ve Paper sunucularda plugin dosyaları plugins klasörüne atılır.

ls plugins/

Plugin dosyası şu şekilde olmalıdır:

plugins/PluginAdi.jar

Zip, rar, kaynak kod veya klasör halinde bırakılan pluginler çoğu zaman çalışmaz.

7. Plugin Çakışmaları

Aynı işi yapan iki plugin birbiriyle çakışabilir. Örneğin iki farklı chat plugin, iki farklı ekonomi plugin veya iki farklı claim sistemi aynı eventleri yönetmeye çalışabilir.

Çakışma belirtileri:

• Plugin yüklenir ama komutları çalışmaz.
• Bir plugin diğerinin ayarını ezer.
• Konsolda event conflict veya exception oluşur.
• Oyuncular yetkisi olduğu halde komut kullanamaz.
• Sunucu restart sonrası farklı davranır.

Çözüm için pluginler tek tek devre dışı bırakılarak test edilebilir. Ancak canlı sunucuda bunu yapmadan önce yedek alınmalı ve düşük oyuncu saatleri tercih edilmelidir.

8. Config Hatası Plugin Açılışını Engelleyebilir

Bazı pluginler config dosyasında YAML hatası varsa açılmaz. Özellikle boşluk girintileri YAML dosyalarında çok önemlidir.

Sık hatalar:

• Tab karakteri kullanmak
• İki nokta işaretinden sonra boşluk bırakmamak
• Tırnak gerektiren metni tırnaksız yazmak
• Türkçe karakter veya özel sembol nedeniyle dosya bozulması
• Config dosyasını eksik kaydetmek

Hatalı config dosyası varsa plugin klasörünü yedekleyip configi yeniden oluşturmak için plugin klasörü geçici olarak yeniden adlandırılabilir.

Sık Yapılan Hatalar

• Sunucu sürümüne uygun olmayan plugin kurmak
• Eksik dependency pluginlerini yüklememek
• GitHub source zip dosyasını plugin sanmak
• Java sürümünü kontrol etmemek
• /reload ile plugin kurmaya çalışmak
• YAML config dosyalarında tab kullanmak

FAQ

Plugin plugins klasöründe ama çalışmıyor, neden?
Sürüm uyumsuzluğu, eksik dependency, Java uyumsuzluğu veya config hatası olabilir. latest.log dosyası incelenmelidir.

UnsupportedClassVersionError ne demek?
Plugin daha yeni Java ile derlenmiştir. Sunucuda kullanılan Java sürümü eski kalmıştır.

/reload kullanmak güvenli mi?
Birçok plugin için önerilmez. Plugin kurulumu, kaldırma ve büyük config değişikliklerinde tam restart daha güvenlidir.

Güvenlik ve Operasyon Önerileri

• Pluginleri güvenilir kaynaklardan indirin.
• Canlı sunucuya plugin eklemeden önce test sunucusunda deneyin.
• Her plugin güncellemesinden önce plugins klasörünü yedekleyin.
• Gereksiz pluginleri kaldırarak saldırı yüzeyini azaltın.
• Plugin loglarını düzenli kontrol edin.

Bu makale PvPSunucusu için özel olarak hazırlanmıştır.