Minecraft-Plugin TitleManager

🔌 Über TitleManager

TitleManager ist ein Minecraft-Plugin, das für Spieler sichtbare Präsentationselemente verwaltet: animierte Titel und Untertitel in der Bildschirmmitte, Actionbars, animierte Kopf- und Fußzeilen der Playerlist sowie ein konfigurierbares Sidebar-Scoreboard. Es dient als Präsentationsschicht für Server, die elegantere Join-Nachrichten, Ankündigungen und Live-Tab/Scoreboard-Anzeigen wünschen.

🎯 Zweck

Das Plugin bündelt Anzeige-Funktionen (Titles, Actionbars, Tab-List, Sidebars), damit Serverbetreiber Spielern konsistente, animierte und placeholder-basierte Informationen ohne eigene Programmierung präsentieren können. Es richtet sich an Serveradministratoren, die Join-/Willkommensnachrichten, rotierende Ankündigungen und eine dynamische TAB/Scoreboard-UI verwalten möchten.

⚙️ Funktionen

• Konfigurierbare Join- und First-Join-Titles sowie Actionbars mit Zeitoptionen und Varianten.
• Animierte und verlaufsfähige Kopf- und Fußzeilen der Playerlist mit Platzhaltern für Online-Zahlen, Welt-/Serverzeit und andere dynamische Werte.
• Konfigurierbares Sidebar-Scoreboard mit bis zu 15 animierten Zeilen, gestützt auf das Scoreboard-System des Servers.
• Broadcasts und geplante Ankündigungen, ausgegeben als Titles oder Actionbars.
• Animations-Engine mit wiederverwendbaren Animationsdateien und Vorschauen (der Animation-Playground ist in der offiziellen Dokumentation verfügbar).
• Placeholder-Integrationen (eingebaute TitleManager-Placeholders und Unterstützung externer Placeholder-Systeme, wenn vorhanden).
• Transaktionale Reloads: Konfigurations-Neuladevorgänge werden sicher angewendet und können zurückgesetzt werden, wenn die neue Konfiguration ungültig ist.
• Eine kleine Entwickler-API für optionale Integrationen und Plugin-zu-Plugin-Nutzung.

🧩 Für wen es gedacht ist

• Survival- und SMP-Server, die eine hochwertige Join-/Ankündigungs-UI wollen.
• Server, die Placeholders und externe Integrationen verwenden (für dynamische Werte in Anzeigen).
• Administratoren, die animierte Tab- und Scoreboard-Anzeigen ohne eigene Plugins benötigen.
• Entwickler, die Präsentationsfunktionen über die bereitgestellte API in andere Plugins integrieren möchten.

🏗️ Beispielanwendungen

• Zeige ein animiertes Willkommens-Title und eine Actionbar, wenn Spieler beitreten, mit einer anderen Nachricht beim ersten Join.
• Halte die Tab-Spielerliste lebendig, indem du Serverzeit, Online-Zahlen und Farbverlauf-Kopf- und Fußzeilen anzeigst.
• Wechsle animierte Ankündigungs-Titles oder Actionbars zeitgesteuert, um Events oder Regeln zu kommunizieren.
• Nutze das Sidebar-Scoreboard, um Ranglisten, Statistiken oder dynamische Serverinformationen anzuzeigen.

⌨️ Befehle

Hinweise: Die obigen Befehle sind vom Projekt dokumentiert. Spezifische Permission-Nodes wurden in den hier verwendeten Quellen nicht aufgelistet und sollten für die exakten Nodes und Standardwerte in der Plugin-Dokumentation nachgeschlagen werden.

⚙️ Installation

📥 Einrichtung

• Lade die Plugin-JAR aus dem Release des Projekts oder von der Ressourcen-Seite des Plugins herunter.
• Lege die JAR in das Verzeichnis plugins/ deines Servers.
• Starte den Server neu.
• Bearbeite die generierten Konfigurationsdateien unter plugins/TitleManager/, um Titles, Animationen und Playerlist-Einstellungen anzupassen.
• Verwende /tm reload, um Konfigurationsänderungen anzuwenden; das Plugin führt transaktionale Reloads durch, um fehlerhafte Konfigurationen nicht anzuwenden.

📦 Abhängigkeiten

• PlaceholderAPI (optionale Integration für externe Platzhalter).
• Vault (optional, wird für Platzhalterwerte verwendet, wenn vorhanden).
• BungeeCord (integrationsbewusstes Verhalten bei Proxy-Setups).

Diese Integrationen sind optional und werden verwendet, wenn sie vorhanden sind; das Plugin funktioniert auch ohne sie, kann deren Daten aber nutzen, wenn verfügbar.

🧠 Technische Hinweise

• Offizielle Runtime-Ziele umfassen Minecraft 1.8 bis 1.21.x (Projektmaterial verweist auf explizite Unterstützung bis 1.21.11). Das Verhalten variiert je nach Serverversion: Neuere Minecraft-Versionen nutzen moderne Bukkit/Paper-APIs, während Legacy-Versionen auf versionsspezifische Kompatibilitätsmodule angewiesen sind.
• TitleManager stellt eine kleine Bukkit-API für optionale Integrationen bereit und bietet generierte API-Dokumentation.
• Sichere Reload- und Diagnosebefehle helfen bei Konfiguration und Laufzeit-Fehlersuche.

🤝 Wann dieses Plugin nützlich ist

Wenn du zentralisierte, animierte und placeholder-gesteuerte Präsentationssteuerung (Titles, Actionbars, Tab-List und Sidebars) aus der Konfiguration statt aus eigenem Code verwalten möchtest, bietet TitleManager ein dokumentiertes Plugin und eine API, um diese UI-Elemente konsistent in deiner Serverumgebung bereitzustellen.