Plugin Minecraft ajLeaderboards

🔌 Informazioni su ajLeaderboards

ajLeaderboards è un plugin Minecraft per creare classifiche a partire da qualsiasi placeholder di PlaceholderAPI che restituisca un valore numerico. Raccoglie e ordina i valori segnalati dai placeholder e può mostrare i risultati usando ologrammi, cartelli integrati, NPC, supporti per armature e teste dei giocatori.

🎯 Scopo

Il plugin risolve il problema di creare classifiche flessibili e compatibili tra plugin, senza richiedere integrazioni personalizzate: qualsiasi plugin che esponga un placeholder numerico di PlaceholderAPI può essere monitorato e mostrato in-world oppure esposto come placeholder per altri plugin di visualizzazione.

⚙️ Funzionalità

• Traccia qualsiasi placeholder numerico di PlaceholderAPI come voce della classifica.
• Diverse opzioni di visualizzazione: ologrammi, cartelli integrati, NPC, supporti per armature e teste dei giocatori.
• Classifiche temporizzate con reset automatici (orari, giornalieri, mensili, ecc.) mantenendo le statistiche di sempre.
• Supporto MySQL per sincronizzare le classifiche tra server (richiede che anche il placeholder tracciato sia sincronizzato).
• Visualizzazione opzionale del prefisso/suffisso del giocatore tramite integrazione Vault.
• Placeholder "Extra" per mostrare testo aggiuntivo del placeholder insieme alle voci della classifica.
• Supporto a Folia e compatibilità con i plugin di visualizzazione più comuni (ad esempio sistemi di ologrammi e NPC).
• Raccolta anonima di statistiche di utilizzo tramite bStats (disattivabile nella configurazione di bStats).

🧩 A chi è rivolto

• Server Survival e SMP che vogliono classifiche dinamiche per saldi, statistiche o metriche personalizzate.
• Server che usano già PlaceholderAPI e vogliono mostrare i ranghi in-world (ologrammi, cartelli, NPC).
• Amministratori che hanno bisogno di classifiche temporizzate (giornaliere/orarie/mensili) e sincronizzazione MySQL opzionale.

🏗️ Casi d'uso di esempio

• Mostrare i migliori saldi economici usando un placeholder di un plugin economico e un plugin di ologrammi.
• Mostrare il numero più alto di kill o punteggi personalizzati di minigiochi su NPC o cartelli.
• Eseguire classifiche orarie o giornaliere per i vincitori degli eventi mantenendo i record di sempre.

⌨️ Comandi

(Nota: i nomi dei comandi sono documentati dal plugin; gli operatori del server dovrebbero controllare la wiki del plugin per l'elenco completo dei comandi e la sintassi.)

🔐 Permessi

⚙️ Installazione

📥 Configurazione

• Scarica il JAR ufficiale del plugin e inseriscilo nella cartella plugins/ del server.
• Assicurati che PlaceholderAPI sia installato prima di avviare il server; il plugin richiede PlaceholderAPI per leggere i valori tracciati.
• Avvia o riavvia il server e controlla la console per confermare che il plugin sia stato caricato.

📦 Dipendenze

• PlaceholderAPI (richiesto)
• Vault (opzionale; usato per mostrare prefissi/suffissi)
• Citizens (opzionale; per le visualizzazioni di classifiche basate su NPC)
• DecentHolograms o altri plugin di ologrammi (opzionale; per le visualizzazioni olografiche)

🧠 Note tecniche

• Il plugin supporta classifiche temporizzate (orarie/giornaliere/mensili) e può usare MySQL per sincronizzare le classifiche quando anche il valore del placeholder tracciato è sincronizzato.
• È incluso il supporto a Folia.
• Il plugin invia metriche anonime a bStats; questo può essere disattivato tramite la configurazione di bStats.

🤝 Quando questo plugin è utile

Se già usi PlaceholderAPI e vuoi un modo semplice, indipendente dal tipo di visualizzazione, per esporre dati numerici classificati (economia, statistiche, metriche personalizzate) in-world o come placeholder, ajLeaderboards offre classifiche temporizzate, molteplici opzioni di visualizzazione e sincronizzazione MySQL opzionale senza richiedere integrazioni personalizzate per plugin.