> For the complete documentation index, see [llms.txt](https://lone-dev.gitbook.io/lone-dev-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lone-dev.gitbook.io/lone-dev-docs/scripts/lone-leaderboard-+-scoreboard.md).

# Lone Leaderboard + Scoreboard

An advanced all-in-one player tracking system designed for **FiveM** servers using **QBCore** or **ESX**, compatible with custom framework. It seamlessly monitors player performance, session stats, and job distribution in real-time, providing a **dynamic NUI leaderboard** .

***

**🏆 Leaderboard:**

* **Tracks detailed player statistics**, including:
  * Total playtime & longest session
  * Kills, deaths, K/D ratio
  * Distance traveled per vehicle type (car, bike, heli, etc.)
  * Arrests, jail time
  * Bank balance
  * Dynamic job-based stats (e.g. deliveries, arrests made)
  * Custom stats (e.g. heists, missions completed)
* Fully compatible with **QBCore** , **ESX** frameworks and Custom frameworks
* Stores all stats in a single SQL table (`lone_leaderboard`)
* Data is saved **every 5 minutes** for performance
* Built-in support for **custom stat exports**

***

**📋 Scoreboard:**

* Real-time display of:
  * All online players with ping and name
  * Configurable job counts (e.g. Police, EMS, Mechanic)
* **Efficient caching system** to reduce server load
* Updates when:
  * Players join/leave
  * Jobs change
  * Configured periodically

***

#### 🛠️ Configuration:

* Easy-to-edit `Config` file:
  * Enable/disable scoreboard
  * Define tracked jobs with labels and icons
  * Configure custom stats to show on leaderboard