ajLeaderboards

ajLeaderboards is a plugin to allow you to create leaderboards for basically anything using PlaceholderAPI placeholders.

!Features

• Supports server versions 1.8.x-1.21.x & 26.1.x and will (almost certainly) work fine on new MC versions without requiring an update.
• Can be used to make leaderboards from basically any plugin, it just needs to have a PAPI placeholder that returns a number.
• Can show player prefixes/suffixes (from Vault) on the leaderboard
• Display leaderboards anywhere that PlaceholderAPI is supported (holograms / display entities, NPCs, etc.)
• Display leaderboards on signs (built-in and fully customizable)
• Display leaderboards with NPCs (using PAPI, see wiki)
• Players' heads above signs
• Players' heads on Armor Stands
• MySQL supported (to make sure leaderboards are synced, the target placeholder must also be synced)
• "Extra" placeholders (allows you to display any placeholders' text alongside the leaderboard)
• Timed leaderboards that reset automatically without effecting all-time stats (hourly, daily, monthly, etc.)
• Folia Support
• More features to come! (request them)

!Screenshots

!Leaderboard using holograms
A leaderboard displayed using holograms

!NPC leaderboard
A NPC leaderboard using Citizens

!Sign leaderboard with heads
A sign leaderboard (using the built-in signs) with heads. (also supports Armor Stands, and the heads are optional)

!Interactive hologram leaderboards
Interactive hologram leaderboards using DecentHolograms' pages feature.
Basically, each timed type is a separate page, and the pages are switched by clicking.

!Setup

You must have PlaceholderAPI installed!

Setup is pretty straightforward.

You just use the /ajLeaderboards add command to start tracking a placeholder that returns a numberical value (a number). Then, as players join, they will be added to the leaderboard.

To display the leaderboard, you use the PlaceholderAPI LB placeholders, or use the built-in signs.

For a more detailed (and explained) setup process, including the exact requirements for the placeholder you put in /ajlb add, check out the setup guide on the wiki.

!Support

Before trying to get support, please read the FAQ

After reading the FAQ, if you have any questions, suggestions, or issues with the plugin, please contact me on any of the below methods:

• Discord
• Spigot PM
• Spigot discussion section
• Email

(Discord is preferred and the quickest way to get a response)

AI Support is also available on the Discord server, which you can get instant support from. It is able to answer the vast majority of questions and solve most issues that people ask about in support.
AI Support is always optional, and you do not need to use it if you don't want to.
PLEASE use my AI support instead of a public chatbot such as ChatGPT or Gemini. Public ones make stuff up a lot more often than mine does, since they do not have direct access to the wiki. My AI support has direct access to the wiki, which means it has the most up-to-date information and recommendations.

!Pre-Releases

Pre-Releases (also known as dev builds) are builds of the plugin from the dev branch, which may contain unstable and/or untested changes.
You can download them on Modrinth and Voxel.shop (formerly Polymart). They are not available on Spigot because Spigot does not allow a separate release channel for them.

Make sure you download it from the "Versions" or "Updates" tab, because if you download from the main download button, you will probably get the latest full release instead of the latest Pre-Release.
The version you download should have a build number on the end of the version name (e.g. 2.10.1-b320). If this build number is missing from the version name or the jar name, it is not a Pre-Release.

bStats

This plugin collects anonymous usage information via bStats. It can be disabled in bStats' config file.

!bStats

Some icons made by authors from www.flaticon.com