> For the complete documentation index, see [llms.txt](https://docs.rainmad.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rainmad.com/resources/blackmarkets-player-run-contraband-operation.md).

# Blackmarkets: Player-Run Contraband Operation

{% hint style="warning" %}
**Pre-Installation Note**

This guide assumes you already know how to manage a FiveM server (start resources, run SQL, edit configs). Following the steps out of order is the most common cause of errors.

**Support**

If something isn't working after you've followed every step, open a ticket in our [Discord](https://discord.gg/rainmad) and include your server console output. Don't skip the [Installation](/resources/blackmarkets-player-run-contraband-operation/installation.md) and [Dependencies](/resources/blackmarkets-player-run-contraband-operation/dependencies.md) pages.
{% endhint %}

Blackmarket is a player-run dealing operation built around a hidden warehouse. Players order supply that drops somewhere on the map, build up stock, then take a cargo van out for a mobile street sale while police try to find and seize it. Buyers reach vendors through a phone app, and each warehouse is run like a small business: a shared vault, crew permissions, pricing and analytics.

It works on QBCore/Qbox and ESX (auto-detected), and bridges to whatever target, notification, dispatch, phone and vehicle-key resources you already run.

## Features

* **Warehouses:** an instanced underground warehouse per owner, created by an admin, with a laptop that runs the whole operation.
* **Supply orders & drops:** order goods from the vault, wait out a scaling ETA, then collect the drop from a random map location before the police get there.
* **Cargo van:** load stock into a van and take it out for a mobile sale. Weight/slot capacity, a stable plate, and a replacement flow after a seizure or destruction.
* **Van sales:** sell to walk-up customers through a basket UI with a live item-preview camera, and optionally broadcast the sale publicly with a police dispatch.
* **NPC vendor:** scheduled NPC sellers that drive in, park, sell, and depart on a real-world or in-game clock, set up from the admin panel.
* **Police gameplay:** officers can search or seize the van and destroy its cargo, with optional live van tracking and dispatch alerts.
* **Crew & permissions:** hire members with per-action permissions (place orders, drive, set prices, manage the vault, answer the door, and more) from role presets.
* **Shared vault & analytics:** orders are paid from the vault and sales drop back into it, with a 30-day dashboard for revenue, top items, top sellers and activity.
* **Phone app:** buyers browse public vendors, start an anonymous chat, and receive live van locations. Vendors reply and block abusive contacts from the laptop inbox.
* **Door & knock system:** guests knock, the crew admits or rejects them, and each warehouse runs in its own routing bucket.
* **Admin panel:** create and delete warehouses, edit drops and NPC vendors in-world, inspect stock/vault/members, and read a full audit log.
* **Discord logging:** categorized webhook logs for admin, economy, police, social and security events.
* **Black money support:** pay out in cash, a black-money item, an account, or marked bills.

## Preview

{% embed url="<https://youtu.be/9yyRtVoouQ4>" %}

## Dependencies

A framework, `ox_lib`, `oxmysql` and a target/inventory resource are required. See the full list on the [Dependencies](/resources/blackmarkets-player-run-contraband-operation/dependencies.md) page before installing.

## Next steps

1. [Dependencies](/resources/blackmarkets-player-run-contraband-operation/dependencies.md)
2. [Installation](/resources/blackmarkets-player-run-contraband-operation/installation.md)
3. [Configuration](/resources/blackmarkets-player-run-contraband-operation/configuration.md)