Minecraft-plugin ajLeaderboards

🔌 Om ajLeaderboards

ajLeaderboards er et Minecraft-plugin til at oprette ranglister ud fra enhver PlaceholderAPI-placeholder, der returnerer en numerisk værdi. Det indsamler og rangerer værdier, som rapporteres af placeholders, og kan vise resultaterne med hologrammer, indbyggede skilte, NPC'er, armor stands og spillerhoveder.

🎯 Formål

Pluginet løser problemet med at lave fleksible ranglister på tværs af plugins uden specialintegration: ethvert plugin, der eksponerer en numerisk PlaceholderAPI-placeholder, kan spores og vises på in-world displays eller eksponeres som placeholders til andre displayplugins.

⚙️ Funktioner

• Spor enhver numerisk PlaceholderAPI-placeholder som en ranglistepost.
• Flere visningsmuligheder: hologrammer, indbyggede skilte, NPC'er, armor stands og spillerhoveder.
• Tidsstyrede ranglister med automatiske resets (timevis, dagligt, månedligt osv.) mens all-time-statistikker bevares.
• MySQL-understøttelse til synkroniserede ranglister på tværs af servere (den overvågede placeholder skal også være synkroniseret).
• Valgfri visning af spillerens prefix/suffix via Vault-integration.
• "Extra"-placeholders til at vise ekstra placeholdertekst sammen med ranglisteposter.
• Folia-understøttelse og kompatibilitet med almindelige displayplugins (f.eks. hologram- og NPC-systemer).
• Indsamling af anonym brugsstatistik via bStats (kan slås fra i bStats-konfigurationen).

🧩 Hvem er det til

• Survival- og SMP-servere, der ønsker dynamiske ranglister for saldoer, statistik eller brugerdefinerede metrics.
• Servere, der allerede bruger PlaceholderAPI og vil vise rangeringer i verdenen (hologrammer, skilte, NPC'er).
• Administratorer, der har brug for tidsstyrede ranglister (daglige/timevise/månedlige) og valgfri MySQL-synkronisering.

🏗️ Eksempler på brug

• Vis de højeste økonomisaldoer med en placeholder fra et økonomiplugin og et hologramplugin.
• Vis de højeste kill-tal eller brugerdefinerede minispilsscorer på NPC'er eller skilte.
• Kør timevise eller daglige ranglister for eventvindere, mens all-time-rekorder bevares.

⌨️ Kommandoer

(Bemærk: kommandonavne er dokumenteret af pluginet; serveradministratorer bør tjekke pluginets wiki for den fulde kommandoliste og syntaks.)

🔐 Tilladelser

⚙️ Installation

📥 Opsætning

• Download den officielle plugin-JAR og læg den i serverens plugins/-mappe.
• Sørg for, at PlaceholderAPI er installeret, før du starter serveren; pluginet kræver PlaceholderAPI for at læse de overvågede værdier.
• Start eller genstart serveren, og tjek serverkonsollen for at bekræfte, at pluginet blev indlæst.

📦 Afhængigheder

• PlaceholderAPI (påkrævet)
• Vault (valgfri; bruges til at vise prefix/suffix)
• Citizens (valgfri; til NPC-baserede ranglistevisninger)
• DecentHolograms eller andre hologramplugins (valgfri; til hologramvisninger)

🧠 Tekniske noter

• Pluginet understøtter tidsstyrede ranglister (timevise/daglige/månedlige) og kan bruge MySQL til at synkronisere ranglister, når den overvågede placeholder-værdi også er synkroniseret.
• Folia-understøttelse er tilgængelig.
• Pluginet sender anonyme metrics til bStats; dette kan slås fra via bStats-konfigurationen.

🤝 Hvornår er dette plugin nyttigt

Hvis du allerede bruger PlaceholderAPI og ønsker en nem, display-agnostisk måde at vise rangerede numeriske data (økonomi, statistik, brugerdefinerede metrics) i verdenen eller som placeholders, tilbyder ajLeaderboards tidsstyrede ranglister, flere visningsmuligheder og valgfri MySQL-synkronisering uden behov for specialintegrationer pr. plugin.