Statistiken hinzugefügt

Statistiken.md

@@ -0,0 +1,89 @@
+# Statistiken & Match-History
+
+---
+
+## Spieler-Statistiken
+
+Alle Statistiken werden dauerhaft in `plugins/Fussball/stats.yml` gespeichert und bleiben über Server-Neustarts hinaus erhalten.
+
+| Statistik | Beschreibung |
+| --- | --- |
+| `goals` | Erzielte Tore |
+| `ownGoals` | Eigentore |
+| `assists` | Vorlagen (letzter Pass vor einem Tor) |
+| `kicks` | Gesamtzahl der Schüsse |
+| `wins` | Gewonnene Spiele |
+| `losses` | Verlorene Spiele |
+| `draws` | Unentschieden |
+| `games` | Gespielte Spiele gesamt |
+| Siegquote | `wins / games × 100` (berechnet, nicht gespeichert) |
+
+---
+
+## Statistiken anzeigen
+
+```
+/fb stats                → Eigene Statistiken
+/fb stats Steve          → Statistiken von Steve
+/fb top goals            → Top 10 Torschützen
+/fb top wins             → Top 10 nach Siegen
+/fb top kicks            → Top 10 nach Schüssen
+```
+
+---
+
+## Statistiken zurücksetzen
+
+> Benötigt `fussball.admin`.
+
+```
+/fb stats reset Steve    ← Statistiken eines Spielers löschen
+/fb stats reset all      ← Alle Statistiken löschen
+```
+
+Nach dem Reset werden alle Hologramme automatisch aktualisiert.
+
+---
+
+## Match-History
+
+Die letzten **50 Spiele** werden dauerhaft in `plugins/Fussball/matchhistory.yml` gespeichert. Jeder Eintrag enthält:
+
+| Feld | Beschreibung |
+| --- | --- |
+| Arena | Name der Arena |
+| Datum | Datum und Uhrzeit des Spiels |
+| Ergebnis | Endstand Rot : Blau |
+| Sieger | „Rot", „Blau" oder „Unentschieden" |
+| Dauer | Spieldauer in Sekunden |
+| Ballbesitz | Prozentsatz pro Team |
+| Elfmeter | Elfmeter-Stand (falls gespielt) |
+| Tor-Events | Protokoll aller Tore (Minute, Torschütze, Team) |
+
+### History anzeigen
+
+```
+/fb history         ← Letzte 5 Spiele
+/fb history 10      ← Letzte 10 Spiele (max. 20)
+```
+
+Beispiel-Ausgabe:
+```
+#1 [21.03.2025 18:42] MyArena  3:1  │ Rot  │ Besitz R 58% / B 42%
+#2 [21.03.2025 17:15] MyArena  2:2  │ Unentschieden  │ Besitz R 50% / B 50%
+```
+
+---
+
+## Scoreboard (In-Game)
+
+Jeder Spieler erhält automatisch ein Sidebar-Scoreboard mit folgenden Informationen:
+
+* Aktueller Spielstand (Rot vs. Blau)
+* Verbleibende Zeit (MM:SS) und Halbzeit-Anzeige
+* Nachspielzeit (`+Xs Nachsp.`) wenn aktiv
+* Sonderstatus: HALBZEIT, VERLÄNGERUNG, ELFMETER
+* Team des Spielers
+* Spieleranzahl / Maximum
+* Ballbesitz-Prozent
+* Arena-Name