Genel bakış

Yayında v1.2.1
Platformlar
Paper, Purpur, Spigot, Folia
Minecraft
1.21 – 1.21.11, 26.1, 26.2
Java
21
Gerekli
Yok
İsteğe bağlı
Yok

Paper/Spigot sunucuları için gerçek bytecode düzeyinde eklenti uyumluluk tarayıcısı. PluginGuard çevrimiçi bir veritabanından veya sürüm metni karşılaştırmasından tahmin yürütmez; plugins/ klasörünüzdeki her jar'ı açar ve gerçek baytları inceler: derlenmiş sınıf dosyası sürümü, bildirilen plugin.yml/paper-plugin.yml verileri, paketlenmiş/shade edilmiş kütüphaneler, gömülü yerel ikili dosyalar ve kurulu eklentileriniz arasındaki bağımlılık grafiği. Hiçbir şey çalıştırılmaz ve hiçbir şey değiştirilmez; PluginGuard yalnızca okur.

Neden var #

Aşağıdaki denetimlerin her biri, "sürüm numarası doğru görünüyor mu" diye bakan bir denetleyicinin kaçıracağı, bir eklentinin sessizce bozulabileceği gerçek ve belirli bir yolu modeller:

  • Bir eklenti güncellenir ve artık sunucunuzun çalıştırdığından daha yeni bir Java sürümü için derlenmiştir; yalnızca yanlış davranmakla kalmaz, JVM sınıfı doğrudan yüklemeyi reddeder (UnsupportedClassVersionError) ve eklenti kafa karıştırıcı bir yığın izi ile etkinleşemez.
  • Bir eklenti SQLite JDBC sürücüsünü shade eder ve derleme sırasında org.sqlite paketini yeniden konumlandırır (çok yaygın bir shading hatası); yerel JNI bağlaması ada dayalıdır, bu yüzden bu, eklenti veritabanına ilk dokunduğunda çalışma zamanında UnsatisfiedLinkError ile sessizce bozulur; çoğu zaman sunucu uzun süre sorunsuz çalıştıktan sonra.
  • İki eklenti plugin.yml dosyalarında aynı komut adını bildirir; yalnızca biri yalın komuta gerçekten sahip olur, diğeri sessizce /plugin:command biçimine döner ve yöneticiler bir komutun neden "çalışmadığını" anlamaya bir saat harcar.
  • Bir eklenti kurulu olmayan ya da sonraki bir güncellemede kaldırılmış bir zorunlu bağımlılık bildirir; etkinleşemez ve gerçek neden, uzun bir başlangıç günlüğünde gözden kaçması kolay tek satırlık bir günlük mesajında gömülüdür.

Kurulum #

  1. PluginGuard.jar dosyasını plugins/ klasörünüze bırakın.
  2. Sunucunuzu başlatın (veya yeniden başlatın). PluginGuard'ın sıfır zorunlu bağımlılığı vardır ve kurulum gerektirmez; config.yml ve lang/ içindeki dil dosyaları (en, tr, es, de, fr, ru) makul varsayılanlarla otomatik oluşturulur ve siz kapatmadıkça ilk taramasını başlangıçtan 5 saniye sonra otomatik çalıştırır.
  3. Konsol çıktısını okuyun (veya istediğiniz zaman /pluginguard scan komutunu kendiniz çalıştırın).

Uyumluluk #

  • Minecraft 1.21 ile 1.21.11 arası, ayrıca 26.1 ve 26.2. Java 21 veya daha yenisi. Paper, Spigot, Paper uyumlu çatallar ve Folia.
  • PluginGuard eklentileri sunucunun bildirdiği Java ve API sürümüne göre karşılaştırır; bu yüzden sunucu daha yeni bir Minecraft/Java sürümü çalıştırdığında da doğru denetler.

Destek #

Destek talepleri ve hata bildirimleri için lütfen resmi BuiltByBit kaynak sayfasının Tartışma sekmesini veya BuiltByBit doğrudan mesajlarını kullanın.