Plugin Minecraft ajLeaderboards

🔌 Despre ajLeaderboards

ajLeaderboards este un plugin Minecraft pentru crearea de clasamente din orice placeholder PlaceholderAPI care returnează o valoare numerică. Acesta colectează și ordonează valorile raportate de placeholder-e și poate afișa rezultatele folosind holograme, semne integrate, NPC-uri, armor stands și capete de jucători.

🎯 Scop

Pluginul rezolvă problema creării de clasamente flexibile, compatibile între pluginuri, fără integrare personalizată: orice plugin care expune un placeholder PlaceholderAPI numeric poate fi urmărit și afișat pe display-uri din lume sau expus ca placeholder pentru alte pluginuri de afișare.

⚙️ Funcții

• Urmărește orice placeholder numeric PlaceholderAPI ca intrare în clasament.
• Mai multe opțiuni de afișare: holograme, semne integrate, NPC-uri, armor stands și capete de jucători.
• Clasamente temporizate cu resetări automate (orare, zilnice, lunare etc.) păstrând în același timp statisticile din toate timpurile.
• Suport MySQL pentru sincronizarea clasamentelor între servere (placeholder-ul urmărit trebuie să fie sincronizat și el).
• Afișarea opțională a prefixului/sufixului jucătorului prin integrarea Vault.
• Placeholder-e "Extra" pentru afișarea unui text suplimentar lângă intrările din clasament.
• Suport Folia și compatibilitate cu pluginuri de afișare comune (de exemplu, sisteme de holograme și NPC-uri).
• Colectare anonimă de statistici de utilizare prin bStats (poate fi dezactivată în configurația bStats).

🧩 Pentru cine este

• Servere Survival și SMP care vor clasamente dinamice pentru balanțe, statistici sau metrice personalizate.
• Servere care folosesc deja PlaceholderAPI și vor să afișeze ranguri în lume (holograme, semne, NPC-uri).
• Administratori care au nevoie de clasamente temporizate (zilnice/orare/lunare) și sincronizare MySQL opțională.

🏗️ Exemple de utilizare

• Afișarea celor mai mari balanțe economice folosind un placeholder dintr-un plugin de economie și un plugin de holograme.
• Afișarea celor mai multe kill-uri sau a scorurilor personalizate de minigame pe NPC-uri sau semne.
• Rularea de clasamente orare sau zilnice pentru câștigătorii de evenimente, păstrând în același timp recordurile all-time.

⌨️ Comenzi

(Notă: numele comenzilor sunt documentate de plugin; operatorii serverului ar trebui să verifice wiki-ul pluginului pentru lista completă de comenzi și sintaxă.)

🔐 Permisiuni

⚙️ Instalare

📥 Configurare

• Descărcați JAR-ul oficial al pluginului și puneți-l în folderul plugins/ al serverului.
• Asigurați-vă că PlaceholderAPI este instalat înainte de pornirea serverului; pluginul are nevoie de PlaceholderAPI pentru a citi valorile urmărite.
• Porniți sau reporniți serverul și verificați consola serverului pentru a confirma că pluginul a fost încărcat.

📦 Dependențe

• PlaceholderAPI (obligatoriu)
• Vault (opțional; folosit pentru afișarea prefixurilor/sufixurilor)
• Citizens (opțional; pentru afișări de clasamente bazate pe NPC-uri)
• DecentHolograms sau alte pluginuri de holograme (opțional; pentru afișări cu holograme)

🧠 Note tehnice

• Pluginul acceptă clasamente temporizate (orare/zilnice/lunare) și poate folosi MySQL pentru a sincroniza clasamentele atunci când și valoarea placeholder-ului urmărit este sincronizată.
• Suportul Folia este disponibil.
• Pluginul trimite metrici anonime către bStats; acest lucru poate fi dezactivat din configurația bStats.

🤝 Când este util acest plugin

Dacă folosiți deja PlaceholderAPI și vreți o metodă simplă, independentă de tipul de afișare, pentru a expune date numerice ierarhizate (economie, statistici, metrice personalizate) în lume sau ca placeholder-e, ajLeaderboards oferă clasamente temporizate, mai multe opțiuni de afișare și sincronizare MySQL opțională fără a necesita integrări personalizate pentru fiecare plugin.