> 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`
  * 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 %}

***