Modul Blackmarket

The black market your criminals deserve. Modul Black Market is a complete underground economy — rotating hidden dealers, prepaid courier drops, a reputation ladder, haggling, heat and genuine scarcity — wrapped in a polished Modul tablet UI and built to drop into any Qbox, QBCore, ESX or standalone server.

Qbox QBCore ESX Standalone ox_inventory qb-inventory qs-inventory ox_target qb-target lb-phone

Three markets, one economy

• Stationary dealers — weighted location pools with weekly, daily, hourly, interval, restart or static rotation; locations persist through restarts
• Courier network — remote browsing and prepaid delivery drops via the /bm command or an optional LB Phone app
• Pop-up markets — scheduled flash markets (e.g. weekend nights) with exclusive stock that vanish after a configurable window
• Hidden locations done right: no blips — players find dealers by walking the streets (proximity discovery), paying a street contact for intel, or earning the rank that keeps them in the loop
• Operating hours per market on the real server clock or the in-game clock — with a "rumor" hint in the closed UI so players know when to come back

The Modul tablet

No input dialogs, no bland context menus. Players browse a dark graphite tablet with a live market status card, their rank and heat, wallet balances, a searchable item grid with stock and lock indicators, a full purchase flow with fee breakdown, delivery tracking with GPS marking, reputation progress, order history and house rules. The accent gradient, corner radius and density are set from the config, so the UI matches your server's brand in seconds. An ox_lib menu fallback keeps players moving even if the NUI is unavailable.

Reputation, risk & haggling

• Five configurable ranks — Unknown to Kingpin — with persistent per-character XP
• Rank benefits that matter: lower service fees, cheaper couriers, flat discounts, better negotiation odds, category/item/market unlocks
• Negotiation — server-rolled haggling; success cuts the price, failure bumps it, can void the sale, and can draw the police
• Heat — risky items and large buys build heat that decays over time; too much locks the buyer out until things cool off
• Trust — serial delivery cancellers pay rising courier fees and bleed reputation
• Optional underworld leaderboard (off by default)

Stock, scarcity & dynamic pricing

• Global stock, per-player limits, restock timers and random per-rotation stock
• Chance-based availability — rare items aren't on the shelf every rotation
• Scarcity markups when stock runs low, plus per-rotation price fluctuation
• Market-level markups and rank discounts, all computed server-side
• Per-item, per-category, global and delivery cooldowns

Deliveries that survive anything

Orders are paid up front and dispatched by an NPC courier to a drop near the buyer, a fixed drop point or a random stash — configurable delay, collection window, crate prop and courier ped included. Cancel and expiry refunds are configurable, open orders are capped per player, and every order is persisted in SQL: pending deliveries survive server restarts, and the expiry countdown pauses while the buyer is offline.

Pay how your city pays

• Cash, bank, any framework account (ESX black_money, custom QB money types)
• Item currencies — marked bills, crypto sticks, anything with a configurable unit value
• Currency set globally, per market and per item
• Receipt-based charging: if an item grant ever fails, the exact payment is refunded automatically

Police pressure built in

"Shady Deal Taking Place" alerts with configurable chance, delay, risk multipliers, large-purchase triggers and alerted jobs — through ps-dispatch, cd_dispatch, qs-dispatch, core_dispatch, lb-tablet, a dependency-free built-in fallback, or one normalized event for your custom dispatch.

Requirements: ox_lib and oxmysql. Framework, inventory, target, dispatch and weather/time sync are all auto-detected — nothing else is mandatory.

Installation: Drop into resources, ensure modul-blackmarket, restart. The database sets itself up on first start. Full README, install guide and config reference included.