Hologramme hinzugefügt

Hologramme.md

@@ -0,0 +1,108 @@
+# Hologramme
+
+Hologramme zeigen Statistiken und Live-Spielstand als schwebende Texte im Spiel an. Jeder Spieler sieht sein eigenes `TextDisplay`-Entity. Die Anzeige aktualisiert sich alle 5 Ticks automatisch.
+
+---
+
+## Hologramm-Typen
+
+| Typ | ID-Suffix | Anzeige |
+| --- | --- | --- |
+| `goals` | `_goals` | Top-10-Torschützen-Bestenliste |
+| `wins` | `_wins` | Top-10-Siege-Bestenliste |
+| `match` | `_match` | Live-Spielstand, Phase und Spielzeit der Arena |
+
+**Seitenwechsel:** Rechtsklick auf ein `goals`- oder `wins`-Hologramm wechselt die Ansicht zwischen Toren und Siegen (nur für den klickenden Spieler).
+
+---
+
+## Hologramm erstellen
+
+Stehe an der gewünschten Position und führe folgenden Befehl aus:
+
+```
+/fb hologram set <arena> goals     ← Torschützen-Board
+/fb hologram set <arena> wins      ← Siege-Board
+/fb hologram set <arena> match     ← Live-Spielstand
+```
+
+Jede Arena kann genau ein Hologramm pro Typ haben. Ein erneutes `set` ersetzt das vorhandene.
+
+---
+
+## Hologramm entfernen
+
+```
+/fb hologram remove                         ← Nächstes Hologramm (< 5 Blöcke) entfernen
+/fb hologram delete <arena> goals|wins|match ← Gezielt löschen
+```
+
+---
+
+## Text anpassen
+
+Jede Zeile eines Hologramms ist individuell editierbar:
+
+```
+/fb hologram text <arena> goals 1 &6&l⚽ TOP TORSCHÜTZEN
+/fb hologram text <arena> match 3 &e{score}
+```
+
+Vorschau der aktuellen Zeilen mit Nummern:
+```
+/fb hologram textpreview <arena> goals
+```
+
+Standardtext wiederherstellen:
+```
+/fb hologram textreset <arena> goals
+```
+
+### Verfügbare Platzhalter
+
+| Hologramm-Typ | Platzhalter |
+| --- | --- |
+| `goals` / `wins` | `{title}` `{separator}` `{entries}` `{toggle}` |
+| `match` | `{header}` `{separator}` `{phase}` `{score}` `{time}` |
+
+---
+
+## Farben konfigurieren
+
+Alle Hologramm-Farben können in der `config.yml` unter `holograms:` angepasst werden. Es gelten `&`-Farbcodes.
+
+| Key | Standard | Beschreibung |
+| --- | --- | --- |
+| `goals-title-color` | `&6&l` | Titel Tore-Hologramm |
+| `goals-value-color` | `&4` | Tor-Anzahl in der Liste |
+| `wins-title-color` | `&2&l` | Titel Siege-Hologramm |
+| `wins-value-color` | `&2` | Siege-Anzahl in der Liste |
+| `name-color` | `&0` | Spielername in der Liste |
+| `label-color` | `&8` | Beschriftungen |
+| `separator-color` | `&8&m` | Trennlinie (durchgestrichen) |
+| `toggle-color` | `&8&o` | Umschalte-Hinweis |
+| `match-header-color` | `&e&l` | Match-Header |
+| `match-score-red` | `&c&l` | Rot-Team Spielstand |
+| `match-score-blue` | `&9&l` | Blau-Team Spielstand |
+| `match-time-color` | `&e` | Spielzeit |
+| `match-injury-color` | `&c` | Nachspielzeit |
+
+Änderungen werden nach `/fb hologram reload` wirksam.
+
+---
+
+## Alle Hologramme verwalten
+
+```
+/fb hologram list      ← Alle Hologramme auflisten
+/fb hologram reload    ← Alle Hologramme neu laden (z.B. nach Serverstart)
+```
+
+---
+
+## Technische Details
+
+* Pro Spieler wird eine eigene `TextDisplay`-Entity gespawnt (nur sichtbar für diesen Spieler)
+* Eine unsichtbare `Interaction`-Entity dient als Klick-Hitbox
+* Beim Server-Neustart werden verwaiste `fb_holo_*`-Entities automatisch bereinigt
+* Hologramm-Daten werden in `holograms.yml` gespeichert