Minecraft plugin TitleManager

🔌 O TitleManageru

TitleManager je Minecraft plugin, který spravuje prezentační prvky viditelné hráčům: animované titulky a podtituly uprostřed obrazovky, actionbar, animované záhlaví a zápatí tab-listu a také konfigurovatelný sidebar scoreboard. Slouží jako prezentační vrstva pro servery, které chtějí uhlazenější join zprávy, oznámení a živé zobrazení tab/scoreboard.

🎯 Účel

Plugin centralizuje zobrazovací funkce (titles, actionbar, tab-list, sidebars), aby majitelé serverů mohli hráčům prezentovat konzistentní, animované a na placeholderech založené informace bez vlastního programování. Je určen pro správce serverů, kteří chtějí spravovat join/welcome zprávy, rotující oznámení a dynamické TAB/scoreboard UI.

⚙️ Funkce

• Konfigurovatelné join a first-join titles a actionbary s možnostmi načasování a variantami.
• Animované a gradient-capable záhlaví a zápatí tab-listu s placeholdery pro počet online hráčů, čas světa/serveru a další dynamické hodnoty.
• Konfigurovatelný sidebar scoreboard až s 15 animovanými řádky, napojený na systém scoreboardu serveru.
• Broadcasty a plánovaná oznámení doručovaná jako titles nebo actionbary.
• Animace engine s opakovaně použitelnými animačními soubory a náhledy (animation playground je k dispozici v oficiální dokumentaci).
• Integrace placeholderů (vestavěné TitleManager placeholdery a podpora externích placeholder systémů, pokud jsou k dispozici).
• Transakční reloady: obnovení konfigurace se provádí bezpečně a lze je vrátit zpět, pokud je nová config neplatná.
• Malé API pro vývojáře pro volitelné integrace a použití mezi pluginy.

🧩 Pro koho je určen

• Survival a SMP servery, které chtějí uhlazené join/announcement UI.
• Servery používající placeholdery a externí integrace (pro dynamické hodnoty v zobrazení).
• Správce, kteří potřebují animované tab a scoreboard zobrazení bez psaní vlastních pluginů.
• Vývojáře, kteří chtějí integrovat prezentační funkce do dalších pluginů prostřednictvím poskytnutého API.

🏗️ Příklady použití

• Zobrazit animovaný uvítací title a actionbar při připojení hráčů, s jinou zprávou při first join.
• Oživit tab player list zobrazením času serveru, počtu online hráčů a gradient záhlaví/zápatí.
• Střídat animované announcement titles nebo actionbary podle plánu pro sdělení eventů nebo pravidel.
• Použít sidebar scoreboard pro zobrazení žebříčků, statistik nebo dynamických informací o serveru.

⌨️ Příkazy

Poznámka: Výše uvedené příkazy jsou zdokumentovány projektem. Konkrétní permission nodes nebyly ve zdrojích použitých zde uvedeny a je třeba je konzultovat v dokumentaci pluginu pro přesné nodes a výchozí hodnoty.

⚙️ Instalace

📥 Nastavení

• Stáhněte JAR pluginu z vydání projektu nebo ze stránky resource pluginu.
• Umístěte JAR do adresáře plugins/ na svém serveru.
• Restartujte server.
• Upravte vygenerované konfigurační soubory v plugins/TitleManager/ podle potřeby pro titles, animace a nastavení player-list.
• Použijte /tm reload k aplikaci změn konfigurace; plugin provádí transakční reloady, aby se neaplikovaly rozbité configy.

📦 Závislosti

• PlaceholderAPI (volitelná integrace pro externí placeholdery).
• Vault (volitelně, používá se pro hodnoty placeholderů, pokud je k dispozici).
• BungeeCord (chování s ohledem na integraci při použití v proxy nastaveních).

Tyto integrace jsou volitelné a používají se, když jsou dostupné; plugin funguje i bez nich, ale může jejich data použít, pokud jsou k dispozici.

🧠 Technické poznámky

• Oficiální runtime cíle zahrnují Minecraft 1.8 až 1.21.x (materiály projektu odkazují na explicitní podporu až do 1.21.11). Chování se liší podle verze serveru: novější verze Minecraftu používají moderní Bukkit/Paper API, zatímco legacy verze spoléhají na moduly kompatibility pro jednotlivé verze.
• TitleManager publikuje malé Bukkit-facing API pro volitelné integrace a poskytuje generovanou API dokumentaci.
• K dispozici jsou příkazy safe reload a diagnostics pro pomoc s konfigurací a řešením problémů za běhu.

🤝 Kdy je tento plugin užitečný

Pokud chcete centralizované, animované a na placeholderech založené řízení prezentace (titles, actionbar, tab-list a sidebars) spravované z konfigurace místo vlastního kódu, TitleManager nabízí dokumentovaný plugin a API, které tato UI zobrazení konzistentně doručují napříč vaším serverovým prostředím.