config hinzugefügt

config.md

@@ -0,0 +1,147 @@
+# config.yml
+
+Die Hauptkonfiguration befindet sich unter `plugins/Fussball/config.yml`. Änderungen werden nach einem Server-Neustart oder `/fb hologram reload` (nur Hologramm-Farben) übernommen.
+
+---
+
+## defaults
+
+Standard-Werte für neue Arenen. Können pro Arena mit `/fb setup` überschrieben werden.
+
+```yaml
+defaults:
+  min-players: 2       # Mindestspielerzahl für Auto-Start
+  max-players: 10      # Maximale Spielerzahl
+  game-duration: 300   # Halbzeit-Dauer in Sekunden (300 = 5 Min)
+```
+
+---
+
+## ball
+
+Physik-Parameter des Balls.
+
+```yaml
+ball:
+  kick-power: 1.1           # Schussstärke (normal)
+  sprint-kick-power: 1.8    # Schussstärke beim Sprinten
+  kick-vertical: 0.3        # Vertikale Komponente eines Schusses
+  charged-min-power: 1.3    # Mindeststärke aufgeladener Schuss
+  charged-max-power: 3.8    # Maximalstärke aufgeladener Schuss (volle Ladung)
+```
+
+---
+
+## gameplay
+
+Spielregeln und Mechaniken.
+
+```yaml
+gameplay:
+  offside-enabled: true           # Abseits-Erkennung an/aus
+  foul-detection-enabled: true    # Foul-System an/aus
+  freekick-distance: 5.0          # Mindestabstand Gegner beim Freistoß (Blöcke)
+  freekick-duration: 600          # Ticks bis Freistoß automatisch freigegeben wird
+
+  goalkeeper-hold-range: 2.5      # Max. Abstand TW→Ball zum Fangen
+  goalkeeper-throw-power: 1.8     # Wurfstärke des Torwarts
+
+  out-of-bounds-tolerance: 2.0    # Extra-Blöcke außerhalb Feld vor Aus-Erkennung
+  out-of-bounds-countdown: 5      # Sekunden bis Disqualifikation bei Feldverlassen
+
+  penalty-area-depth: 16          # Tiefe des auto-berechneten Strafraums (Blöcke Richtung Feld)
+  penalty-area-margin: 6          # Seitliche Ausdehnung des Strafraums jenseits der Torpfosten
+
+  header-range: 1.8               # Max. Abstand Spieler→Ball für Kopfball
+  header-min-height: 0.8          # Min. Ballhöhe über Spielerfüßen für Kopfball
+  header-max-height: 2.3          # Max. Ballhöhe über Spielerfüßen für Kopfball
+  header-power: 1.3               # Schussstärke eines Kopfballs
+  header-cooldown: 10             # Ticks Abklingzeit zwischen zwei Kopfbällen (selber Spieler)
+
+  afk-warn-seconds: 20            # Sekunden Stillstand bis AFK-Warnung
+  afk-kick-seconds: 40            # Sekunden Stillstand bis Rauswurf
+  afk-move-threshold: 0.5         # Mindestbewegung pro Sekunde (Blöcke)
+
+  injury-time-enabled: true
+  injury-time-per-goal: 30        # Sekunden Nachspielzeit pro Tor
+  injury-time-per-card: 15        # Sekunden pro Karte
+  injury-time-per-foul: 5         # Sekunden pro Foul
+  injury-time-per-out: 3          # Sekunden pro Aus-Situation
+
+  kickoff-circle-radius: 9.15     # Pflichtabstand Gegner beim Anstoß (Blöcke)
+  handball-enabled: true          # Handspiel-Erkennung an/aus
+  long-pass-distance: 20.0        # Ab dieser Distanz (Blöcke) gilt ein Pass als Langpass
+```
+
+---
+
+## atmosphere
+
+```yaml
+atmosphere:
+  enabled: true
+  goal-fireworks: 5    # Anzahl Feuerwerke bei einem Tor (0 = deaktiviert)
+```
+
+---
+
+## holograms
+
+Farben der Hologramme. Verwende `&`-Codes. Änderungen gelten nach `/fb hologram reload`.
+
+```yaml
+holograms:
+  goals-title-color:  "&6&l"    # Titel Tore-Hologramm        (Gold + Fett)
+  goals-value-color:  "&4"      # Tor-Anzahl                  (Dunkelrot)
+  wins-title-color:   "&2&l"    # Titel Siege-Hologramm       (Dunkelgrün + Fett)
+  wins-value-color:   "&2"      # Siege-Anzahl                (Dunkelgrün)
+  name-color:         "&0"      # Spielername                 (Schwarz)
+  label-color:        "&8"      # Beschriftungen              (Dunkelgrau)
+  separator-color:    "&8&m"    # Trennlinie (durchgestrichen)
+  toggle-color:       "&8&o"    # Umschalte-Hinweis           (Kursiv Dunkelgrau)
+  match-header-color: "&e&l"    # Match-Header                (Gelb + Fett)
+  match-score-red:    "&c&l"    # Rot-Team Spielstand         (Rot + Fett)
+  match-score-blue:   "&9&l"    # Blau-Team Spielstand        (Blau + Fett)
+  match-time-color:   "&e"      # Spielzeit                   (Gelb)
+  match-injury-color: "&c"      # Nachspielzeit               (Rot)
+```
+
+---
+
+## messages
+
+Alle Broadcast-Texte sind vollständig anpassbar. Standard-Farbcodes (`§`) werden unterstützt.
+
+**Verfügbare Platzhalter je nach Nachricht:**
+
+| Platzhalter | Bedeutung |
+| --- | --- |
+| `{player}` | Spielername |
+| `{team}` | Teamname |
+| `{score}` | Spielstand (z. B. `2 : 1`) |
+| `{time}` | Minute / Zeit |
+| `{reason}` | Grund (z. B. für Karte) |
+| `{n}` | Zahl |
+
+**Wichtige Nachrichten-Keys:**
+
+| Key | Beschreibung |
+| --- | --- |
+| `prefix` | Nachrichten-Prefix |
+| `game-start` | Anpfiff-Titel |
+| `goal-banner` | Tor-Ankündigung |
+| `goal-scorer` | Torschütze |
+| `halftime` | Halbzeit-Meldung |
+| `offside` | Abseits-Meldung |
+| `foul` | Foul-Meldung |
+| `yellow-card` | Gelbe Karte |
+| `red-card` | Rote Karte |
+| `freekick` | Freistoß-Ankündigung |
+| `own-goal` | Eigentor-Meldung |
+| `injury-time` | Nachspielzeit-Anzeige |
+| `out-side` | Einwurf-Meldung |
+| `out-corner` | Eckstoß-Meldung |
+| `out-goal-kick` | Abstoß-Meldung |
+| `report-header` | Matchbericht-Kopf |
+
+Die vollständige Liste aller Keys befindet sich direkt in der `config.yml`.