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

# Dart Game

A full-featured darts minigame for FiveM. Players approach a dartboard prop, open a lobby, pick a game mode, and play — with custom dart physics, a 50-level skill progression, ELO ranking for 1v1 matches, and a real-time scoreboard rendered directly on the board in the game world.

***

## Features

| Feature                      | Details                                                                                          |
| ---------------------------- | ------------------------------------------------------------------------------------------------ |
| **Custom dart physics**      | Power bar + aim sway. Sway decreases as the player levels up.                                    |
| **50-level skill system**    | XP from wins, bullseyes, and every throw. Persistent across sessions.                            |
| **ELO ranking**              | Dynamic 1v1 ranking with three-tier K-factor scaling.                                            |
| **Lobby & invite system**    | Open a lobby, invite specific players, pick mode and difficulty.                                 |
| **Real-time DUI scoreboard** | Live scoreboard rendered on the board billboard via `DrawSpritePoly`. Visible to spectators.     |
| **Server-side scoring**      | All hit detection and score calculation happens on the server. Client exploits are not possible. |
| **Multi-framework**          | ESX Legacy, QBCore, QBX, and Standalone (no framework).                                          |
| **Multi-target**             | ox\_target, qb-target, or fallback helptext with E-key (no target resource needed).              |
| **Admin board placement**    | `/darts_create`, `/darts_remove`, `/darts_list` with in-game placement UI.                       |
| **Persistent stats**         | Games played, wins, highest score, ELO, level, and XP stored per identifier.                     |
| **Localization**             | EN and PL included. Fully translatable.                                                          |
| **Exports**                  | Server and client exports for integration with other scripts.                                    |

***

## What you can configure

After purchase you have full access to:

* `config/shared.lua` — game modes, physics, scoring radii, lobby settings, skill & ELO tuning
* `config/server.lua` — database table names, admin groups, server-side validation caps
* `bridge/` — framework and target bridges (modify for custom frameworks)
* `locales/` — all user-facing strings (translate or edit)
* `data/boards.json` — pre-seed board positions that load on startup

***

## Quick navigation

* First time? → [Installation](broken://pages/ac62a81a4b0efa47acb8f23baea67cbe00729957)
* Want to change game settings? → [Configuration](broken://pages/91ecf9c2c8d0c53219736e400a45f9cf5d65f2b5)
* Wrong framework/target? → [Frameworks & Targets](broken://pages/76bebb6c0c37a5328a8241ea35de7e1798ad3cfe)
* Placing boards? → [Board Placement](broken://pages/a62ecf2bd12c6f75db98c0bbbfc6bb7fba0ca243)
* Integrating with another script? → [Exports](broken://pages/9831f6c82bf85961f52a98e288fb22c1eabdc6b9)