diff --git a/Hologramme.md b/Hologramme.md new file mode 100644 index 0000000..9b1f07b --- /dev/null +++ b/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` | ` ` | Erstellt ein neues Hologramm | +| `/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. +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 ` 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 ` 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. \ No newline at end of file