Minecraft-Plugin ajLeaderboards

🔌 Über ajLeaderboards

ajLeaderboards ist ein Minecraft-Plugin zum Erstellen von Bestenlisten aus jedem PlaceholderAPI-Placeholder, der einen numerischen Wert zurückgibt. Es sammelt und ordnet die von Platzhaltern gemeldeten Werte und kann die Ergebnisse mit Hologrammen, integrierten Schildern, NPCs, Rüstungsständern und Spielerköpfen anzeigen.

🎯 Zweck

Das Plugin löst das Problem, flexible, pluginübergreifende Bestenlisten ohne eigene Integration bereitzustellen: Jedes Plugin, das einen numerischen PlaceholderAPI-Placeholder bereitstellt, kann verfolgt und auf In-World-Anzeigen dargestellt oder als Placeholder für andere Anzeige-Plugins ausgegeben werden.

⚙️ Funktionen

• Beliebige numerische PlaceholderAPI-Placeholders als Bestenlisten-Eintrag verfolgen.
• Mehrere Anzeigeoptionen: Hologramme, integrierte Schilder, NPCs, Rüstungsständer und Spielerköpfe.
• Zeitgesteuerte Bestenlisten mit automatischen Zurücksetzungen (stündlich, täglich, monatlich usw.) bei Beibehaltung der Allzeit-Statistiken.
• MySQL-Unterstützung für synchronisierte Bestenlisten über mehrere Server hinweg (der verfolgte Placeholder muss ebenfalls synchronisiert sein).
• Optionale Anzeige von Spieler-Präfix/Suffix über Vault-Integration.
• "Extra"-Placeholders, um zusätzlichen Placeholder-Text zusammen mit Bestenlisten-Einträgen anzuzeigen.
• Folia-Unterstützung und Kompatibilität mit gängigen Anzeige-Plugins (z. B. Hologramm- und NPC-Systeme).
• Anonyme Erfassung von Nutzungsstatistiken über bStats (kann in der bStats-Konfiguration deaktiviert werden).

🧩 Für wen es gedacht ist

• Survival- und SMP-Server, die dynamische Bestenlisten für Kontostände, Statistiken oder eigene Metriken möchten.
• Server, die bereits PlaceholderAPI verwenden und Ränge direkt in der Welt anzeigen wollen (Hologramme, Schilder, NPCs).
• Admins, die zeitgesteuerte Bestenlisten (täglich/stündlich/monatlich) und optionale MySQL-Synchronisierung benötigen.

🏗️ Beispielanwendungsfälle

• Die höchsten Wirtschaftssalden mit einem Economy-Plugin-Placeholder und einem Hologramm-Plugin anzeigen.
• Die höchsten Kills oder eigene Minispiel-Punkte auf NPCs oder Schildern anzeigen.
• Stündliche oder tägliche Bestenlisten für Event-Gewinner ausführen und gleichzeitig Allzeit-Rekorde behalten.

⌨️ Befehle

(Hinweis: Die Befehlsnamen werden vom Plugin dokumentiert; Server-Operatoren sollten für die vollständige Befehlsliste und Syntax das Wiki des Plugins prüfen.)

🔐 Berechtigungen

⚙️ Installation

📥 Einrichtung

• Lade die offizielle Plugin-JAR herunter und lege sie in den plugins/-Ordner deines Servers.
• Stelle sicher, dass PlaceholderAPI vor dem Start des Servers installiert ist; das Plugin benötigt PlaceholderAPI, um verfolgte Werte zu lesen.
• Starte den Server oder starte ihn neu und prüfe die Serverkonsole, um zu bestätigen, dass das Plugin geladen wurde.

📦 Abhängigkeiten

• PlaceholderAPI (erforderlich)
• Vault (optional; wird zur Anzeige von Präfixen/Suffixen verwendet)
• Citizens (optional; für NPC-basierte Bestenlisten-Anzeigen)
• DecentHolograms oder andere Hologramm-Plugins (optional; für Hologramm-Anzeigen)

🧠 Technische Hinweise

• Das Plugin unterstützt zeitgesteuerte Bestenlisten (stündlich/täglich/monatlich) und kann MySQL verwenden, um Bestenlisten zu synchronisieren, wenn auch der verfolgte Placeholder-Wert synchronisiert wird.
• Folia-Unterstützung ist vorhanden.
• Das Plugin sendet anonyme Messwerte an bStats; dies kann über die bStats-Konfiguration deaktiviert werden.

🤝 Wann dieses Plugin nützlich ist

Wenn du bereits PlaceholderAPI verwendest und eine einfache, anzeigeunabhängige Möglichkeit suchst, rangbasierte numerische Daten (Wirtschaft, Statistiken, eigene Metriken) in der Welt oder als Platzhalter bereitzustellen, bietet ajLeaderboards zeitgesteuerte Bestenlisten, mehrere Anzeigeoptionen und optionale MySQL-Synchronisierung ohne eigene pluginbezogene Integrationen.