Minecraft-Server mit Plugin HolographicDisplays

## 🔌 Über Holographic Displays Holographic Displays ist ein Minecraft-Plugin, das dauerhafte schwebende Hologramme bereitstellt, die Text und Items anzeigen können. Das Plugin bietet In-Game-Befehle zum Erstellen und Bearbeiten von Hologrammen und stellt eine Entwickler-API zur Integration von Hologrammen in andere Plugins bereit. ## 🎯 Zweck Das Plugin löst den Bedarf, schwebende Informationen, Beschriftungen, Menüs und visuelle Elemente in der Welt anzuzeigen, ohne dauerhafte sichtbare Entitäten zu erzeugen. Es ist nützlich für Serververwaltung, kosmetische Anzeigen, Menüs in der Welt und Integrationen, bei denen Plugins Spielern Daten an festen Orten anzeigen müssen. ## ⚙️ Funktionen - Benannte Hologramme an bestimmten Orten erstellen und entfernen. - Textzeilen für Hologramme hinzufügen, entfernen, setzen und einfügen. - Schwebende Items als Hologrammzeilen anzeigen (Unterstützung für schwebende Items). - Zeilen aus einer Textdatei in ein Hologramm einlesen. - Bilder aus einer Datei oder URL in ein Hologramm einlesen und darstellen (mit konfigurierbarer Symbolzuordnung und maximaler Breite). - Hologramme ausrichten, verschieben, kopieren und zu ihnen teleportieren. - Plugin-Konfiguration und gespeicherte Hologramme ohne manuelle Dateibearbeitung neu laden. - Entwickler-API für andere Plugins verfügbar, um Hologramme programmatisch zu erstellen und zu verwalten. ## 🧩 Für wen es gedacht ist - Server-Administratoren, die visuelle Anzeigen in der Welt möchten (SMP-, Survival- und Minigame-Server). - Plugin-Entwickler, die eine API benötigen, um Spielern Text/Items in der Welt anzuzeigen. - Staff-Teams, die Hologramme für Schilder, Menüs oder Informationsanzeigen verwenden. ## 🏗️ Beispielanwendungen - Ein Minigame zeigt die aktuellen Punkte über jeder Arena mithilfe von Hologrammen an. - Eine Server-Lobby zeigt Serverregeln und Klick-zum-Teleport-Items als schwebende Zeilen an. - Eine Plugin-Integration schreibt dynamische Spielerstatistiken an einem festen Ort auf ein Hologramm. ## ⌨️ Befehle | **Befehl** | **Beschreibung** | **Berechtigung** | **Zugriff** | |---|---|---:|:---| | `/hd` | Hauptbefehl; zeigt Plugin-Infos und die Version an. | keine (für alle zugänglich) | Spieler | | `/hd help` | Zeigt verfügbare Befehle und kurze Hilfe an. | keine (für alle zugänglich) | Spieler | | `/hd create <hologramName> [text]` | Erstellt ein neues Hologramm an deinem Standort. | `holographicdisplays.create` | Admin | | `/hd delete <hologram>` | Löscht ein benanntes Hologramm. | `holographicdisplays.delete` | Admin | | `/hd list [page]` | Listet vorhandene Hologramme und Standorte auf. | `holographicdisplays.list` | Admin | | `/hd near <radius>` | Listet Hologramme in deiner Nähe innerhalb des Radius auf. | `holographicdisplays.near` | Admin | | `/hd teleport <hologram>` | Teleportiert dich zu einem Hologramm-Standort. | `holographicdisplays.teleport` | Admin | | `/hd align <axis> <hologram> <reference>` | Richtet ein Hologramm an einem anderen auf der angegebenen Achse aus. | `holographicdisplays.align` | Admin | | `/hd movehere <hologram>` | Verschiebt ein Hologramm zu deiner Fußposition. | `holographicdisplays.movehere` | Admin | | `/hd edit <hologram>` | Öffnet Bearbeitungsoptionen für ein Hologramm. | `holographicdisplays.edit` | Admin | | `/hd addline <hologram> <text>` | Fügt einem Hologramm eine Textzeile hinzu. | `holographicdisplays.addline` | Admin | | `/hd removeline <hologram> <number>` | Entfernt eine nummerierte Zeile aus einem Hologramm. | `holographicdisplays.removeline` | Admin | | `/hd setline <hologram> <number> <newText>` | Ändert den Text einer bestimmten Zeile. | `holographicdisplays.setline` | Admin | | `/hd insertline <hologram> <number> <text>` | Fügt nach dem angegebenen Index eine Zeile ein. | `holographicdisplays.insertline` | Admin | | `/hd info <hologram>` | Gibt den Inhalt des Hologramms mit Zeilennummern aus. | `holographicdisplays.info` | Admin | | `/hd copy <from> <to>` | Kopiert Inhalte von einem Hologramm in ein anderes. | `holographicdisplays.copy` | Admin | | `/hd readtext <hologram> <file>` | Liest Zeilen aus einer Datei in ein Hologramm ein. | `holographicdisplays.readtext` | Admin | | `/hd readimage <hologram> <image> <width> [-a]` | Rendert ein Bild aus Datei oder URL in das Hologramm. | `holographicdisplays.readimage` | Admin | | `/hd reload` | Lädt Konfiguration und gespeicherte Hologramme neu. | `holographicdisplays.reload` | Admin | Hinweis: In der Dokumentation wird angegeben, dass jeder Unterbefehl eine eigene Berechtigung hat (z. B. erfordert `/hd list` `holographicdisplays.list`). Der Hauptbefehl `/hd` ist für alle zugänglich. ## 🔐 Berechtigungen | **Berechtigung** | **Beschreibung** | **Standard** | |---|---|---:| | `holographicdisplays.<subcommand>` | Einzelberechtigung für jeden `/hd`-Unterbefehl (Beispiel: `holographicdisplays.list`). | nicht angegeben | | `holographicdisplays.update` | Update-Benachrichtigungen beim Beitritt erhalten, wenn in der Konfiguration aktiviert. | nicht angegeben | | `holographicdisplays.*` | Gewährt alle holographicdisplays-Berechtigungen (falls vom Berechtigungs-Plugin unterstützt). | nicht angegeben | ## ⚙️ Installation ### 📥 Einrichtung - Lade die offizielle Plugin-JAR aus einem vertrauenswürdigen Katalog herunter. - Lege die JAR in das Verzeichnis `plugins/` des Servers für Bukkit/Spigot. - Starte den Server neu und prüfe die Konsole, um zu bestätigen, dass das Plugin geladen wurde. ### 📦 Abhängigkeiten - Im offiziellen Dokumentationsüberblick sind keine erforderlichen Abhängigkeiten aufgeführt; prüfe bei der Installation die Download-Seite auf optionale Integrationen. ### 🧾 Konfiguration - Das Plugin unterstützt Konfigurationsdateien und gespeicherte Hologramme; verwende den bereitgestellten Neu-laden-Befehl, um Änderungen nach dem Bearbeiten von Dateien anzuwenden. - Bilddarstellung und Symbolzuordnung sind über die Plugin-Konfiguration einstellbar. ## 🧠 Technische Hinweise - Die offizielle Dokumentation enthält einen Upgrade-Leitfaden für Minecraft 1.13+ bezüglich Änderungen bei Materialnamen sowie beim Umgang mit Bildern/Icons. - Eine Entwickler-API ist für Plugin-Integrationen dokumentiert. ## 🤝 Wann dieses Plugin nützlich ist Wenn du dauerhafte, bearbeitbare Anzeigen in der Welt für Informationen, Menüs oder Plugin-Integrationen brauchst, bietet Holographic Displays benannte Hologramme, Datei-/Bildimport und eine API, damit andere Plugins Hologramme zuverlässig erstellen und aktualisieren können.

Plugins