Docs Pages & Modules Leaderboards
Leaderboards
3 min read
Display live rankings pulled from your FiveM server's data.
Requirements
- FiveM Companion Resource connected
- QBCore or ESX framework (for job/economy data)
- Blaze+ plan or above
Available leaderboard types
| Type | Data source | Updates |
|---|---|---|
| Richest players | Player bank balance from QBCore/ESX | Hourly |
| Most hours | Total play time across all characters | Hourly |
| Top job earners | Money earned per job this week | Hourly |
| Most wanted | Highest bounty active players | Live |
| Most arrests | Police arrest count this month | Daily |
Configuring leaderboards
Go to Settings → Leaderboards to:
- Enable or disable specific leaderboard types
- Set how many entries to show (default: 25)
- Set the refresh interval
- Choose which data to show per entry (name, job, amount, rank badge)
Privacy settings
Some server owners prefer not to show specific player data publicly. From Settings → Leaderboards → Privacy:
- Hide exact money amounts (show rank only)
- Show character names instead of Discord usernames
- Exclude staff members from leaderboards
- Set minimum hours required before a player appears
Data accuracy
Leaderboard data is pulled hourly from your server's database via the companion resource. The data shown is always at most 1 hour old. A "Last updated" timestamp shows at the bottom of each leaderboard.