Blackmarkets: Player-Run Contraband Operation
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 and include your server console output. Don't skip the Installation and Dependencies pages.
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
Dependencies
A framework, ox_lib, oxmysql and a target/inventory resource are required. See the full list on the Dependencies page before installing.
Next steps
Last updated