Discord
Wiki - Pluginy

AJLeaderboards - tablice wyników na serwerze

AJLeaderboards to plugin tworzący tablice wyników (leaderboardy) na serwerach Minecraft. Wyświetla rankingi graczy na hologramach, szyldach, w chacie i scoreboard. Działa z każdym placeholderem z PlaceholderAPI - od salda portfela, przez zabójstwa, po czas gry i statystyki pluginów.

Czas czytania: ~5 min Platforma: Paper / Spigot / Purpur

Co to jest AJLeaderboards

AJLeaderboards to uniwersalny plugin rankingowy, który sortuje graczy po dowolnej wartości liczbowej i wyświetla wynik w świecie gry. Chcesz ranking najbogatszych? Podłącz placeholder %vault_eco_balance%. Ranking zabójstw? %statistic_player_kills%. Ranking poziomu umiejętności? %auraskills_power%.

Plugin nie zbiera danych samodzielnie - korzysta z PlaceholderAPI jako źródła informacji. Dzięki temu działa z każdym pluginem, który rejestruje placeholdery, bez potrzeby dedykowanych integracji.

AJLeaderboards jest dostępny na SpigotMC. Jest darmowy, wymaga PlaceholderAPI. Opcjonalnie integruje się z DecentHolograms i innymi pluginami hologramów. Obsługuje wersje od 1.8 do 1.21.x.

Typy wyświetlania

AJLeaderboards obsługuje cztery sposoby prezentacji rankingów:

  • Hologramy - unoszący się tekst w świecie gry (wymaga DecentHolograms, HolographicDisplays lub CMI hologramy). Najpopularniejszy sposób - rankingi na spawnie widoczne dla wszystkich.
  • Szyldy - ranking na szyldach umieszczonych na ścianach. Każdy szyld to jedna pozycja w rankingu. Estetyczne, ale wymagają miejsca.
  • Głowy - głowy graczy na stojakach na zbroje lub w ramkach. Głowa zmienia się dynamicznie na gracza zajmującego daną pozycję. Efektowne na podium.
  • Chat/Scoreboard - komenda /ajlb [leaderboard] wyświetla ranking w chacie. Możesz też podłączyć placeholdery do scoreboard pluginu.

Rankingi aktualizują się automatycznie co skonfigurowany interwał (domyślnie co 5 minut). Na serwerach z wieloma rankingami zwiększ interwał do 10-15 minut, żeby zmniejszyć obciążenie.

Tworzenie leaderboardu

Tworzenie rankingu wymaga dwóch kroków:

  1. Zdefiniuj leaderboard w konfiguracji z placeholderem źródłowym.
  2. Umieść wyświetlacz w świecie gry (hologram, szyld lub głowa).

Przykład w plugins/ajLeaderboards/boards.yml:

boards:
  baltop:
    title: "&6&lNajbogatsi gracze"
    placeholder: "%vault_eco_balance%"
    type: NUMBER
    sort: DESCENDING
    size: 10
    format: "&e#%position%. &f%name% &7- &a$%value%"
    update-interval: 300       # aktualizacja co 5 minut (sekundy)

  kills:
    title: "&c&lRanking zabójstw"
    placeholder: "%statistic_player_kills%"
    type: NUMBER
    sort: DESCENDING
    size: 10
    format: "&e#%position%. &f%name% &7- &c%value% zabójstw"

Po zdefiniowaniu boardu umieszczasz hologram komendą /ajlb add hologram [nazwa_boardu] stojąc w miejscu, gdzie ma się pojawić. Ranking wyświetli się automatycznie.

Komendy i uprawnienia

Komenda Opis Uprawnienie
/ajlb Lista dostępnych leaderboardów ajleaderboards.use
/ajlb [board] Wyświetla ranking w chacie ajleaderboards.use
/ajlb add hologram [board] Dodaje hologram rankingu ajleaderboards.admin
/ajlb add sign [board] Dodaje szyld rankingu (patrz na szyld) ajleaderboards.admin
/ajlb add head [board] Dodaje głowę rankingu ajleaderboards.admin
/ajlb update [board] Wymusza aktualizację rankingu ajleaderboards.admin
/ajlb reload Przeładowuje konfigurację ajleaderboards.admin

Konfiguracja

Główne ustawienia w plugins/ajLeaderboards/config.yml:

# Ogólne
default-update-interval: 300   # domyślny interwał aktualizacji (sekundy)
max-boards: 50                 # max liczba leaderboardów
default-board-size: 10         # domyślna liczba pozycji

# Wydajność
async-sorting: true            # sortowanie asynchroniczne
cache-duration: 60             # cache wyników (sekundy)

# Hologramy
hologram-plugin: DecentHolograms  # wybór pluginu hologramów

AJLeaderboards generuje też własne placeholdery: %ajlb_[board]_[pozycja]_name% i %ajlb_[board]_[pozycja]_value%. Możesz ich użyć w scoreboard, TAB i DeluxeMenus.

Zastosowania na serwerze

  • Baltop na spawnie - hologram z Top 10 najbogatszych graczy. Motywuje do zarabiania i dodaje element rywalizacji.
  • Ranking PvP - zabójstwa, stosunek K/D, ELO rating. Na serwerach PvP to podstawa.
  • Ranking głosujących - w połączeniu z VoteRewards wyświetlaj kto głosuje najczęściej. Motywuje społeczność.
  • Ranking umiejętności - z AuraSkills lub mcMMO. Kto ma najwyższy poziom kopania, walki czy rybołówstwa.
  • Ranking czasu gry - kto spędził najwięcej godzin na serwerze. Prosty, ale angażujący ranking dla weteranów.
  • Sezonowe tabele - resetuj rankingi co sezon i wyświetlaj "Champions of Season 5" na spawnie.

Powiązane artykuły: PlaceholderAPI, DecentHolograms, Vault, katalog pluginów.