M_Viper/NexusLobby

Fork 0

Table of Contents

Hologramme

🛠 Befehlsübersicht

📖 Die drei Teile des Befehls erklärt

🖱 Interaktive Seiten (Multi-Page)
🎨 Gestaltung & Farben
🚀 Platzhalter (PlaceholderAPI)
📋 Praxis-Beispiele

1. Willkommens-Hologramm (Statisch)
2. Netzwerk-Statistik (Aktualisiert alle 10 Sek.)
3. Echtzeit-Uhr (Aktualisiert 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 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

Befehl	Argumente	Erklärung
`/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

ID: Ein eindeutiger Name (z.B. spawn_info), um das Hologramm später zu löschen.
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).
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

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)	`&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)

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 (Stunden:Minuten)	`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

1. Willkommens-Hologramm (Statisch)

Zeigt jedem Spieler seinen eigenen Namen an:

/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:

/holo create stats SLOW &fNetzwerk-Status:\n&a%bungee_total% &7Spieler online

3. Echtzeit-Uhr (Aktualisiert jede Sekunde)

Zeigt eine flüssige digitale Uhr:

/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:

/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:

/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:

/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 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!
Multi-Page Navigation: Beim Rechtsklick auf ein mehrseitiges Hologramm sieht jeder Spieler seine eigene Seite - perfekt für Anleitungen und Regelwerke!

🔑 Berechtigungen & Technik

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).