Minecraft plugin ajLeaderboards

🔌 O ajLeaderboards

ajLeaderboards je Minecraft plugin pro vytváření žebříčků z libovolného PlaceholderAPI placeholderu, který vrací číselnou hodnotu. Shromažďuje a řadí hodnoty hlášené placeholdery a výsledky může zobrazovat pomocí hologramů, vestavěných cedulí, NPC, armor standů a hlav hráčů.

🎯 Účel

Plugin řeší problém vytváření flexibilních žebříčků napříč pluginy bez nutnosti vlastní integrace: jakýkoli plugin, který poskytuje číselný PlaceholderAPI placeholder, lze sledovat a zobrazovat na in-world displejích nebo vystavit jako placeholder pro jiné zobrazovací pluginy.

⚙️ Funkce

• Sleduje libovolný číselný PlaceholderAPI placeholder jako položku žebříčku.
• Více možností zobrazení: hologramy, vestavěné cedule, NPC, armor stands a hlavy hráčů.
• Časované žebříčky s automatickým resetem (po hodinách, denně, měsíčně atd.) při zachování statistik za celou dobu.
• Podpora MySQL pro synchronizované žebříčky napříč servery (sledovaný placeholder musí být synchronizován také).
• Volitelné zobrazení prefixu/suffixu hráče přes integraci Vault.
• Placeholdery "Extra" pro zobrazení dalšího textu placeholderu vedle položek žebříčku.
• Podpora Folia a kompatibilita s běžnými zobrazovacími pluginy (např. systémy hologramů a NPC).
• Sběr anonymních statistik používání přes bStats (lze vypnout v konfiguraci bStats).

🧩 Pro koho je to určeno

• Survival a SMP servery, které chtějí dynamické žebříčky pro zůstatky, statistiky nebo vlastní metriky.
• Servery, které už používají PlaceholderAPI a chtějí zobrazovat pořadí ve světě (hologramy, cedule, NPC).
• Administrátory, kteří potřebují časované žebříčky (denní/hodinové/měsíční) a volitelnou synchronizaci MySQL.

🏗️ Příklady použití

• Zobrazení nejvyšších ekonomických zůstatků pomocí placeholderu z ekonomického pluginu a hologramového pluginu.
• Zobrazení nejvyššího počtu zabití nebo vlastních minihra skóre na NPC nebo cedulích.
• Spouštění hodinových nebo denních žebříčků pro vítěze eventů při zachování všech historických rekordů.

⌨️ Příkazy

(Poznámka: názvy příkazů dokumentuje plugin; správci serveru by si měli zkontrolovat wiki pluginu pro úplný seznam příkazů a syntaxi.)

🔐 Oprávnění

⚙️ Instalace

📥 Nastavení

• Stáhněte oficiální JAR pluginu a umístěte jej do složky plugins/ vašeho serveru.
• Před spuštěním serveru se ujistěte, že je nainstalovaný PlaceholderAPI; plugin jej potřebuje pro čtení sledovaných hodnot.
• Spusťte nebo restartujte server a zkontrolujte konzoli serveru, zda se plugin načetl.

📦 Závislosti

• PlaceholderAPI (povinné)
• Vault (volitelné; používá se pro zobrazení prefixů/suffixů)
• Citizens (volitelné; pro zobrazení žebříčků založených na NPC)
• DecentHolograms nebo jiné hologramové pluginy (volitelné; pro zobrazení hologramů)

🧠 Technické poznámky

• Plugin podporuje časované žebříčky (hodinové/denní/měsíční) a může používat MySQL k synchronizaci žebříčků, když je synchronizovaná i sledovaná hodnota placeholderu.
• Podpora Folia je k dispozici.
• Plugin odesílá anonymní metriky do bStats; to lze vypnout v konfiguraci bStats.

🤝 Kdy je tento plugin užitečný

Pokud už používáte PlaceholderAPI a chcete jednoduchý, na typu zobrazení nezávislý způsob, jak ve světě nebo jako placeholdery zobrazit seřazená číselná data (ekonomika, statistiky, vlastní metriky), ajLeaderboards nabízí časované žebříčky, více možností zobrazení a volitelnou synchronizaci MySQL bez nutnosti vlastních integrací pro každý plugin.