> For the complete documentation index, see [llms.txt](https://beetle-studios.gitbook.io/beetle-studios-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://beetle-studios.gitbook.io/beetle-studios-docs/beetle-studios/chow-drop.md).

# Chow Drop

Chow Drop is a full food-delivery system for FiveM. Players order meals, deliver for pay, and run restaurant operations from a custom phone app — no world kiosks required.

It supports QBX, QB-Core, and ESX, and works with lb-phone or CodeM mPhone. Core gameplay uses ox\_lib, ox\_target, oxmysql, and ox\_inventory.

Roles are separated by design: customer, driver, and on-duty restaurant staff do not overlap (unless Solo Test Mode is enabled for development).

### General Overview

Chow Drop recreates a DoorDash-style loop on your server:

1. Customers open the app, browse businesses you configure, build a cart, pay from bank, and track the order through delivery. After delivery they can tip and rate the driver once.
2. Drivers register in-app, go online, and take NPC jobs and/or player orders. Pickup and drop-off use GPS, ox\_target interactions, XP/levels, ratings, a leaderboard, and in-app payment collection.
3. Restaurant staff clock on with the business job. In Staff mode they open/close the restaurant, move orders through pending → accepted → preparing → ready, hand off to drivers, and cancel with a reason when needed.
4. Admins use `/cd_admin` to create businesses, menus, menu items, and driver pickup coordinates.

#### How the pieces fit together

| Role     | How you enter it                                     | Main tools                                         |
| -------- | ---------------------------------------------------- | -------------------------------------------------- |
| Customer | Choose Order Food in the app                         | Menus, cart, active orders, history, tip/rate      |
| Driver   | Choose Deliver Orders in the app                     | Online toggle, order list, GPS, stats, leaderboard |
| Staff    | On-duty restaurant job matching a Chow Drop business | Staff screen in the same phone app                 |
| Admin    | `/cd_admin` (permissioned)                           | Full-screen admin panel (phone-independent)        |

#### Order types

* Player orders — Customer → on-duty staff → driver → customer. Staff control kitchen status; drivers handle pickup GPS and delivery to the player.
* NPC orders — Generated for online drivers. Pickup and delivery use spawned NPCs or door drop-off zones; pay and XP are awarded on completion.

#### Compatibility

| Layer     | Options                                     |
| --------- | ------------------------------------------- |
| Framework | `qbx` · `qb` · `esx` · `auto`               |
| Phone     | `lb-phone` · `codem-phone` · `auto`         |
| Required  | ox\_lib, ox\_target, oxmysql, ox\_inventory |

Install with a single schema (`sql/install.sql`), set framework/phone in `config.lua` (or leave `auto`), and ensure dependencies start before `bs_chowdrop`.