Hologramme aktualisiert
@@ -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:
|
||||
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.
|
||||
**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 <Name>` 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 <name>`).*
|
||||
|
||||
| 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. 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.
|
||||
* **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).
|
||||
Reference in New Issue
Block a user