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

# cDev Basketball

### Showcase

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

### Introduction

{% hint style="info" %}
**cDev Basketball  Advanced Basketball, built for FiveM.**

Real pick-up basketball on custom courts: dribble moves, a timed shot meter, layups and dunks, passing, defense with steals and blocks, and full 1v1 / 2v2 / 3v3 games with a server-side referee. Build courts anywhere with the in-game editor, tune the rules from an admin panel, and let players climb an XP ranking.
{% endhint %}

### Purchase the Script

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

### Features

<details>

<summary>Features List</summary>

* 🏀 **Custom animations** — 40+ hand-made basketball clips (dribble, crossover, between the legs, behind the back, spin, jump shot, step back, layup, dunk with rim hang, passes, catch, rebound, guard slides, steal, block). The ball is a separate object that follows the hand, so the dribble never desyncs.
* 🎯 **Shot meter with a green window** — hold to charge, release in the green. The window shrinks with distance and when a defender contests the shot. The release is timed on the server (lag tolerant, hard to fake).
* 🔥 **Automatic layups and dunks** — drive at the rim and press the shoot key: the key bar switches to **Layup** or **DUNK** and the take-off is timed for you.
* 🤝 **Passing** — aim the camera at a teammate; a reticle shows who gets the ball.
* 🛡️ **Defense** — guard stance with slides, left/right steals, blocks and rebounds.
* 🏟️ **Pick-up games** — waiting squares, a host with game settings, team sides, walk-in to start spots, countdown, check ball, clear the ball, throw-ins, shot clock, game clock, overtime, win by 2, make-it-take-it, box score and MVP.
* 👀 **Spectators** — stand on the square of a running game to see the scoreboard and the box score. A red barrier keeps non-players off the court.
* 🧱 **Court editor** — place pole hoops or wall backboards anywhere, pick the mode, floor style and ball, drag the lines, the waiting square, the start spots and the court's zone. Six courts ship ready in the LSIA hangar.
* 🎨 **9 floor styles, 7 ball skins, 3 waiting-square pads** — all custom streamed models with LODs.
* 📈 **XP, 20 levels with badges and a ranking** — XP per win, loss, point and MVP; badges and the level table are editable. Players can set a nickname in their profile.
* 🛠️ **Admin panel** — language, game rules, shooting values, XP and levels, a full HUD theme editor with live preview, sounds and the court list. Save for the next restart or apply to everyone at once.
* 🖌️ **HUD themes and positions** — 5 ready-made themes plus your own; move the notifications, key prompt and key bar on screen.
* 🔊 **Real recorded sounds** — swish, rim, whistle and buzzer (through xsound, optional).
* 🔌 **Framework optional** — QBox, QBCore, ESX or standalone, detected automatically.
* 🗄️ **Database optional** — oxmysql when it runs, JSON files otherwise.
* 🧩 **Developer API** — server and client exports plus events for match start, scores, match end and XP.
* 🌐 **Locales** — English and Portuguese (Brazil); add your own language with one file.
* ⚡ **Performance** — 0.00 ms when no court is near.

</details>

### Requirements

| Resource                                                             | Required   | Notes                                                                                                       |
| -------------------------------------------------------------------- | ---------- | ----------------------------------------------------------------------------------------------------------- |
| **FiveM server with OneSync**                                        | ✅ Yes      | The resource declares `dependency '/onesync'`.                                                              |
| **Framework** (QBox `qbx_core`, QBCore `qb-core`, ESX `es_extended`) | ❌ Optional | Used only for the player name, the character id and admin groups. Without one the resource runs standalone. |
| **oxmysql**                                                          | ❌ Optional | Stores settings and player progress. Without it everything is saved to JSON files.                          |
| **xsound**                                                           | ❌ Optional | Plays the game sounds. Without it the game is silent; everything else works.                                |
| **ox\_lib**                                                          | ❌ Optional | Only if you set `Config.Notify = 'ox_lib'`.                                                                 |

### Installation Guide & Others

{% content-ref url="/pages/weTHvmfaY7HX1DcscoNF" %}
[Change Logs](https://docs.cdev.shop/fivem/cdev-basketball/change-logs.md)
{% endcontent-ref %}

{% content-ref url="/pages/C8bfDc2dV5lwRO3W9KF9" %}
[Admin Panel](https://docs.cdev.shop/fivem/cdev-basketball/admin-panel.md)
{% endcontent-ref %}

{% content-ref url="/pages/hju01pGZPzhnhl2aIuVa" %}
[Commands](https://docs.cdev.shop/fivem/cdev-basketball/commands.md)
{% endcontent-ref %}

{% content-ref url="/pages/g0oOOmzfzhApv9xKuc0O" %}
[Configurations](https://docs.cdev.shop/fivem/cdev-basketball/configurations.md)
{% endcontent-ref %}

{% content-ref url="/pages/pG9WkPWogj7tREWnj4mX" %}
[Customization](https://docs.cdev.shop/fivem/cdev-basketball/customization.md)
{% endcontent-ref %}

{% content-ref url="/pages/L4y9OHkW4oQTYx5BN1j1" %}
[FAQs](https://docs.cdev.shop/fivem/cdev-basketball/faqs.md)
{% endcontent-ref %}

{% content-ref url="/pages/IyLlw8Xb9W7EyXlgqdhe" %}
[Gameplay & Controls](https://docs.cdev.shop/fivem/cdev-basketball/gameplay-and-controls.md)
{% endcontent-ref %}

{% content-ref url="/pages/dTDdbyS2AkjBFRqd1X00" %}
[Installation Guide](https://docs.cdev.shop/fivem/cdev-basketball/installation-guide.md)
{% endcontent-ref %}

{% content-ref url="/pages/pjLtl9AfWdBanwOcv1H8" %}
[Integrations](https://docs.cdev.shop/fivem/cdev-basketball/integrations.md)
{% endcontent-ref %}

{% content-ref url="/pages/Uuh4Aso3oDir4vKoCy1p" %}
[Exports & Events](https://docs.cdev.shop/fivem/cdev-basketball/exports-and-events.md)
{% endcontent-ref %}

***
