Hologramme hinzugefügt

Hologramme.md

@@ -0,0 +1,97 @@
+Hologramme
+
+Das Hologramm-System von **NexusLobby** basiert auf der modernen `TEXT_DISPLAY` Engine von Minecraft (ab Version 1.19.4). Diese Technik ist extrem performant, erzeugt keine Lags und bietet gestochen scharfe Texte.
+
+---
+
+## 🛠 Befehlsübersicht (Quick-Start)
+
+| Befehl | Argumente | Erklärung |
+|:-------|:----------|:----------|
+| `/holo create` | `<ID> <MODUS> <Text>` | Erstellt ein neues Hologramm |
+| `/holo delete` | `<ID>` | Entfernt ein Hologramm permanent |
+
+### 📖 Die drei Teile des Befehls erklärt:
+1. **ID:** Ein Name für das Hologramm (z.B. `spawn`), damit du es später löschen kannst.
+2. **MODUS:** Wie oft soll der Text aktualisiert werden?
+   * `NONE`: Der Text bleibt immer gleich (Beste Performance).
+   * `SLOW`: Der Text aktualisiert sich alle 10 Sekunden (Ideal für Spielerzahlen).
+   * `FAST`: Der Text aktualisiert sich jede Sekunde (Ideal für die Uhrzeit).
+3. **TEXT:** Das, was die Spieler sehen sollen (Farben und Platzhalter erlaubt!).
+
+---
+
+## 🎨 Gestaltung & Farben
+
+Du kannst den Text mit Farbcodes verschönern. Nutze dafür das `&`-Symbol:
+
+| Code | Farbe | Code | Stil |
+|:-----|:------|:-----|:-----|
+| `&a` | Hellgrün | `&l` | **Fett (Bold)** |
+| `&c` | Hellrot | `&n` | __Unterstrichen__ |
+| `&e` | Gelb | `&o` | *Kursiv (Italic)* |
+| `&b` | Aqua (Blau) | `&k` | Magisch (Verwirrt) |
+| `&f` | Weiß | `&r` | Reset (Normal) |
+
+**Zeilenumbruch:** Schreibe `\n` in den Text, um eine neue Zeile darunter zu beginnen.
+
+---
+
+## 🚀 Platzhalter (PlaceholderAPI)
+
+Wenn du das Plugin **PlaceholderAPI** installiert hast, kannst du dynamische Werte anzeigen lassen. Hier sind die 10 besten Codes:
+
+> **Wichtig:** Du musst die Pakete vorher mit `/papi ecloud download <Name>` laden!
+
+| Platzhalter | Funktion | PAPI Paket |
+|:------------|:---------|:-----------|
+| `%player_name%` | Zeigt den Namen des Betrachters | `Player` |
+| `%bungee_total%` | Spieler im ganzen Netzwerk | `Bungee` |
+| `%luckperms_prefix%` | Der Rang-Präfix (z.B. [Admin]) | `LuckPerms` |
+| `%server_time_HH:mm%` | Aktuelle Uhrzeit | `Server` |
+| `%player_ping%` | Ping des Spielers | `Player` |
+| `%vault_eco_balance_fixed%` | Kontostand (Coins) | `Vault` |
+| `%statistic_player_kills%` | Anzahl der Kills | `Statistic` |
+| `%server_ram_used%` | RAM-Verbrauch des Servers | `Server` |
+| `%server_online%` | Spieler nur auf diesem Server | `Server` |
+| `%multiversion_version%` | Version des Spielers (z.B. 1.21) | `ViaVersion` |
+
+---
+
+## 📋 Praxis-Beispiele (Copy & Paste)
+
+### 1. Willkommens-Hologramm (Statisch)
+Zeigt jedem Spieler seinen eigenen Namen an.
+```bash
+/holo create welcome NONE &b&lWillkommen &f%player_name%!\n&7Schön, dass du auf &6Nexus &7spielst.
+```
+
+### 2. Netzwerk-Statistik (Aktualisiert alle 10 Sek.)
+Perfekt, um die Spielerzahlen aktuell zu halten.
+```bash
+/holo create stats SLOW &fNetzwerk-Status:\n&a%bungee_total% &7Spieler online
+```
+
+### 3. Echtzeit-Uhr (Aktualisiert jede Sekunde)
+Zeigt eine flüssige digitale Uhr.
+```bash
+/holo create uhr FAST &e&lAKTUELLE ZEIT\n&f%server_time_HH:mm:ss%
+```
+
+---
+
+## ❓ Tipps & Tricks für Anfänger
+
+- **Die Höhe:** Hologramme spawnen genau an deinen Füßen. Springe in die Luft, während du den Befehl abschickst, damit das Hologramm auf Augenhöhe schwebt.
+
+- **ID vergessen?** Schau in die Datei `plugins/NexusLobby/holograms.yml`. Dort stehen alle IDs deiner Hologramme.
+
+- **Verschieben:** Du kannst ein Hologramm nicht "schieben". Lösche es mit `/holo delete <ID>` und erstelle es an der neuen Stelle neu.
+
+- **Sichtbarkeit:** Der Text dreht sich automatisch immer zum Spieler hin. Er ist also aus jeder Richtung lesbar!
+
+---
+
+## 🔑 Berechtigungen
+
+`nexuslobby.hologram`: Erlaubt das Erstellen und Löschen von Hologrammen.