Hologramme aktualisiert

Hologramme.md

@@ -1,54 +1,70 @@
 # 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.
+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 mit **interaktivem Seiten-System**.
 
 ---
 
-## 🛠 Befehlsübersicht (Quick-Start)
+## 🛠 Befehlsübersicht
 
 | Befehl | Argumente | Erklärung |
 |:-------|:----------|:----------|
-| `/holo create` | `<ID> <MODUS> <Text>` | Erstellt ein neues Hologramm |
+| `/holo create` | `<ID> <MODUS> <Text>` | Erstellt ein neues Hologramm (Seiten unterstützt) |
 | `/holo delete` | `<ID>` | Entfernt ein Hologramm permanent |
 
-### 📖 Die drei Teile des Befehls erklärt:
+### 📖 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.
+
+1. **ID:** Ein eindeutiger Name (z.B. `spawn_info`), um das Hologramm später zu löschen.
 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!).
+   * `\n` = Erzeugt eine neue Zeile (Zeilenumbruch).
+   * `;` = Erzeugt eine **neue Seite** (Seitenumbruch).
+
+---
+
+## 🖱 Interaktive Seiten (Multi-Page)
+
+Das System unterstützt mehrere Seiten pro Hologramm. Spieler können durch einen **Rechtsklick** auf das Hologramm zur nächsten Seite blättern.
+
+**Features:**
+* **Individuelle Ansicht:** Jeder Spieler sieht seine eigene Seite (Spieler A kann auf Seite 1 sein, während Spieler B Seite 3 liest).
+* **Interaction-Hitbox:** Das System spawnt automatisch eine unsichtbare Hitbox (2x2 Blöcke), damit das Hologramm einfach anzuklicken ist.
+* **Endlos-Schleife:** Nach der letzten Seite springt das Hologramm beim nächsten Klick wieder auf Seite 1.
 
 ---
 
 ## 🎨 Gestaltung & Farben
 
-Du kannst den Text mit Farbcodes verschönern. Nutze dafür das `&`-Symbol:
+Verwende das `&`-Symbol für Farbcodes und Formatierungen:
 
 | 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) |
+| `&b` | Aqua (Blau) | `&m` | ~~Durchgestrichen~~ |
-| `&f` | Weiß | `&r` | Reset (Normal) |
+| `&f` | Weiß | `&k` | Magisch (Verwirrt) |
+| `&6` | Gold/Orange | `&r` | Reset (Normal) |
+| `&d` | Pink/Magenta | | |
 
-**Zeilenumbruch:** Schreibe `\n` in den Text, um eine neue Zeile darunter zu beginnen.
+**Zeilenumbruch:** Schreibe `\n` in den Text, um eine neue Zeile darunter zu beginnen.  
+**Seitenumbruch:** Schreibe `;` um eine neue Seite zu beginnen.
 
 ---
 
 ## 🚀 Platzhalter (PlaceholderAPI)
 
-Wenn du das Plugin **PlaceholderAPI** installiert hast, kannst du dynamische Werte anzeigen lassen. Hier sind die 10 besten Codes:
+Das System unterstützt die volle Integration der **PlaceholderAPI**.  
-
+*Hinweis: Die entsprechenden PAPI-Extensions müssen auf dem Server installiert sein (`/papi ecloud download <name>`).*
-> **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` |
+| `%server_time_HH:mm%` | Aktuelle Uhrzeit (Stunden:Minuten) | `Server` |
 | `%player_ping%` | Ping des Spielers | `Player` |
 | `%vault_eco_balance_fixed%` | Kontostand (Coins) | `Vault` |
 | `%statistic_player_kills%` | Anzahl der Kills | `Statistic` |
@@ -58,40 +74,67 @@ Wenn du das Plugin **PlaceholderAPI** installiert hast, kannst du dynamische Wer
 
 ---
 
-## 📋 Praxis-Beispiele (Copy & Paste)
+## 📋 Praxis-Beispiele
 
 ### 1. Willkommens-Hologramm (Statisch)
-Zeigt jedem Spieler seinen eigenen Namen an.
+
+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.
+
+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.
+
+Zeigt eine flüssige digitale Uhr:
 ```bash
 /holo create uhr FAST &e&lAKTUELLE ZEIT\n&f%server_time_HH:mm:ss%
 ```
 
+### 4. Interaktives Regelwerk (3 Seiten)
+
+Erstellt ein Hologramm, bei dem man durch die Regeln blättern kann:
+```bash
+/holo create regeln NONE &6&lREGELN\n&7Willkommen %player_name%!\n&e[Rechtsklick für Seite 2];&c&lREGEL 1\n&fKein Beleidigen oder Spam!;&c&lREGEL 2\n&fRespektiere das Team!
+```
+
+### 5. Persönliche Statistiken
+
+Ein Hologramm, das jedem Spieler seine eigenen Daten anzeigt:
+```bash
+/holo create stats NONE &b&lDEINE STATS\n&7Name: &f%player_name%\n&7Rang: %luckperms_prefix%\n&7Coins: &e%vault_eco_balance_fixed%
+```
+
+### 6. Info-Board mit Leerzeile
+
+Nutze `\n \n` für eine optische Trennung:
+```bash
+/holo create info NONE &a&lNEWS\n \n&7Besuche unseren Discord:\n&d&ndiscord.nexus.de
+```
+
 ---
 
-## ❓ Tipps & Tricks für Anfänger
+## ❓ Tipps & Tricks
 
 - **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 (Billboard-Effekt). Er ist also aus jeder Richtung lesbar!
-- **Sichtbarkeit:** Der Text dreht sich automatisch immer zum Spieler hin. Er ist also aus jeder Richtung lesbar!
+- **Multi-Page Navigation:** Beim Rechtsklick auf ein mehrseitiges Hologramm sieht jeder Spieler seine eigene Seite - perfekt für Anleitungen und Regelwerke!
 
 ---
 
-## 🔑 Berechtigungen
+## 🔑 Berechtigungen & Technik
 
-`nexuslobby.hologram`: Erlaubt das Erstellen und Löschen von Hologrammen.
+* **Permission:** `nexuslobby.hologram` (Erlaubt `/holo create` und `/holo delete`)
+* **Technik:** Nutzt `Display-Entities` (keine Rüstungsständer!). Das bedeutet:
+  * Keine Kollision mit Spielern.
+  * Der Text richtet sich immer zum Betrachter aus (Billboard-Effekt).
+  * Extrem ressourcenschonend für den Client und den Server.
+  * Interaktive Hitbox für das Seiten-System (2x2 Blöcke).