Plugin Minecraft TitleManager

🔌 O TitleManager

TitleManager to plugin do Minecrafta, który zarządza elementami prezentacji widocznymi dla graczy: animowanymi tytułami i podtytułami na środku ekranu, actionbarami, animowanymi nagłówkami i stopkami tab-listy oraz konfigurowalnym bocznym scoreboardem. Działa jako warstwa prezentacji dla serwerów, które chcą bardziej dopracowanych wiadomości o dołączeniu, ogłoszeń i dynamicznych wyświetlaczy tab/scoreboard.

🎯 Cel

Plugin centralizuje funkcje wyświetlania (titles, actionbary, tab-list, sidebars), dzięki czemu właściciele serwerów mogą prezentować graczom spójne, animowane informacje oparte na placeholderach bez własnego kodowania. Jest przeznaczony dla administratorów serwerów, którzy chcą zarządzać wiadomościami o wejściu/powitaniu, rotującymi ogłoszeniami i dynamicznym interfejsem TAB/scoreboard.

⚙️ Funkcje

• Konfigurowalne tytuły i actionbary dla dołączenia i pierwszego dołączenia, z opcjami czasu i wariantami.
• Animowany i obsługujący gradient nagłówek oraz stopka tab-listy z placeholderami dla liczby graczy online, czasu świata/serwera i innych dynamicznych wartości.
• Konfigurowalny boczny scoreboard z maksymalnie 15 animowanymi liniami, oparty na systemie scoreboard serwera.
• Broadcasty i zaplanowane ogłoszenia dostarczane jako titles lub actionbary.
• Silnik animacji z wielokrotnego użytku plikami animacji i podglądami (animation playground dostępny w oficjalnej dokumentacji).
• Integracje placeholderów (wbudowane placeholdery TitleManager i wsparcie dla zewnętrznych systemów placeholderów, gdy są dostępne).
• Transakcyjne przeładowania: przeładowania konfiguracji są stosowane bezpiecznie i mogą zostać cofnięte, jeśli nowa konfiguracja jest nieprawidłowa.
• Niewielkie API dla deweloperów do opcjonalnych integracji i użycia plugin-to-plugin.

🧩 Dla kogo

• Serwery Survival i SMP, które chcą dopracowanego interfejsu join/ogłoszeń.
• Serwery korzystające z placeholderów i integracji zewnętrznych (dla dynamicznych wartości w wyświetlaczach).
• Administratorzy potrzebujący animowanych wyświetlaczy tab i scoreboard bez pisania własnych pluginów.
• Deweloperzy, którzy chcą integrować funkcje prezentacji z innymi pluginami za pomocą dostarczonego API.

🏗️ Przykładowe zastosowania

• Pokaż animowany tytuł powitalny i actionbar, gdy gracze dołączają, z inną wiadomością przy pierwszym dołączeniu.
• Utrzymuj żywą listę graczy w tab, pokazując czas serwera, liczbę graczy online oraz gradientowe nagłówki/stopki.
• Zmieniaj animowane tytuły ogłoszeń lub actionbary według harmonogramu, aby przekazywać informacje o wydarzeniach lub zasadach.
• Użyj bocznego scoreboardu do wyświetlania rankingów, statystyk lub dynamicznych informacji o serwerze.

⌨️ Komendy

Uwagi: powyższe komendy są opisane przez projekt. Konkretne węzły uprawnień nie zostały wymienione w źródłach użytych tutaj i należy je sprawdzić w dokumentacji pluginu, aby poznać dokładne węzły i domyślne wartości.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz plik JAR pluginu z wydania projektu lub strony zasobu pluginu.
• Umieść JAR w katalogu plugins/ na swoim serwerze.
• Uruchom ponownie serwer.
• Edytuj wygenerowane pliki konfiguracyjne w plugins/TitleManager/, aby dostosować tytuły, animacje i ustawienia listy graczy.
• Użyj /tm reload, aby zastosować zmiany konfiguracji; plugin wykonuje przeładowania transakcyjne, aby uniknąć zastosowania uszkodzonej konfiguracji.

📦 Zależności

• PlaceholderAPI (opcjonalna integracja dla zewnętrznych placeholderów).
• Vault (opcjonalnie, używany do wartości placeholderów, gdy jest dostępny).
• BungeeCord (zachowanie uwzględniające integrację w konfiguracjach proxy).

Te integracje są opcjonalne i używane, gdy są dostępne; plugin działa bez nich, ale może korzystać z ich danych, gdy są dostępne.

🧠 Uwagi techniczne

• Oficjalne cele runtime obejmują Minecraft 1.8 do 1.21.x (materiały projektu odnoszą się do wyraźnego wsparcia do 1.21.11). Zachowanie różni się w zależności od wersji serwera: nowsze wersje Minecrafta używają nowoczesnych API Bukkit/Paper, a starsze wersje opierają się na modułach zgodności dla poszczególnych wersji.
• TitleManager publikuje niewielkie API dla Bukkit do opcjonalnych integracji i udostępnia wygenerowaną dokumentację API.
• Dostępne są bezpieczne komendy przeładowania i diagnostyki, które pomagają w konfiguracji i rozwiązywaniu problemów w czasie działania.

🤝 Kiedy ten plugin jest przydatny

Jeśli chcesz scentralizowanych, animowanych i opartych na placeholderach narzędzi prezentacji (titles, actionbary, tab-list i sidebary) zarządzanych z konfiguracji zamiast własnego kodu, TitleManager oferuje udokumentowany plugin i API do dostarczania tych elementów UI spójnie w całym środowisku serwera.