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

# Tyrix Droply 📦

A player-to-player delivery app for FiveM, built natively into **LB Phone**. Customers browse local storefronts, order from a real menu, and watch a real player drive the order to their door. Businesses run their own storefront — prices, categories, promos, staff — entirely from inside the game.

Droply is an add-on for [tyrix\_business](https://tyrix.gitbook.io/docs/script-resources/tyrix-business). Menus are projected from the crafting stations a business already owns, so there is no second item catalogue to maintain. Built on ox\_lib + ox\_inventory + oxmysql. ESX, QBCore, and QBox are all first-class.

## Features

* **Native LB Phone app** — light + dark themes, registered through `AddCustomApp`, no separate NUI layer.
* **Player-driven economy** — no NPC vendors. A customer orders, an on-duty employee prepares it, a driver hand-delivers it. Money moves only on a completed handover.
* **Storefront builder** — bosses set display name, description, address, phone, logo, and banner from the in-app owner panel.
* **Menu management** — per-item prices, boss-written item descriptions, custom categories, and per-item hide toggles.
* **Live GPS tracking** — customers see the driver on a world blip and an in-app mini-map, plus a one-shot "driver approaching" alert.
* **In-order chat** — customer ↔ driver messaging scoped to a single order.
* **Promotions** — percentage discount codes with usage caps, once-per-customer limits, and expiry dates.
* **Reviews & ratings** — one review per delivered order, aggregated into a store rating shown on the browse list.
* **Customer profiles** — signup gate, display name, avatar, banner, favourites, order history, and one-tap reorder.
* **Box-aware fulfilment** — a full order packed inside a `business_box` satisfies the delivery, so large orders beat the inventory weight limit.
* **Concurrent deliveries** — drivers carry several orders at once with an auto-focusing delivery HUD.
* **Anti-abuse** — cancellation fees, per-business customer blocklists, one-active-order gating, per-event rate limits, and exploit logging.
* **Restart-safe** — unfinished orders are reconciled and cleanly cancelled on resource start; nobody is left charged or locked out.
* **Rich Discord logging** — twelve event families, each with its own webhook, colour, and thumbnail.

## Framework Support

| Framework | Status |
| --------- | ------ |
| ESX       | ✅      |
| QBCore    | ✅      |
| QBox      | ✅      |

## Quick Start

Drop the resource in, add `ensure tyrix_droply` after `tyrix_business` in your `server.cfg`, restart. Schema auto-creates. Then assign a crafting station to a business from the Business Manager's Droply tab, and have the boss price the menu and open the store. Full walkthrough on the [Installation](/docs/script-resources/tyrix-droply/installation.md) page.

## Where to next

* Getting it running → [Installation](/docs/script-resources/tyrix-droply/installation.md)
* Every config value explained → [Configuration](/docs/script-resources/tyrix-droply/configuration.md)
* Turning a business into a storefront → [Storefront Setup](/docs/script-resources/tyrix-droply/storefront-setup.md)
* What players actually see → [The Customer App](/docs/script-resources/tyrix-droply/customer-app.md)
* How an order moves and when money moves → [Order Lifecycle](/docs/script-resources/tyrix-droply/order-lifecycle.md)
* Who can do what → [Roles](/docs/script-resources/tyrix-droply/roles.md)
* How Droply talks to tyrix\_business → [Integration](/docs/script-resources/tyrix-droply/integration.md)
* Something not working → [Troubleshooting](/docs/script-resources/tyrix-droply/troubleshooting.md)