> 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-ludo.md).

# cDev Ludo

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

### Introduction

{% hint style="info" %}
**CDEV Ludo Gaming  classic physical Ludo with optional wagers, ranking, and spectator sync for FiveM.**

Place boards in the world, create lobbies for 2–4 players, compete with optional cash/bank stakes, climb the leaderboard with badges, and let nearby players watch the match unfold in 3D. Supports QBox, QBCore, ESX Legacy, and multiple inventories.
{% endhint %}

### Purchase the Script

### Showcase

<mark style="color:$info;">**Video Soon**</mark>

### **Features**

<details>

<summary>Features List</summary>

* 🎲 **Custom Ludo Props** — High-quality board, colored pawns, and dice models (`cdev_board`, `cdev_player_*`, `cdev_player_dice`) with stream/ytyp support.
* 🪑 **Furniture Kit Mode** — Place board-only or with a full table + chairs kit (toggle with **G** while placing).
* 🏁 **Physical Boards** — Place tables using the `ludo_board` inventory item or via admin commands (`/ludoplace`).
* 🎮 **Pre-Game Lobby** — Host sets seat count (2–4), color, optional wager, optional turn timer. Joiners pick color and pay the stake when enabled.
* 💰 **Optional Betting** — Cash or bank wager with min/max stake and presets. Pot goes to the winner. Lobby leave / cancel refunds paid stakes.
* 🏆 **Rating & Badge System** — Competitive points system (default 1000–6000) with win / loss / forfeit deltas and configurable rank badges (Rookie → Grandmaster).
* 📊 **Gaming Hub** — Profile (display name + avatar), paginated ranking, match history, and money stats via `/ludogaming`.
* 🎬 **Cinema Camera** — Free orbit cam while playing: **W/S** elevate, **A/D** rotate, **scroll** zoom. Ped stays visible at the table.
* 👀 **Spectator Sync** — Nearby players (interest radius) see pawns, dice, chips, and lobby dress without opening the NUI.
* 🃏 **Stake Chips** — Poker chip stacks spawn at seats during wagered lobbies/matches (casino props with cash-pile fallback).
* ⏱ **Turn Timer** — Optional host-enabled turn timeout with presets (30–120s by default) and disconnect pause before forfeit.
* 🔌 **Multi-Framework Compatibility** — QBox (`qbx_core`), QBCore, and ESX Legacy with automatic detection. Inventories, target, and notifications via bridges.
* 🎯 **Flexible Interaction** — `ox_target` / `qb-target` or built-in DrawText (`[E]` play · `[G]` pick up).
* 🎨 **UI Themes** — Official `default` look + documented `custom` overrides via `public/shared/themes.json`.
* 🛠 **Admin Tools** — `/ludoadmin` panel (list / teleport / delete), `/ludoplace`, `/ludodelete`, and `/ludobalance` layout calibrator.
* 🌐 **Locales** — English and Portuguese out of the box (`en`, `pt`).

</details>

### Installation Guide & Others

{% content-ref url="/pages/xMhzmWVD0QaZLifbzHbI" %}
[Features Preview](/fivem/cdev-ludo/features-preview.md)
{% endcontent-ref %}

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

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

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

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

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

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

***