Minecraft plugin ajLeaderboards

🔌 Over ajLeaderboards

ajLeaderboards is een Minecraft-plugin voor het maken van ranglijsten op basis van elke PlaceholderAPI-placeholder die een numerieke waarde teruggeeft. De plugin verzamelt en rangschikt de waarden die door placeholders worden gerapporteerd en kan de resultaten weergeven met hologrammen, ingebouwde borden, NPC's, armor stands en spelerhoofden.

🎯 Doel

De plugin lost het probleem op van flexibele, cross-plugin ranglijsten zonder aangepaste integratie: elke plugin die een numerieke PlaceholderAPI-placeholder aanbiedt, kan worden gevolgd en getoond op in-world displays of worden blootgesteld als placeholders voor andere displayplugins.

⚙️ Functies

• Volg elke numerieke PlaceholderAPI-placeholder als ranglijstitem.
• Meerdere weergaveopties: hologrammen, ingebouwde borden, NPC's, armor stands en spelerhoofden.
• Tijdsgebonden ranglijsten met automatische resets (uurlijk, dagelijks, maandelijks, enz.) terwijl all-time statistieken behouden blijven.
• MySQL-ondersteuning voor gesynchroniseerde ranglijsten tussen servers (de gevolgde placeholder moet ook gesynchroniseerd zijn).
• Optionele weergave van player prefix/suffix via Vault-integratie.
• "Extra"-placeholders om extra placeholdertekst naast ranglijstitems weer te geven.
• Folia-ondersteuning en compatibiliteit met gangbare displayplugins (bijv. hologram- en NPC-systemen).
• Verzameling van anonieme gebruiksstatistieken via bStats (kan worden uitgeschakeld in de bStats-configuratie).

🧩 Voor wie is het bedoeld

• Survival- en SMP-servers die dynamische ranglijsten willen voor saldo's, statistieken of aangepaste metrieken.
• Servers die al PlaceholderAPI gebruiken en rangposities in de wereld willen tonen (hologrammen, borden, NPC's).
• Beheerders die tijdsgebonden ranglijsten nodig hebben (dagelijks/uurlijks/maandelijks) en optionele MySQL-synchronisatie.

🏗️ Voorbeeldtoepassingen

• Toon de hoogste economische saldo's met een economy-plugin-placeholder en een hologramplugin.
• Laat de hoogste kill-aantallen of aangepaste minigamescores zien op NPC's of borden.
• Draai uurlijkse of dagelijkse ranglijsten voor eventwinnaars terwijl all-time records behouden blijven.

⌨️ Commando's

(Opmerking: commandonamen worden door de plugin gedocumenteerd; serverbeheerders moeten de wiki van de plugin raadplegen voor de volledige commandolijst en syntaxis.)

🔐 Rechten

⚙️ Installatie

📥 Setup

• Download de officiële plugin-JAR en plaats deze in de map plugins/ van je server.
• Zorg ervoor dat PlaceholderAPI is geïnstalleerd voordat je de server start; de plugin heeft PlaceholderAPI nodig om gevolgde waarden uit te lezen.
• Start of herstart de server en controleer de serverconsole om te bevestigen dat de plugin is geladen.

📦 Afhankelijkheden

• PlaceholderAPI (vereist)
• Vault (optioneel; gebruikt voor het tonen van prefix/suffix)
• Citizens (optioneel; voor NPC-gebaseerde ranglijstweergaven)
• DecentHolograms of andere hologramplugins (optioneel; voor hologramweergaven)

🧠 Technische opmerkingen

• De plugin ondersteunt tijdsgebonden ranglijsten (uurlijk/dagelijks/maandelijks) en kan MySQL gebruiken om ranglijsten te synchroniseren wanneer de gevolgde placeholderwaarde ook gesynchroniseerd is.
• Folia-ondersteuning is beschikbaar.
• De plugin stuurt anonieme statistieken naar bStats; dit kan worden uitgeschakeld via de bStats-configuratie.

🤝 Wanneer deze plugin handig is

Als je al PlaceholderAPI gebruikt en een eenvoudige, display-agnostische manier wilt om gerangschikte numerieke gegevens (economie, statistieken, aangepaste metrieken) in de wereld of als placeholders weer te geven, biedt ajLeaderboards tijdsgebonden ranglijsten, meerdere weergaveopties en optionele MySQL-synchronisatie zonder aangepaste integraties per plugin.