Minecraft plugin TitleManager

🔌 Over TitleManager

TitleManager is een Minecraft-plugin die presentatie-elementen voor spelers beheert: geanimeerde titels en subtitels in het midden van het scherm, actionbar, geanimeerde header en footer van de tablijst, en een configureerbare sidebar scoreboard. Het fungeert als presentatielaag voor servers die nettere join-meldingen, aankondigingen en live tab-/scoreboard-weergaven willen.

🎯 Doel

De plugin centraliseert weergavefuncties (titles, actionbar, tab-list, sidebars), zodat servereigenaars consistente, geanimeerde en placeholder-gedreven informatie aan spelers kunnen tonen zonder zelf te programmeren. Het is bedoeld voor serverbeheerders die join/welcome-berichten, roterende aankondigingen en een dynamische TAB/scoreboard-UI willen beheren.

⚙️ Functies

• Configureerbare join- en first-join-titles en actionbars met timingopties en varianten.
• Geanimeerde en gradient-ondersteunende header en footer van de tablijst, met placeholders voor online aantallen, wereld-/servertijd en andere dynamische waarden.
• Configureerbare sidebar scoreboard met maximaal 15 geanimeerde regels, ondersteund door het scoreboard-systeem van de server.
• Broadcasts en geplande aankondigingen die als titles of actionbars worden geleverd.
• Animatie-engine met herbruikbare animatiebestanden en previews (animation playground beschikbaar in de officiële documentatie).
• Placeholder-integraties (ingebouwde TitleManager-placeholders en ondersteuning voor externe placeholdersystemen indien aanwezig).
• Transactionele reloads: configuratieherlaadacties worden veilig toegepast en kunnen worden teruggedraaid als de nieuwe config ongeldig is.
• Een kleine API voor ontwikkelaars voor optionele integraties en plugin-naar-plugin-gebruik.

🧩 Voor wie is dit

• Survival- en SMP-servers die een verzorgde join-/announcement-UI willen.
• Servers die placeholders en externe integraties gebruiken (voor dynamische waarden in weergaven).
• Beheerders die geanimeerde tab- en scoreboard-weergaven nodig hebben zonder aangepaste plugins te schrijven.
• Ontwikkelaars die presentatiefuncties in andere plugins willen integreren via de aangeboden API.

🏗️ Voorbeeldgebruik

• Toon een geanimeerde welkomsttitel en actionbar wanneer spelers joinen, met een ander bericht bij de eerste join.
• Houd de tabspelerslijst levendig door servertijd, online aantallen en gradient-headers/footers te tonen.
• Draai geanimeerde aankondigingstitels of actionbars volgens een schema om events of regels te communiceren.
• Gebruik de sidebar scoreboard om leaderboards, statistieken of dynamische serverinformatie weer te geven.

⌨️ Commando's

Opmerking: de bovenstaande commando's zijn gedocumenteerd door het project. Specifieke permissie-nodes werden niet vermeld in de bronnen die hier zijn gebruikt en moeten in de plugin-documentatie worden geraadpleegd voor de exacte nodes en defaults.

⚙️ Installatie

📥 Setup

• Download de plugin-JAR via de release van het project of de resourcepagina van de plugin.
• Plaats de JAR in de plugins/-map van je server.
• Herstart de server.
• Bewerk de aangemaakte configuratiebestanden in plugins/TitleManager/ om titles, animaties en instellingen voor de spelerslijst aan te passen.
• Gebruik /tm reload om configuratiewijzigingen toe te passen; de plugin voert transactionele reloads uit om te voorkomen dat kapotte configs worden toegepast.

📦 Afhankelijkheden

• PlaceholderAPI (optionele integratie voor externe placeholders).
• Vault (optioneel, gebruikt voor placeholderwaarden indien aanwezig).
• BungeeCord (integratiebewust gedrag wanneer gebruikt in proxy-opstellingen).

Deze integraties zijn optioneel en worden gebruikt wanneer ze aanwezig zijn; de plugin werkt zonder ze, maar kan hun gegevens gebruiken als die beschikbaar zijn.

🧠 Technische opmerkingen

• Officiële runtime-doelen omvatten Minecraft 1.8 tot en met 1.21.x (projectmateriaal verwijst naar expliciete ondersteuning tot 1.21.11). Het gedrag verschilt per serverversie: nieuwere Minecraft-versies gebruiken moderne Bukkit/Paper-API's, terwijl legacy-versies afhankelijk zijn van compatibiliteitsmodules per versie.
• TitleManager publiceert een kleine Bukkit-gerichte API voor optionele integraties en biedt gegenereerde API-documentatie.
• Er zijn safe reload- en diagnostics-commando's om te helpen bij configuratie- en runtime-problemen.

🤝 Wanneer deze plugin nuttig is

Als je gecentraliseerde, geanimeerde en placeholder-gedreven presentatiebediening wilt (titles, actionbar, tab-list en sidebars) die vanuit configuratie wordt beheerd in plaats van met maatwerkcode, biedt TitleManager een gedocumenteerde plugin en API om die UI-elementen consistent over je serveromgeving te leveren.