Frequently asked questions

Still stuck? Open a ticket on Discord.

How do I add my own leaderboard?

Run /lb create <id> — it writes boards/<id>.yml from the bundled template. Edit the source and formatting, then run /lb reload.

Where does the data come from?

Any of seven sources — Vault balances, vanilla statistics, statistic sums, PlaceholderAPI values, per-rank placeholders, built-in trackers, or custom values you set yourself.

Will it lag with lots of players?

No — rebuilds run async and are batched across ticks (batch-size players per tick). You can also cap max-players or only include players seen in the last N days.

Does it work on Folia and Bedrock?

Folia is fully supported. Bedrock players (via Geyser/Floodgate) automatically get the chest GUI, and old Java clients are detected through ViaVersion.

Can I use my existing ajLeaderboards data?

Yes — use the placeholder-rank source with the ajLeaderboards placeholders, or placeholder for one value per player.

Dialog or chest UI?

Both. client.mode: auto gives modern Java clients the dialog and everyone else the chest GUI — or force either with always-chest / always-dialog.