> For the complete documentation index, see [llms.txt](https://docs.cdev.shop/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cdev.shop/fivem/cdev-chess.md).

# cDev Chess

<figure><img src="/files/RMBk1778teNcgQ08W5Ks" alt=""><figcaption></figcaption></figure>

## Introduction

{% hint style="info" %}
**CDEV Chess — Physical chess with ELO ranking and multi-framework support for FiveM.**

**Play chess in the world using placed boards, compete on the leaderboard, and climb the ranks with a full ELO rating system. Supports QBox, QBCore, ESX Legacy, and multiple inventories.**
{% endhint %}

## Purchase the Script

{% embed url="<https://fivem.cdev.shop/package/7299719>" %}

## Showcase

{% embed url="<https://youtu.be/WZJrdbc9Kbg>" %}

## **Features**

<details>

<summary>Features List</summary>

* ♟️ Customized and Optimized Chessboard and Chess Pieces Props with the Highest Quality
* 🔃 **Promotion Piece:** Complete system with a UI for pawn promotion when the pawn reaches the other side of the board.
* 🏁 **Physical Chess Boards** — Place chess boards in the world using the `chess_board` item or via admin commands.
* 🎮 Pre-Game Lobby screen where players can review match details before starting , displays player names, ratings, selected sides, leadborad, player settings and match settings.
* 🏆 ELO Rating & Badge System

  Competitive rating system based on the **ELO formula**, with fully configurable settings.

  Players start with a default rating and gain or lose points after each match according to the configured **K-Factor**. Ratings are clamped within defined minimum and maximum limits to ensure balance.

  The system also includes:

  * 🎖 **Rank Badges** based on rating thresholds (e.g., GM, IM, Expert, Beginner)
  * 🎨 Custom badge colors displayed in the UI
  * 📊 Visual rating display in match panel and in-game HUD
  * ⚙️ Fully configurable rating values and progression
* **🔌 Multi-Framework Compatibility s**upports **QBox (qbx\_core), QBCore, and ESX Legacy** with automatic framework detection.

  Also integrates with multiple inventory, target, and notification systems, with configurable fallback options if auto-detection fails.
* 🎯 Flexible Interaction Modes Configurable board interaction system supporting:
  * **DrawText Mode** — Floating 3D text with key press interaction (e.g., `[E] Play Chess`)
  * **Target Mode** — Integration with `ox_target` or `qb-target`
  * &#x20;Includes customizable labels, icons, key bindings, sync radius, and performance-based rescan settings.
* **⏱ Timer Support:** Optional chess clock system with configurable time controls and **Fischer increment** support per match.
* **🎨 Customization:** Players can personalize their profile with a custom display name and avatar URL, along with configurable match time settings.
* **🎨 Customization Themes:** Server owners can personalize their UI themes using the default themes or create their own custom theme.
* **🛠 Admin Tools:** Includes a `/chessadmin` panel to manage placed boards, teleport to active tables, and remove boards when needed.

</details>

## Installation Guide & Others

{% content-ref url="/pages/SRQoIiL3OoOFWY0AUwJ7" %}
[Installation Guide](/fivem/cdev-chess/installation-guide.md)
{% endcontent-ref %}

{% content-ref url="/pages/pJgbHsbA6MLxtnIi7viB" %}
[Configurations](/fivem/cdev-chess/configurations.md)
{% endcontent-ref %}

{% content-ref url="/pages/LAjUrCJQJ2ivfY275Agg" %}
[Commands](/fivem/cdev-chess/commands.md)
{% endcontent-ref %}

{% content-ref url="/pages/0aVEEUnXKKPeghGukywy" %}
[Exports](/fivem/cdev-chess/exports.md)
{% endcontent-ref %}

{% content-ref url="/pages/t0kmHOCBP70gDhJxeoaG" %}
[Integrations](/fivem/cdev-chess/integrations.md)
{% endcontent-ref %}

{% content-ref url="/pages/gVeKiXt4oBiHLN1HgMjj" %}
[FAQs](/fivem/cdev-chess/faqs.md)
{% endcontent-ref %}

***


---

# 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://docs.cdev.shop/fivem/cdev-chess.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.