Plugin Minecraft ajLeaderboards

🔌 Sobre o ajLeaderboards

ajLeaderboards é um plugin de Minecraft para criar placares a partir de qualquer placeholder do PlaceholderAPI que retorne um valor numérico. Ele coleta e ranqueia os valores informados pelos placeholders e pode exibir os resultados usando hologramas, placas integradas, NPCs, suportes de armadura e cabeças de jogador.

🎯 Objetivo

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

⚙️ Funcionalidades

• Monitore qualquer placeholder numérico do PlaceholderAPI como entrada do placar.
• Várias opções de exibição: hologramas, placas integradas, NPCs, suportes de armadura e cabeças de jogador.
• Placares temporizados 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 placares entre servidores (exige que o placeholder monitorado 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 do placar.
• Suporte a Folia e compatibilidade com plugins de exibição comuns (por exemplo, sistemas de holograma e NPCs).
• Coleta anônima de estatísticas de uso via bStats (pode ser desativada na configuração do bStats).

🧩 Para quem é

• Servidores Survival e SMP que querem placares dinâmicos para saldo, stats ou métricas personalizadas.
• Servidores que já usam PlaceholderAPI e querem exibir rankings no mundo (hologramas, placas, NPCs).
• Administradores que precisam de placares temporizados (diários/horários/mensais) e sincronização opcional com MySQL.

🏗️ Casos de uso de exemplo

• Exibir os maiores saldos da economia usando um placeholder de um plugin de economia e um plugin de holograma.
• Mostrar as maiores contagens de kills ou pontuações personalizadas de minigames em NPCs ou placas.
• Rodar placares horários ou diários para vencedores de eventos, mantendo os recordes de sempre.

⌨️ Comandos

(Observação: os nomes dos comandos são documentados pelo plugin; os administradores do servidor devem conferir a wiki do plugin para a lista completa de comandos e a sintaxe.)

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Baixe o JAR oficial do plugin e coloque-o na pasta plugins/ do seu servidor.
• Garanta que o PlaceholderAPI esteja instalado antes de iniciar o servidor; o plugin exige o PlaceholderAPI para ler os valores monitorados.
• Inicie ou reinicie o servidor e verifique o console 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 placar baseadas em NPCs)
• DecentHolograms ou outros plugins de holograma (opcional; para exibições em holograma)

🧠 Notas técnicas

• O plugin suporta placares temporizados (por hora/diários/mensais) e pode usar MySQL para sincronizar placares quando o valor do placeholder monitorado também estiver sincronizado.
• Há suporte para Folia.
• O plugin envia métricas anônimas para o bStats; isso pode ser desativado na configuração do bStats.

🤝 Quando este plugin é útil

Se você já usa PlaceholderAPI e quer uma forma fácil, independente do tipo de exibição, de mostrar dados numéricos ranqueados (economia, stats, métricas personalizadas) no mundo ou como placeholders, o ajLeaderboards oferece placares temporizados, várias opções de exibição e sincronização opcional com MySQL sem exigir integrações personalizadas por plugin.