Plugin Minecraft TitleManager

🔌 Despre TitleManager

TitleManager este un plugin Minecraft care gestionează elementele de prezentare vizibile pentru jucători: titluri și subtitluri animate în mijlocul ecranului, actionbar, antete și subsoluri animate pentru tab-list, precum și un sidebar scoreboard configurabil. Acesta funcționează ca un strat de prezentare pentru serverele care vor mesaje de intrare mai îngrijite, anunțuri și afișări live în tab/scoreboard.

🎯 Scop

Pluginul centralizează funcțiile de afișare (titles, actionbar, tab-list, sidebars) astfel încât administratorii serverului să poată prezenta jucătorilor informații consecvente, animate și bazate pe placeholder, fără cod personalizat. Este destinat administratorilor de server care vor să gestioneze mesaje de join/welcome, anunțuri rotative și o interfață TAB/scoreboard dinamică.

⚙️ Funcționalități

• Titles și actionbar configurabile pentru join și first join, cu opțiuni de timp și variante.
• Header și footer animate pentru tab-list, cu suport pentru gradient și placeholder pentru numărul de jucători online, timpul lumii/serverului și alte valori dinamice.
• Sidebar scoreboard configurabil cu până la 15 linii animate, susținut de sistemul scoreboard al serverului.
• Broadcasturi și anunțuri programate livrate ca titles sau actionbar.
• Motor de animații cu fișiere de animație reutilizabile și previzualizări (animation playground este disponibil în documentația oficială).
• Integrări de placeholder (placeholder-ele încorporate TitleManager și suport pentru sisteme externe de placeholder când sunt prezente).
• Reload-uri tranzacționale: reîncărcările de configurație sunt aplicate în siguranță și pot fi anulate dacă noul config este invalid.
• Un API mic pentru dezvoltatori pentru integrări opționale și utilizare între pluginuri.

🧩 Pentru cine este

• Servere Survival și SMP care vor un UI de join/announcement mai îngrijit.
• Servere care folosesc placeholder și integrări externe (pentru valori dinamice în afișaje).
• Administratori care au nevoie de afișări animate în tab și scoreboard fără a scrie pluginuri personalizate.
• Dezvoltatori care vor să integreze funcții de prezentare în alte pluginuri prin API-ul oferit.

🏗️ Exemple de utilizare

• Afișarea unui title de bun venit animat și a unui actionbar când jucătorii intră, cu un mesaj diferit la first join.
• Menținerea listei de jucători din tab vie prin afișarea timpului serverului, a numărului de jucători online și a unor header/footer cu gradient.
• Rotirea unor titles sau actionbar animate programat pentru a comunica evenimente sau reguli.
• Folosirea sidebar scoreboard pentru a afișa clasamente, statistici sau informații dinamice despre server.

⌨️ Comenzi

Notă: comenzile de mai sus sunt documentate de proiect. Nodurile de permisiune specifice nu au fost listate în sursele folosite aici și ar trebui consultate în documentația pluginului pentru nodurile și valorile implicite exacte.

⚙️ Instalare

📥 Configurare

• Descărcați JAR-ul pluginului din release-ul proiectului sau de pe pagina de resurse a pluginului.
• Puneți JAR-ul în directorul plugins/ al serverului.
• Reporniți serverul.
• Editați fișierele de configurare generate în plugins/TitleManager/ pentru a ajusta titles, animațiile și setările pentru lista de jucători.
• Folosiți /tm reload pentru a aplica schimbările de configurare; pluginul efectuează reload-uri tranzacționale pentru a evita aplicarea config-urilor defecte.

📦 Dependențe

• PlaceholderAPI (integrare opțională pentru placeholder-e externe).
• Vault (opțional, folosit pentru valorile placeholder dacă este prezent).
• BungeeCord (comportament conștient de integrare atunci când este folosit în setări de proxy).

Aceste integrări sunt opționale și sunt folosite când sunt prezente; pluginul rulează fără ele, dar poate folosi datele lor atunci când sunt disponibile.

🧠 Note tehnice

• Țintele oficiale de runtime includ Minecraft 1.8 până la 1.21.x (materialele proiectului menționează suport explicit până la 1.21.11). Comportamentul variază în funcție de versiunea serverului: versiunile mai noi de Minecraft folosesc API-uri moderne Bukkit/Paper, iar versiunile legacy se bazează pe module de compatibilitate per versiune.
• TitleManager publică un API mic, orientat către Bukkit, pentru integrări opționale și oferă documentație API generată.
• Există comenzi safe reload și diagnostics pentru a ajuta la depanarea configurației și a runtime-ului.

🤝 Când este util acest plugin

Dacă vrei controale de prezentare centralizate, animate și bazate pe placeholder (titles, actionbar, tab-list și sidebars), gestionate din configurare în loc de cod personalizat, TitleManager oferă un plugin și un API documentate pentru a livra aceste elemente UI în mod consecvent în tot mediul serverului tău.