Konfiguration

Jede Option in der config.yml von Argus erklärt — was sie bewirkt und wie ein sinnvoller Wert aussieht.

Argus v1.1.1Paper · Purpur · Folia-safe1.21 – 1.21.x

Argus bringt eine Datei mit: plugins/Argus/config.yml. Änderungen übernimmst du mit /argus reload.

Speicher ist die Ausnahme

storage und network werden nur beim Start gelesen. Änderungen daran brauchen einen vollen Serverneustart, keinen Reload.

alerts

plugins/Argus/config.yml

alerts:  min-stars: 4  deterrent-mode: false  discord:    enabled: false    webhook: ""

Schlüssel	Standard	Wirkung
`min-stars`	`4`	Ab welcher Sterne-Bewertung (1–5) ein In-Game- und Discord-Alert ausgelöst wird. Bei großem Team auf 3 senken, bei „nur Notfälle" auf 5 anheben.
`deterrent-mode`	`false`	Zeigt überwachten Mitgliedern bei geloggten Aktionen einen Actionbar-Hinweis. Der Panopticon-Effekt — sichtbare Aufsicht unterdrückt Missbrauch, bevor er passiert.
`discord.enabled`	`false`	Kritische Alerts an einen Webhook senden.
`discord.webhook`	`""`	Webhook-URL des Kanals. Nimm einen privaten Team-Kanal — die Alerts nennen Namen.

response

YAML

response:  freeze-at-stars: 0

freeze-at-stars friert ein Mitglied automatisch ein, sobald es diese Bewertung erreicht. Eingefrorene Mitglieder können sich nicht bewegen und keine Befehle ausführen, bis ein Admin /argus unfreeze ausführt. 0 deaktiviert die Funktion.

Fang mit 0 an

Lass Argus eine Woche ohne Auto-Freeze laufen und schau, welche Bewertungen dein Team tatsächlich produziert. Ein Schwellwert, der einen legitimen Admin mitten in einer Wiederherstellung einfriert, kostet dich mehr Vertrauen, als er rettet.

signals

Dieser Abschnitt entscheidet, wann ein Signal auslöst. Wie stark es dann zählt, steht in scoring.weights.

YAML

signals:  low-staff-threshold: 1  burst:    window-seconds: 120    threshold: 15  favouritism-threshold: 5  ban-abuse:    window-minutes: 15  collusion:    threshold: 3    window-seconds: 30

Schlüssel	Standard	Wirkung
`low-staff-threshold`	`1`	Handeln, während so viele oder weniger andere Teammitglieder online sind, zählt als Off-Hours — das klassische Missbrauchsfenster.
`burst.window-seconds`	`120`	Länge des Burst-Fensters.
`burst.threshold`	`15`	Sensible Aktionen in diesem Fenster, bevor `burst_activity` auslöst.
`favouritism-threshold`	`5`	So oft an denselben Spieler gerichtete Gives oder Teleports zählen als Bevorzugung.
`ban-abuse.window-minutes`	`15`	Ein Ban, den ein anderes Teammitglied in diesem Fenster zurücknimmt, markiert den ursprünglichen Banner. Selbst-Rücknahmen zählen nicht.
`collusion.threshold`	`3`	Item-Übergaben an denselben Komplizen, bevor `collusion` auslöst.
`collusion.window-seconds`	`30`	Wie lange ein Drop einem Aufheben zugeordnet werden kann.

scoring

YAML

scoring:  half-life-hours: 72  weights:    item_injection: 26    inventory_access: 14    economy_injection: 22    honeypot_triggered: 40    silent_abuse: 12    off_hours: 8    burst_activity: 10    favoritism: 16    collusion: 30    ban_abuse: 18    legitimate_moderation: 4    peak_activity: 2

half-life-hours bestimmt, wie schnell Vertrauen zurückkommt: Der Score halbiert sich standardmäßig alle 72 Stunden sauberer Spielzeit. Verkürze den Wert auf einem großen Netzwerk, wo dein Team legitim viel anfasst; verlängere ihn, wenn Historie länger nachwirken soll.

Die Gewichte sind Punkte auf einem Score von 0 bis 100. Die Standardwerte sind so abgestimmt, dass:

ein einzelner Honeypot-Treffer (40) für sich genommen sofort ernst ist
normale Moderation (legitimate_moderation: 4) erfasst, aber nie belastend ist
Kontextsignale (off_hours: 8, peak_activity: 2) eine Aktion einfärben, statt sie zu definieren

Lies Threat-Score, bevor du hier etwas änderst — die Zahlen wirken zusammen.

feedback

YAML

feedback:  sounds: true  effects: true

Sound- und Partikel-Feinschliff für GUI, Alerts und Freezes. Rein kosmetisch; auf einem Server, wo das Team im selben Voice-Channel sitzt und die Klickgeräusche nerven, gern aus.

web-panel

YAML

web-panel:  enabled: false  port: 8787  bind: "0.0.0.0"  token: ""

Ein selbst gehostetes Rewind-Dashboard direkt aus dem Plugin. Lässt du token leer, erzeugt Argus eines und schreibt es beim Start in die Konsole. Details und Absicherung auf der Seite Web-Panel.

gui.heads

YAML

gui:  heads:    arrow_left: "bd69e06e5dadfd84e5f3d1c21063f2553b2fa945ee1d4d7152fdc5425bc12a9"    star_filled: "f2ba9ead97c8fb44b156ade9cb214ea912434a2cc47c4dec50f21021c75dd2d7"    action_freeze: "ca4cb39b983f8aa61f3716f8a61713e2da93feeec3feb684807279ff8b1e22ac"

Jedes GUI-Icon ist ein Custom Head und lässt sich austauschen. Ein Wert darf ein Textur-Hash sein (der hintere Teil einer textures.minecraft.net-URL) oder ein vollständiger Base64-Wert — beides bekommst du auf minecraft-heads.com. Leerer Wert = schlichtes Vanilla-Item als Fallback.

Austauschbare Schlüssel: arrow_left, arrow_right, star_filled, star_empty, tile_rating, tile_why, tile_rewind, action_teleport, action_freeze, action_clear, action_kick, action_refresh.

Geänderte Heads brauchen einen vollen Neustart, kein /argus reload — die ItemStacks werden einmal beim Laden der GUI-Klassen gebaut.

storage und network

Stehen separat auf Speicher & Netzwerk, weil sie auf einem Proxy der eine Fehler sind, bei dem still Daten verloren gehen.