Plugin Minecraft ajLeaderboards

🔌 Sobre o ajLeaderboards

ajLeaderboards é um plugin de Minecraft para criar tabelas de classificação a partir de qualquer placeholder do PlaceholderAPI que devolva um valor numérico. Recolhe e ordena os valores reportados pelos placeholders e pode apresentar os resultados usando hologramas, placas integradas, NPCs, suportes de armadura e cabeças de jogador.

🎯 Objetivo

O plugin resolve o problema de criar tabelas de classificação flexíveis e compatíveis entre plugins, sem necessidade de integração personalizada: qualquer plugin que exponha um placeholder numérico do PlaceholderAPI pode ser monitorizado e mostrado em exibições no mundo ou exposto como placeholder para outros plugins de exibição.

⚙️ Funcionalidades

• Monitoriza qualquer placeholder numérico do PlaceholderAPI como entrada da tabela de classificação.
• Várias opções de exibição: hologramas, placas integradas, NPCs, suportes de armadura e cabeças de jogador.
• Tabelas de classificação temporizadas com reinícios automáticos (de hora em hora, diários, mensais, etc.) enquanto preserva as estatísticas de sempre.
• Suporte a MySQL para sincronizar tabelas de classificação entre servidores (exige que o placeholder monitorizado também esteja sincronizado).
• Exibição opcional do prefixo/sufixo do jogador via integração com Vault.
• Placeholders "Extra" para exibir texto adicional de placeholder junto às entradas da tabela de classificação.
• Suporte a Folia e compatibilidade com plugins de exibição comuns (por exemplo, sistemas de hologramas e NPCs).
• Recolha anónima de estatísticas de utilização via bStats (pode ser desativada na configuração do bStats).

🧩 A quem se destina

• Servidores Survival e SMP que querem tabelas de classificação dinâmicas para saldos, estatísticas ou métricas personalizadas.
• Servidores que já usam PlaceholderAPI e querem mostrar classificações no mundo (hologramas, placas, NPCs).
• Administradores que precisam de tabelas de classificação temporizadas (diárias/horárias/mensais) e sincronização MySQL opcional.

🏗️ Exemplos de utilização

• Mostrar os maiores saldos da economia usando um placeholder de um plugin de economia e um plugin de hologramas.
• Mostrar os maiores números de eliminações ou pontuações personalizadas de minijogos em NPCs ou placas.
• Executar tabelas de classificação horárias ou diárias para vencedores de eventos, preservando os registos de sempre.

⌨️ Comandos

(Nota: os nomes dos comandos são documentados pelo plugin; os operadores do servidor devem consultar a wiki do plugin para a lista completa de comandos e a sintaxe.)

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Descarrega o ficheiro JAR oficial do plugin e coloca-o na pasta plugins/ do servidor.
• Certifica-te de que o PlaceholderAPI está instalado antes de iniciar o servidor; o plugin requer o PlaceholderAPI para ler os valores monitorizados.
• Inicia ou reinicia o servidor e verifica a consola para confirmar que o plugin foi carregado.

📦 Dependências

• PlaceholderAPI (obrigatório)
• Vault (opcional; usado para mostrar prefixos/sufixos)
• Citizens (opcional; para exibições de tabelas de classificação baseadas em NPCs)
• DecentHolograms ou outros plugins de hologramas (opcional; para exibições em holograma)

🧠 Notas técnicas

• O plugin suporta tabelas de classificação temporizadas (horárias/diárias/mensais) e pode usar MySQL para sincronizar tabelas de classificação quando o valor do placeholder monitorizado também estiver sincronizado.
• O suporte para Folia está disponível.
• O plugin envia métricas anónimas para o bStats; isto pode ser desativado através da configuração do bStats.

🤝 Quando este plugin é útil

Se já usas PlaceholderAPI e queres uma forma fácil, independente do sistema de exibição, de expor dados numéricos classificados (economia, estatísticas, métricas personalizadas) no mundo ou como placeholders, o ajLeaderboards oferece tabelas de classificação temporizadas, várias opções de exibição e sincronização MySQL opcional sem necessidade de integrações personalizadas por plugin.