> 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/scripts/dart-game.md).

# Dart Game

A darts minigame with lobbies, two game modes, skill levels and Elo ranking.

**kossek\_darts** is a darts minigame for FiveM. Players walk up to a dartboard, open a lobby, pick a mode and a difficulty, and play alone or against each other. Scores are calculated on the server, and every player has a level and an Elo rating that are kept in the database.

## Features

| Feature                   | Details                                                                                                                                               |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Mouse aiming**          | The player moves an aim point over the board with the mouse while it sways. The sway gets smaller with every level and larger on higher difficulties. |
| **Two game modes**        | Reach Zero (count down from 201) and Max Score (first to 100). Both targets are configurable.                                                         |
| **Solo and Versus**       | Practice alone or play against others, up to 8 players per board.                                                                                     |
| **Lobby and invites**     | A lobby panel with mode, difficulty, player stats and invites for players standing nearby.                                                            |
| **Skill levels**          | 50 levels. XP is saved per player.                                                                                                                    |
| **Elo ranking**           | Rating changes after 1v1 matches, with a higher K-factor for new players.                                                                             |
| **3D scoreboard**         | A live scoreboard is drawn next to the board.                                                                                                         |
| **Server-side scoring**   | The server validates each throw and works out the score.                                                                                              |
| **Boards**                | Dartboard props that already exist in the world work out of the box. Admins can place more in game.                                                   |
| **Multi-framework**       | ESX, QBCore, QBX and standalone, detected automatically.                                                                                              |
| **Target or text prompt** | ox\_target, qb-target, or a text prompt with the E key.                                                                                               |
| **Localization**          | Eight languages included: English, Polish, German, Czech, Spanish, French, Italian and Swedish.                                                       |
| **Exports**               | Read player stats, award XP and check whether a player is in a game.                                                                                  |

## Editable files

These folders are not encrypted:

* `config/` - all settings
* `bridge/` - framework and target integrations
* `locales/` - every text shown to players

## Where to go next

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Installation</strong></td><td>Requirements, convars, start order and admin access.</td><td><a href="/docs/scripts/dart-game/installation.md">Installation</a></td></tr><tr><td><strong>Configuration</strong></td><td>Every option in config/shared.lua and config/server.lua.</td><td><a href="/docs/scripts/dart-game/configuration.md">Configuration</a></td></tr><tr><td><strong>Frameworks &#x26; Targets</strong></td><td>What each framework and target option does, and how to adapt the bridge.</td><td><a href="/docs/scripts/dart-game/frameworks-and-targets.md">Frameworks &amp; Targets</a></td></tr><tr><td><strong>Board Placement</strong></td><td>Auto-detected boards and the admin placement commands.</td><td><a href="/docs/scripts/dart-game/board-placement.md">Board Placement</a></td></tr><tr><td><strong>Game Modes &#x26; Difficulty</strong></td><td>Rules, play modes, difficulty and controls.</td><td><a href="/docs/scripts/dart-game/game-modes-and-difficulty.md">Game Modes &amp; Difficulty</a></td></tr><tr><td><strong>Skill &#x26; Elo</strong></td><td>XP, levels and how the rating is calculated.</td><td><a href="/docs/scripts/dart-game/skill-and-elo.md">Skill &amp; Elo</a></td></tr><tr><td><strong>Localization</strong></td><td>Choose a language, edit texts or add your own translation.</td><td><a href="/docs/scripts/dart-game/localization.md">Localization</a></td></tr><tr><td><strong>Exports</strong></td><td>Server and client exports for other resources.</td><td><a href="/docs/scripts/dart-game/exports.md">Exports</a></td></tr></tbody></table>

{% hint style="info" %}
Need some help? Create a ticket on our [Discord](https://discord.gg/eZN5ycvPVs).
{% endhint %}