From 4a6c2a114c08113f6a98493f099f18830bfc3d94 Mon Sep 17 00:00:00 2001 From: M_Viper Date: Fri, 23 Jan 2026 09:36:00 +0000 Subject: [PATCH] Hologramme aktualisiert --- Hologramme.md | 91 +++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 67 insertions(+), 24 deletions(-) diff --git a/Hologramme.md b/Hologramme.md index 37541e7..a3989a0 100644 --- a/Hologramme.md +++ b/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` | ` ` | Erstellt ein neues Hologramm | +| `/holo create` | ` ` | Erstellt ein neues Hologramm (Seiten unterstützt) | | `/holo delete` | `` | 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. +### 📖 Die drei Teile des Befehls erklärt + +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) | -| `&f` | Weiß | `&r` | Reset (Normal) | +| `&b` | Aqua (Blau) | `&m` | ~~Durchgestrichen~~ | +| `&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: - -> **Wichtig:** Du musst die Pakete vorher mit `/papi ecloud download ` laden! +Das System unterstützt die volle Integration der **PlaceholderAPI**. +*Hinweis: Die entsprechenden PAPI-Extensions müssen auf dem Server installiert sein (`/papi ecloud download `).* | 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 ` 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! +- **Sichtbarkeit:** Der Text dreht sich automatisch immer zum Spieler hin (Billboard-Effekt). 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. \ No newline at end of file +* **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). \ No newline at end of file