Yapılandırma

config.yml başvurusu #

AnahtarVarsayılanAnlamı
languageenTüm mesajların ve bulgu açıklamalarının dili: en, tr, es, de, fr veya ru. Bulgu açıklamaları aynı dili kullanır; kodlar ve önem düzeyleri İngilizce kalır.
auto-scan-on-startuptrueSunucu açılışı bittikten birkaç saniye sonra otomatik olarak tam tarama çalıştırır.
auto-scan-delay-seconds5Otomatik tarama çalışmadan önce açılıştan sonra ne kadar beklenecek.
report.save-to-filetrueHer taramanın tam raporunu plugins/PluginGuard/reports/ içine kaydeder.
report.default-formattxtOtomatik kaydedilen rapor dosyası için kullanılan biçim: txt, json, yaml, md veya html.
report.keep-last30plugins/PluginGuard/reports/ içinde tutulacak kayıtlı rapor sayısı; eskileri silinir. 0 hepsini tutar.
discord-webhook-url(boş)Ayarlanırsa PluginGuard, bir tarama CRITICAL sorunlar bulduğunda bu Discord webhook'una kısa bir mesaj gönderir. Boş = devre dışı; bunu kendiniz ayarlamadıkça hiçbir şey gönderilmez.
show-optional-dependenciesfalseSohbet ve konsol listeleri, hemen her sunucuda normal olan eksik isteğe bağlı bağımlılık notlarını (MISSING_SOFT_DEPENDENCY) göstermez; bir satır kaç tanesinin dışarıda bırakıldığını söyler. Kaydedilen rapor ve /pluginguard export bunları her zaman içerir. true = her yerde listeler.
discord-only-new-findingstrueYalnızca daha önce duyurulmamış kritik bulguları duyurur (discord-state.txt içinde hatırlanır). false = kritik bulgu içeren her taramada duyurur.
integrations.plugin-updates.enabledfalseEklentilerinizin daha yeni sürümlerini arar (UPDATE_AVAILABLE, bilgi düzeyi). Her kaynağın neyi tanıyıp neyi tanıyamadığı için aşağıdaki "Güncelleme denetimi" bölümüne bakın.
integrations.plugin-updates.modrinthtrueGüncelleme denetimi açıkken: eklentileri dosya karmasıyla Modrinth'te tanımlar. Her taramada her eklenti jar'ının SHA-1 karmasını ve Minecraft sürümünüzü api.modrinth.com adresine gönderir; başka hiçbir şey göndermez.
integrations.plugin-updates.spigotmctrueGüncelleme denetimi açıkken: plugin.yml içinde website olarak spigotmc.org sayfasını belirten eklentileri arar (herkese açık Spiget yansısı üzerinden). Yalnızca kaynak numarası gönderilir.
integrations.plugin-updates.builtbybit-api-token(boş)Kendi BuiltByBit "Shared" API anahtarınız. Bununla plugin.yml içinde builtbybit.com sayfasını bağlayan eklentiler de denetlenir. Boş = BuiltByBit atlanır.
ignore[]İnceleyip sorun görmediğiniz belirli bulguları kalıcı olarak susturan "CODE:PluginName" (veya "CODE:*" / "*:PluginName") kuralları listesi.
checks.*hepsi trueKurulumunuza uymuyorsa bir denetim kategorisinin tamamını kapatın: java-version, api-version, dependencies, shaded-library-collision, native-library-duplicate, sqlite-jni-relocation, command-collision, bundled-server-api, loaded-state.
integrations.update-checker.*devre dışıİsteğe bağlı BuiltByBit güncelleme bildirimi; kendi "Shared" API anahtarınızı gerektirir, asla bir Private anahtar değil.

Güncelleme denetimi #

integrations.plugin-updates.enabled: true ile açın. Her tarama, eklenti jar'larınızdan kaçının eşleştirilebildiğini söyleyen bir satırla biter ve güncel olmayan her eklenti, bağlantısıyla birlikte bir UPDATE_AVAILABLE bulgusu alır.

Nelerin eşleştirilebildiği ve nelerin eşleştirilemediği:

  • Modrinth: dosya karmasıyla tam eşleşme. Modrinth'te yayımlanmış her eklenti (ve tam dosya) tanınır.
  • SpigotMC ve BuiltByBit: bir jar'ı dosyasından tanımlamanın yolu yoktur ve PluginGuard eklentileri asla adlarına bakarak tahmin etmez (yanlış bir tahmin başka bir eklenti için "güncelleme" bildirirdi). Bir eklenti yalnızca kendi plugin.yml dosyasında spigotmc.org veya builtbybit.com sayfasına bir website: bağlantısı varsa denetlenir. Bağlantı listelemeyen eklentiler (çoğu listelemez) denetlenmeden kalır; bu sitelerin hiçbirinde yayımlanmayan eklentiler de (örneğin başka yerde satılanlar) öyle.
  • Sürüm numaraları sayı olarak karşılaştırılır (1.9, 1.10'dan eskidir). Sayı olarak okunamayan sürümler asla bildirilmez.
  • Bu siteler bir güncellemenin hangi Minecraft sürümlerini desteklediğini söylemez; bu yüzden güncellemeden önce eklentinin sayfasını okuyun.
  • SpigotMC ve BuiltByBit yanıtları birkaç saat önbelleğe alınır; bir tarama en fazla 40 böyle istek yapar ve yaklaşık 25 saniye sonra vazgeçer. Eklenti jar'ları asla hiçbir yere yüklenmez.

Diller #

Bulgular, komut mesajları ve dışa aktarılan raporlar config.yml içindeki language değerini kullanır (en, tr, es, de, fr, ru). Bulgu kodları (örneğin SQLITE_JNI_RELOCATED) ve önem düzeyleri, yok sayma kuralları, destek talepleri ve arama sonuçları her sunucuda aynı görünsün diye her zaman İngilizce kalır. Her bulgu neyin yanlış olduğunu, ne zaman önem taşıdığını ve ne yapılacağını söyler. Metinleri plugins/PluginGuard/lang/ içinde düzenleyebilirsiniz; dosyanızda eksik olan bir metin jar'ın içindeki kopyadan alınır.