Plugin Minecraft SimpleScore

🔌 Informacje o SimpleScore

SimpleScore to plugin do Minecrafta, który wyświetla graczom animowane boczne scoreboardy. Aktualizuje linie bez migotania, obsługuje nowoczesne formatowanie kolorów i może wybrać, który scoreboard widzi gracz, na podstawie uprawnień, konfigurowalnych warunków, aktualnego świata lub regionu WorldGuard, w którym znajduje się gracz.

🎯 Cel

Głównym celem SimpleScore jest wyświetlanie dynamicznych, lokalizowanych informacji (statystyk serwera, statystyk gracza, ogłoszeń, timerów) w obszarze scoreboardu gracza w sposób, który nie powoduje migotania i integruje się z innymi pluginami za pomocą placeholderów.

⚙️ Funkcje

• Animowane, niewywołujące migotania boczne scoreboardy z konfigurowalnymi animacjami.
• Pokazywanie/ukrywanie punktacji liczbowych (obsługa ukrywania liczb punktacji tam, gdzie jest to wspierane).
• Pełna obsługa RGB/kolorów na serwerach działających na nowoczesnych wersjach (dostępne zachowanie 1.16+).
• Wybór scoreboardu do wyświetlenia za pomocą: uprawnień, warunków, świata lub regionu WorldGuard.
• Integracja z PlaceholderAPI dla wielu zewnętrznych placeholderów.
• Wbudowane placeholdery dla popularnych wartości (nazwa gracza, nazwa wyświetlana, UUID, poziom, zdrowie, serca, ping, kille, zgony, świat, liczba graczy online, maksymalna liczba graczy serwera).
• Brak limitu znaków na linię na serwerach 1.13+ (na starszych wersjach obowiązują limity legacy).
• Zaprojektowany tak, aby być kompatybilny z innymi pluginami, które tymczasowo modyfikują scoreboard.
• Obsługa tłumaczeń/wiadomości przez system wiadomości pluginu.

🧩 Dla kogo jest przeznaczony

Dla administratorów i moderatorów serwerów, którzy chcą niezawodnego, animowanego scoreboardu dla Survival, SMP, PvP, minigier lub innych typów serwerów, gdzie wyświetlanie na ekranie aktualnych informacji o graczu/serwerze jest przydatne.

🏗️ Przykładowe zastosowania

• Serwer Survival wyświetla saldo gracza, liczbę graczy online i aktywny timer wydarzenia za pomocą scoreboardu opartego na uprawnieniach.
• Świat minigry pokazuje timer meczu i kille graczy tylko uczestnikom w tym regionie WorldGuard.
• Administrator konfiguruje różne scoreboardy dla administracji i zwykłych graczy, korzystając z uprawnień i placeholderów PlaceholderAPI.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz plik JAR pluginu z oficjalnej dystrybucji (wydania projektu lub oficjalnego katalogu pluginów).
• Umieść JAR w katalogu plugins/ swojego serwera dla obsługiwanego oprogramowania serwerowego.
• Uruchom serwer ponownie i sprawdź konsolę serwera, aby potwierdzić, że plugin został poprawnie załadowany.

📦 Zależności

• PlaceholderAPI (opcjonalna integracja dla wielu zewnętrznych placeholderów).
• WorldGuard (integracja do wybierania scoreboardów według regionu; nie jest wymagana do podstawowego użycia).

🧾 Konfiguracja

• Plugin korzysta z systemu konfiguracji opisanego przez projekt (definicje scoreboardów, warunki, placeholdery i tłumaczenia są konfigurowane poprzez pliki konfiguracyjne pluginu i wiki).

🧠 Uwagi techniczne

• Potwierdzone obsługiwane platformy serwerowe obejmują implementacje zgodne z Bukkit, takie jak Spigot i Paper, oraz fork'i; niektóre wydania wymieniają także wsparcie dla Purpur i Folia.
• Potwierdzone obsługiwane wersje Minecrafta obejmują szeroki zakres (wydania projektu dokumentują wsparcie od legacy 1.8 aż po nowsze buildy serwerowe z ery 1.21).
• Projekt udostępnia publiczne repozytorium kodu źródłowego i udokumentowaną wiki dotyczącą konfiguracji, placeholderów i integracji z WorldGuard.

🤝 Kiedy ten plugin jest przydatny

Jeśli potrzebujesz konfigurowalnego, animowanego scoreboardu, który integruje się z PlaceholderAPI i może zmieniać wyświetlanie według uprawnień, świata lub regionu WorldGuard, SimpleScore zapewnia utrzymywaną implementację z udokumentowaną konfiguracją i systemem placeholderów.