Minecraft-plugin TitleManager

🔌 Om TitleManager

TitleManager er et Minecraft-plugin, der håndterer præsentationselementer, som spillere ser: animerede titler og undertekster midt på skærmen, actionbar, animerede tab-list headers og footers samt en konfigurerbar sidebar scoreboard. Det fungerer som et præsentationslag til servere, der ønsker mere polerede join-beskeder, annonceringer og live tab-/scoreboard-visninger.

🎯 Formål

Pluginet centraliserer visningsfunktioner (titles, actionbar, tab-list, sidebars), så serverejere kan præsentere ensartet, animeret og placeholder-drevet information til spillere uden selv at kode. Det er beregnet til serveradministratorer, der vil styre join/welcome-beskeder, roterende annonceringer og en dynamisk TAB/scoreboard-UI.

⚙️ Funktioner

• Konfigurerbare join- og first-join titles og actionbars med timing-muligheder og varianter.
• Animeret tab-list header og footer med støtte for gradient og placeholders til online-antal, verden-/servertid og andre dynamiske værdier.
• Konfigurerbar sidebar scoreboard med op til 15 animerede linjer, understøttet af serverens scoreboard-system.
• Broadcasts og planlagte annonceringer leveret som titles eller actionbars.
• Animationsmotor med genanvendelige animationsfiler og previews (animation playground er tilgængelig i den officielle dokumentation).
• Placeholder-integrationer (indbyggede TitleManager placeholders og support for eksterne placeholder-systemer, når de findes).
• Transaktionelle reloads: genindlæsning af konfigurationen anvendes sikkert og kan rulles tilbage, hvis den nye config er ugyldig.
• Et lille developer-facing API til valgfrie integrationer og plugin-til-plugin-brug.

🧩 Hvem det er til

• Survival- og SMP-servere, der vil have en mere poleret join/announcement-UI.
• Servere, der bruger placeholders og eksterne integrationer (til dynamiske værdier i visninger).
• Administratorer, som har brug for animerede tab- og scoreboard-visninger uden at skrive egne plugins.
• Udviklere, der vil integrere præsentationsfunktioner i andre plugins via det medfølgende API.

🏗️ Eksempler på brug

• Vis en animeret velkomsttitle og actionbar, når spillere joiner, med en anden besked ved first join.
• Hold tab-spillerlisten levende ved at vise servertid, online-antal og gradient-headers/footers.
• Rotér animerede announcement titles eller actionbars efter en tidsplan for at kommunikere events eller regler.
• Brug sidebar scoreboard til at vise ranglister, statistik eller dynamisk serverinformation.

⌨️ Kommandoer

Bemærk: Kommandoerne ovenfor er dokumenteret af projektet. Specifikke permission nodes blev ikke angivet i de kilder, der blev brugt her, og bør konsulteres i plugin-dokumentationen for de præcise nodes og standardindstillinger.

⚙️ Installation

📥 Opsætning

• Download pluginets JAR fra projektets release eller pluginets resource-side.
• Placer JAR-filen i din servers plugins/-mappe.
• Genstart serveren.
• Redigér de genererede konfigurationsfiler under plugins/TitleManager/ for at justere titles, animationer og indstillinger for spillerlisten.
• Brug /tm reload til at anvende konfigurationsændringer; pluginet udfører transaktionelle reloads for at undgå at anvende ødelagte configs.

📦 Afhængigheder

• PlaceholderAPI (valgfri integration til eksterne placeholders).
• Vault (valgfrit, bruges til placeholder-værdier når det findes).
• BungeeCord (integrationsbevidst adfærd når det bruges i proxy-opsætninger).

Disse integrationer er valgfrie og bruges, når de findes; pluginet kører uden dem, men kan bruge deres data, når de er tilgængelige.

🧠 Tekniske noter

• Officielle runtime-mål inkluderer Minecraft 1.8 til 1.21.x (projektmaterialet henviser til eksplicit support op til 1.21.11). Adfærden varierer efter serverversion: nyere Minecraft-versioner bruger moderne Bukkit/Paper APIs, mens legacy-versioner er afhængige af versionsspecifikke kompatibilitetsmoduler.
• TitleManager udgiver et lille Bukkit-orienteret API til valgfrie integrationer og leverer genereret API-dokumentation.
• Safe reload og diagnostics-kommandoer findes for at hjælpe med konfiguration og fejlfinding under runtime.

🤝 Hvornår dette plugin er nyttigt

Hvis du vil have centraliseret, animeret og placeholder-drevet styring af præsentation (titles, actionbar, tab-list og sidebars), der administreres fra konfiguration i stedet for specialkode, tilbyder TitleManager et dokumenteret plugin og API til at levere disse UI-elementer konsekvent på tværs af dit servermiljø.