> 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)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://k0ssek-scripts.gitbook.io/docs/dart-game.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.