Konfiguration
config.yml-Referenz #
| Schlüssel | Standard | Bedeutung |
|---|---|---|
language | en | Sprache aller Nachrichten und Befundbeschreibungen: en, tr, es, de, fr oder ru. Befundbeschreibungen nutzen dieselbe Sprache; Codes und Schweregrade bleiben Englisch. |
auto-scan-on-startup | true | Führt einige Sekunden nach dem Ende des Serverstarts automatisch einen vollständigen Scan aus. |
auto-scan-delay-seconds | 5 | Wie lange nach dem Start gewartet wird, bevor der automatische Scan läuft. |
report.save-to-file | true | Speichert den vollständigen Bericht jedes Scans in plugins/PluginGuard/reports/. |
report.default-format | txt | Format der automatisch gespeicherten Berichtsdatei: txt, json, yaml, md oder html. |
report.keep-last | 30 | Anzahl der gespeicherten Berichte, die in plugins/PluginGuard/reports/ behalten werden; ältere werden gelöscht. 0 behält alle. |
discord-webhook-url | (leer) | Falls gesetzt, postet PluginGuard eine kurze Nachricht an diesen Discord-Webhook, wenn ein Scan CRITICAL-Probleme findet. Leer = deaktiviert; es wird nie etwas gesendet, solange du das nicht selbst festlegst. |
show-optional-dependencies | false | Chat- und Konsolenlisten lassen die Hinweise zu fehlenden optionalen Abhängigkeiten (MISSING_SOFT_DEPENDENCY) weg, die auf fast jedem Server normal sind; eine Zeile nennt, wie viele ausgelassen wurden. Der gespeicherte Bericht und /pluginguard export enthalten sie immer. true = überall auflisten. |
discord-only-new-findings | true | Meldet nur kritische Befunde, die noch nicht gemeldet wurden (gemerkt in discord-state.txt). false = meldet bei jedem Scan mit kritischen Befunden. |
integrations.plugin-updates.enabled | false | Sucht nach neueren Versionen deiner Plugins (UPDATE_AVAILABLE, Stufe Info). Was jede Quelle erkennen kann und was nicht, steht unten unter „Update-Prüfung“. |
integrations.plugin-updates.modrinth | true | Bei aktivierter Update-Prüfung: identifiziert Plugins auf Modrinth anhand des Datei-Hashs. Sendet bei jedem Scan den SHA-1-Hash jedes Plugin-Jars und deine Minecraft-Version an api.modrinth.com - sonst nichts. |
integrations.plugin-updates.spigotmc | true | Bei aktivierter Update-Prüfung: sucht Plugins, die ihre spigotmc.org-Seite als website in plugin.yml angeben (über den öffentlichen Spiget-Spiegel). Es wird nur die Ressourcennummer gesendet. |
integrations.plugin-updates.builtbybit-api-token | (leer) | Dein eigener BuiltByBit-„Shared“-API-Token. Damit werden auch Plugins geprüft, die ihre builtbybit.com-Seite in plugin.yml verlinken. Leer = BuiltByBit wird übersprungen. |
ignore | [] | Eine Liste von Regeln "CODE:PluginName" (oder "CODE:*" / "*:PluginName"), um bestimmte Befunde, die du geprüft hast und akzeptierst, dauerhaft stummzuschalten. |
checks.* | alle true | Schaltet eine ganze Prüfkategorie aus, wenn sie für dein Setup nicht zutrifft: java-version, api-version, dependencies, shaded-library-collision, native-library-duplicate, sqlite-jni-relocation, command-collision, bundled-server-api, loaded-state. |
integrations.update-checker.* | deaktiviert | Optionale BuiltByBit-Update-Benachrichtigung; benötigt deinen eigenen „Shared“-API-Token, nie einen privaten. |
Update-Prüfung #
Schalte sie mit integrations.plugin-updates.enabled: true ein. Jeder Scan endet dann mit einer Zeile, die sagt, wie viele deiner Plugin-Jars zugeordnet werden konnten, und jedes veraltete Plugin erhält einen Befund UPDATE_AVAILABLE mit einem Link.
Was zugeordnet werden kann und was nicht:
- Modrinth: exakte Übereinstimmung per Datei-Hash. Jedes auf Modrinth veröffentlichte Plugin (und die exakte Datei) wird erkannt.
- SpigotMC und BuiltByBit: Ein Jar lässt sich nicht anhand seiner Datei identifizieren, und PluginGuard errät Plugins nie anhand des Namens (eine falsche Vermutung würde ein „Update“ für ein anderes Plugin melden). Ein Plugin wird nur geprüft, wenn seine eigene
plugin.ymleinenwebsite:-Link zu seiner spigotmc.org- oder builtbybit.com-Seite enthält. Plugins, die keinen angeben - viele tun das nicht - bleiben ungeprüft, ebenso Plugins, die auf keiner dieser Seiten veröffentlicht sind (zum Beispiel anderswo verkaufte). - Versionsnummern werden als Zahlen verglichen (1.9 ist älter als 1.10). Versionen, die sich nicht als Zahlen lesen lassen, werden nie gemeldet.
- Diese Seiten verraten nicht, welche Minecraft-Versionen ein Update unterstützt; lies daher die Seite des Plugins, bevor du aktualisierst.
- Antworten von SpigotMC und BuiltByBit werden einige Stunden zwischengespeichert; ein Scan stellt höchstens 40 solche Anfragen und gibt nach etwa 25 Sekunden auf. Plugin-Jars werden nie irgendwohin hochgeladen.
Sprachen #
Befunde, Befehlsnachrichten und exportierte Berichte nutzen die language aus config.yml (en, tr, es, de, fr, ru). Befundcodes (zum Beispiel SQLITE_JNI_RELOCATED) und Schweregrade bleiben immer Englisch, damit Ignorier-Regeln, Support-Anfragen und Suchergebnisse auf jedem Server gleich aussehen. Jeder Befund sagt, was falsch ist, wann es darauf ankommt und was man dagegen tun kann. Du kannst die Texte in plugins/PluginGuard/lang/ bearbeiten; ein Text, der in deiner Datei fehlt, wird aus der Kopie im Jar übernommen.