Plugin Minecraft ajLeaderboards

🔌 O ajLeaderboards

ajLeaderboards to plugin do Minecrafta do tworzenia rankingów z dowolnego placeholdera PlaceholderAPI, który zwraca wartość liczbową. Zbiera i sortuje wartości zwracane przez placeholdery, a wyniki może wyświetlać za pomocą hologramów, wbudowanych tabliczek, NPC, stojaków na zbroję i głów graczy.

🎯 Cel

Plugin rozwiązuje problem tworzenia elastycznych rankingów działających między różnymi pluginami bez konieczności tworzenia własnej integracji: każdy plugin, który udostępnia liczbowy placeholder PlaceholderAPI, może być śledzony i pokazywany na wyświetlaczach w świecie lub udostępniany jako placeholder dla innych pluginów wyświetlających.

⚙️ Funkcje

• Śledzenie dowolnego liczbowego placeholdera PlaceholderAPI jako wpisu rankingu.
• Wiele opcji wyświetlania: hologramy, wbudowane tabliczki, NPC, stojaki na zbroję i głowy graczy.
• Rankingi czasowe z automatycznym resetem (co godzinę, codziennie, co miesiąc itd.) przy zachowaniu statystyk wszech czasów.
• Obsługa MySQL do synchronizacji rankingów między serwerami (wymaga, aby śledzony placeholder był również synchronizowany).
• Opcjonalne wyświetlanie prefiksu/sufiksu gracza przez integrację z Vault.
• Placeholdery "Extra" do wyświetlania dodatkowego tekstu obok wpisów rankingu.
• Obsługa Folia i zgodność z popularnymi pluginami do wyświetlania (np. systemami hologramów i NPC).
• Anonimowe zbieranie statystyk użycia przez bStats (można wyłączyć w konfiguracji bStats).

🧩 Dla kogo

• Serwery Survival i SMP, które chcą dynamicznych rankingów sald, statystyk lub własnych metryk.
• Serwery, które już korzystają z PlaceholderAPI i chcą wyświetlać rankingi w świecie (hologramy, tabliczki, NPC).
• Administratorzy potrzebujący rankingów czasowych (dziennych/godzinnych/miesięcznych) i opcjonalnej synchronizacji MySQL.

🏗️ Przykładowe zastosowania

• Wyświetlanie najwyższych sald ekonomii przy użyciu placeholdera z pluginu ekonomicznego i pluginu hologramów.
• Pokazywanie najwyższej liczby zabójstw lub własnych wyników mini-gier na NPC lub tabliczkach.
• Uruchamianie rankingów godzinowych lub dziennych dla zwycięzców wydarzeń przy zachowaniu rekordów wszech czasów.

⌨️ Komendy

(Uwaga: nazwy komend są opisane przez plugin; operatorzy serwera powinni sprawdzić wiki pluginu, aby zobaczyć pełną listę komend i składnię.)

🔐 Uprawnienia

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik JAR pluginu i umieść go w folderze plugins/ na serwerze.
• Upewnij się, że PlaceholderAPI jest zainstalowany przed uruchomieniem serwera; plugin wymaga PlaceholderAPI do odczytywania śledzonych wartości.
• Uruchom lub zrestartuj serwer i sprawdź konsolę serwera, aby potwierdzić, że plugin został załadowany.

📦 Zależności

• PlaceholderAPI (wymagane)
• Vault (opcjonalne; używane do wyświetlania prefiksów/sufiksów)
• Citizens (opcjonalne; do wyświetlania rankingów opartych na NPC)
• DecentHolograms lub inne pluginy hologramów (opcjonalne; do wyświetlania hologramów)

🧠 Uwagi techniczne

• Plugin obsługuje rankingi czasowe (godzinne/dzienne/miesięczne) i może używać MySQL do synchronizacji rankingów, gdy śledzona wartość placeholdera jest również synchronizowana.
• Dostępna jest obsługa Folia.
• Plugin wysyła anonimowe metryki do bStats; można to wyłączyć w konfiguracji bStats.

🤝 Kiedy ten plugin jest przydatny

Jeśli już korzystasz z PlaceholderAPI i chcesz prostego, niezależnego od sposobu wyświetlania, sposobu na udostępnianie uporządkowanych danych liczbowych (ekonomia, statystyki, własne metryki) w świecie lub jako placeholdery, ajLeaderboards oferuje rankingi czasowe, wiele opcji wyświetlania i opcjonalną synchronizację MySQL bez potrzeby własnych integracji dla każdego pluginu.