Plugin de Minecraft ajLeaderboards

🔌 Acerca de ajLeaderboards

ajLeaderboards es un plugin de Minecraft para crear tablas de clasificación a partir de cualquier placeholder de PlaceholderAPI que devuelva un valor numérico. Recopila y ordena los valores informados por los placeholders y puede mostrar los resultados usando hologramas, carteles integrados, NPCs, soportes para armaduras y cabezas de jugador.

🎯 Propósito

El plugin resuelve el problema de crear tablas de clasificación flexibles y compatibles entre plugins, sin necesidad de integración personalizada: cualquier plugin que exponga un placeholder numérico de PlaceholderAPI puede ser rastreado y mostrado en expositores dentro del mundo o expuesto como placeholder para otros plugins de visualización.

⚙️ Funcionalidades

• Rastrear cualquier placeholder numérico de PlaceholderAPI como entrada de una tabla de clasificación.
• Varias opciones de visualización: hologramas, carteles integrados, NPCs, soportes para armaduras y cabezas de jugador.
• Tablas de clasificación temporizadas con reinicios automáticos (cada hora, diarias, mensuales, etc.) mientras se conservan las estadísticas históricas.
• Soporte para MySQL para sincronizar tablas de clasificación entre servidores (requiere que el placeholder rastreado también esté sincronizado).
• Visualización opcional del prefijo/sufijo del jugador mediante integración con Vault.
• Placeholders "Extra" para mostrar texto adicional de placeholder junto a las entradas de la tabla de clasificación.
• Compatibilidad con Folia y con plugins de visualización comunes (por ejemplo, sistemas de hologramas y NPCs).
• Recopilación anónima de estadísticas de uso mediante bStats (se puede desactivar en la configuración de bStats).

🧩 Para quién es

• Servidores Survival y SMP que quieren tablas de clasificación dinámicas para saldos, estadísticas o métricas personalizadas.
• Servidores que ya usan PlaceholderAPI y quieren mostrar rangos dentro del mundo (hologramas, carteles, NPCs).
• Administradores que necesitan tablas de clasificación temporizadas (diarias/horarias/mensuales) y sincronización opcional con MySQL.

🏗️ Casos de uso de ejemplo

• Mostrar los saldos de economía más altos usando un placeholder de un plugin de economía y un plugin de hologramas.
• Mostrar las mayores cantidades de kills o puntuaciones personalizadas de minijuegos en NPCs o carteles.
• Ejecutar tablas de clasificación horarias o diarias para los ganadores de eventos mientras se conservan los récords históricos.

⌨️ Comandos

(Nota: los nombres de los comandos están documentados por el plugin; los operadores del servidor deberían consultar la wiki del plugin para ver la lista completa de comandos y la sintaxis.)

🔐 Permisos

⚙️ Instalación

📥 Configuración

• Descarga el JAR oficial del plugin y colócalo en la carpeta plugins/ de tu servidor.
• Asegúrate de que PlaceholderAPI esté instalado antes de iniciar el servidor; el plugin requiere PlaceholderAPI para leer los valores rastreados.
• Inicia o reinicia el servidor y revisa la consola para confirmar que el plugin se cargó.

📦 Dependencias

• PlaceholderAPI (obligatorio)
• Vault (opcional; se usa para mostrar prefijos/sufijos)
• Citizens (opcional; para mostrar tablas de clasificación basadas en NPCs)
• DecentHolograms u otros plugins de hologramas (opcional; para mostrar hologramas)

🧠 Notas técnicas

• El plugin admite tablas de clasificación temporizadas (horarias/diarias/mensuales) y puede usar MySQL para sincronizarlas cuando el valor del placeholder rastreado también esté sincronizado.
• Se proporciona compatibilidad con Folia.
• El plugin envía métricas anónimas a bStats; esto se puede desactivar mediante la configuración de bStats.

🤝 Cuándo es útil este plugin

Si ya usas PlaceholderAPI y quieres una forma fácil, independiente del tipo de visualización, de exponer datos numéricos ordenados (economía, estadísticas, métricas personalizadas) dentro del mundo o como placeholders, ajLeaderboards ofrece tablas de clasificación temporizadas, varias opciones de visualización y sincronización opcional con MySQL sin necesidad de integraciones personalizadas por plugin.