Inhalt
- 🛠 Befehlsübersicht
- 🖱 Interaktive Seiten (Multi-Page)
- 🎨 Gestaltung & Farben
- 🚀 Platzhalter (PlaceholderAPI)
- 📋 Praxis-Beispiele
- 1. Willkommens-Hologramm (Statisch)
- 2. Netzwerk-Statistik (alle 10 Sek.)
- 3. Echtzeit-Uhr (jede Sekunde)
- 4. Interaktives Regelwerk (3 Seiten)
- 5. Persönliche Statistiken
- 6. Info-Board mit Leerzeile
- ❓ Tipps & Tricks
- 🔑 Berechtigungen & Technik
Hologramme
Das Hologramm-System von NexusLobby basiert auf der modernen TextDisplay-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
| Befehl | Argumente | Erklärung |
|---|---|---|
/holo create |
<id> <NONE|FAST|SLOW> <text> |
Erstellt ein neues Hologramm (Seiten unterstützt) |
/holo delete |
<id> |
Entfernt ein Hologramm permanent |
/holo reload |
– | Lädt alle Hologramme aus der holograms.yml neu |
📖 Die drei Teile von /holo create erklärt
ID: Ein eindeutiger Name (z.B. spawninfo), um das Hologramm später zu verwalten.
MODUS: Wie oft soll der Text aktualisiert werden?
| Modus | Intervall | Ideal für |
|---|---|---|
NONE |
Kein Update | Statische Texte – beste Performance |
SLOW |
~10 Sekunden | Spielerzahlen, Statistiken |
FAST |
~1 Sekunde | Echtzeit-Uhren, Live-Daten |
TEXT: Das, was die Spieler sehen sollen (Farben und Platzhalter erlaubt!).
\n= Neue Zeile (Zeilenumbruch);= Neue Seite (Seitenumbruch, Rechtsklick zum Blättern)
🖱 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 unabhängig von anderen.
- Interaction-Hitbox: Automatisch gespawnte, unsichtbare Hitbox (2 × 2 Blöcke) für einfaches Anklicken.
- Endlos-Schleife: Nach der letzten Seite springt das Hologramm beim nächsten Klick wieder auf Seite 1.
🎨 Gestaltung & Farben
Verwende das &-Symbol für Farbcodes und Formatierungen:
| Code | Farbe | Code | Stil |
|---|---|---|---|
&a |
Hellgrün | &l |
Fett |
&c |
Hellrot | &n |
Unterstrichen |
&e |
Gelb | &o |
Kursiv |
&b |
Aqua (Blau) | &m |
~~Durchgestrichen~~ |
&f |
Weiß | &k |
Magisch |
&6 |
Gold/Orange | &r |
Reset |
&d |
Pink/Magenta |
🚀 Platzhalter (PlaceholderAPI)
Das System unterstützt die volle Integration der PlaceholderAPI.
Hinweis: Die entsprechenden PAPI-Extensions müssen installiert sein (
/papi ecloud download <paket>).
| Platzhalter | Funktion | PAPI-Paket |
|---|---|---|
%player_name% |
Name des Betrachters | Player |
%bungee_total% |
Spieler im ganzen Netzwerk | Bungee |
%luckperms_prefix% |
Rang-Präfix (z.B. [Admin]) |
LuckPerms |
%server_time_HH:mm:ss% |
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 auf diesem Server | Server |
%viaversion_player_protocol_version% |
Client-Version (z.B. 1.21) |
ViaVersion |
📋 Praxis-Beispiele
1. Willkommens-Hologramm (Statisch)
/holo create welcome NONE &b&lWillkommen &f%player_name%!\n&7Schön, dass du auf &6Nexus &7spielst.
2. Netzwerk-Statistik (alle 10 Sek.)
/holo create stats SLOW &fNetzwerk-Status:\n&a%bungee_total% &7Spieler online
3. Echtzeit-Uhr (jede Sekunde)
/holo create uhr FAST &e&lAKTUELLE ZEIT\n&f%server_time_HH:mm:ss%
4. Interaktives Regelwerk (3 Seiten)
/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
/holo create mystats 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
/holo create info NONE &a&lNEWS\n \n&7Besuche unseren Discord:\n&d&ndiscord.nexus.de
❓ Tipps & Tricks
- Die Höhe: Hologramme spawnen genau an deinen Füßen. Springe in die Luft, während du den Befehl ausführst, damit der Text auf Augenhöhe schwebt.
- ID vergessen? Alle IDs stehen in
plugins/NexusLobby/holograms.yml. - Verschieben: Hologramme können nicht verschoben werden. Lösche das Hologramm mit
/holo delete <id>und erstelle es an der neuen Position neu. - Änderungen an der YAML? Nach manuellen Änderungen an
holograms.ymleinfach/holo reloadausführen – kein Server-Neustart nötig. - Billboard-Effekt: Der Text dreht sich automatisch immer zum Spieler hin und ist aus jeder Richtung lesbar.
- Multi-Page: Jeder Spieler blättert unabhängig – perfekt für Anleitungen und Regelwerke.
🔑 Berechtigungen & Technik
Permission: nexuslobby.hologram
Erlaubt /holo create, /holo delete und /holo reload.
Technik: Nutzt Display-Entities (keine Rüstungsständer!):
- Keine Kollision mit Spielern
- Text richtet sich immer zum Betrachter aus (Billboard-Effekt)
- Extrem ressourcenschonend für Client und Server
- Interaktive Hitbox für das Seiten-System (2 × 2 Blöcke)