Plugin Minecraft ajLeaderboards

🔌 À propos de ajLeaderboards

ajLeaderboards est un plugin Minecraft permettant de créer des classements à partir de n'importe quel placeholder PlaceholderAPI qui renvoie une valeur numérique. Il collecte et classe les valeurs fournies par les placeholders et peut afficher les résultats à l'aide d'hologrammes, de panneaux intégrés, de PNJ, de porte-armures et de têtes de joueur.

🎯 Objectif

Le plugin résout le problème de la création de classements flexibles et compatibles entre plugins, sans intégration personnalisée : n'importe quel plugin exposant un placeholder PlaceholderAPI numérique peut être suivi et affiché en jeu ou exposé sous forme de placeholder pour d'autres plugins d'affichage.

⚙️ Fonctionnalités

• Suivre n'importe quel placeholder PlaceholderAPI numérique comme entrée de classement.
• Plusieurs options d'affichage : hologrammes, panneaux intégrés, PNJ, porte-armures et têtes de joueur.
• Classements temporisés avec réinitialisations automatiques (toutes les heures, tous les jours, tous les mois, etc.) tout en conservant les statistiques cumulées.
• Prise en charge de MySQL pour synchroniser les classements entre serveurs (le placeholder suivi doit également être synchronisé).
• Affichage optionnel du préfixe/suffixe du joueur via l'intégration Vault.
• Placeholders "Extra" pour afficher du texte de placeholder supplémentaire à côté des entrées du classement.
• Prise en charge de Folia et compatibilité avec les plugins d'affichage courants (par exemple, systèmes d'hologrammes et de PNJ).
• Collecte anonyme de statistiques d'utilisation via bStats (peut être désactivée dans la configuration bStats).

🧩 À qui cela s'adresse

• Les serveurs Survival et SMP qui veulent des classements dynamiques pour les soldes, les statistiques ou des métriques personnalisées.
• Les serveurs qui utilisent déjà PlaceholderAPI et veulent afficher des rangs en jeu (hologrammes, panneaux, PNJ).
• Les administrateurs qui ont besoin de classements temporisés (quotidiens/horaires/mensuels) et d'une synchronisation MySQL optionnelle.

🏗️ Exemples d'utilisation

• Afficher les meilleurs soldes économiques à l'aide d'un placeholder d'addon économie et d'un plugin d'hologramme.
• Afficher les meilleurs scores de kills ou des scores personnalisés de mini-jeux sur des PNJ ou des panneaux.
• Lancer des classements horaires ou quotidiens pour les gagnants d'événements tout en conservant les records cumulés.

⌨️ Commandes

(Remarque : les noms des commandes sont documentés par le plugin ; les opérateurs du serveur doivent consulter le wiki du plugin pour la liste complète des commandes et la syntaxe.)

🔐 Permissions

⚙️ Installation

📥 Configuration

• Téléchargez le JAR officiel du plugin et placez-le dans le dossier plugins/ de votre serveur.
• Assurez-vous que PlaceholderAPI est installé avant de démarrer le serveur ; le plugin a besoin de PlaceholderAPI pour lire les valeurs suivies.
• Démarrez ou redémarrez le serveur et vérifiez la console du serveur pour confirmer que le plugin a été chargé.

📦 Dépendances

• PlaceholderAPI (requis)
• Vault (optionnel ; utilisé pour afficher les préfixes/suffixes)
• Citizens (optionnel ; pour les affichages de classement basés sur des PNJ)
• DecentHolograms ou d'autres plugins d'hologrammes (optionnel ; pour les affichages en hologramme)

🧠 Notes techniques

• Le plugin prend en charge les classements temporisés (horaires/quotidiens/mensuels) et peut utiliser MySQL pour synchroniser les classements lorsque la valeur du placeholder suivi est également synchronisée.
• La prise en charge de Folia est fournie.
• Le plugin envoie des métriques anonymes à bStats ; cela peut être désactivé via la configuration de bStats.

🤝 Quand ce plugin est utile

Si vous utilisez déjà PlaceholderAPI et que vous voulez un moyen simple, indépendant du mode d'affichage, d'exposer des données numériques classées (économie, statistiques, métriques personnalisées) en jeu ou sous forme de placeholders, ajLeaderboards fournit des classements temporisés, plusieurs options d'affichage et une synchronisation MySQL optionnelle sans nécessiter d'intégrations personnalisées par plugin.