Oxide Blackmarket | Underground Dealer System for QBCore

Introduce real risk, real reward, and real tension with a living black market that the entire server competes over.

Overview

Oxide Blackmarket is an immersive underground dealer system built for serious roleplay servers. A single roaming dealer operates server-wide at any given time, offering tier-locked contraband to players who earn their trust through reputation.

Every decision matters. Players can trade, police can arrest, and violence has consequences. The dealer relocates, fights back, and remembers how you treat them.

This system is designed to create organic conflict, investigation, and progression without relying on static NPCs or predictable locations.

Features

Roaming Dealer

• Single Dealer System — Only one dealer exists server-wide at any time
• Randomized Locations — Spawns at configurable locations across the map
• Automatic Relocation — Moves every 45 minutes (fully configurable)
• Wandering AI — Roams when idle and faces players during interactions
• Combat-Ready — Will defend themselves if attacked

Reputation System

Progress through reputation tiers by selling contraband and building trust. Each tier unlocks new inventory.

• Tier 0 — Unknown (0 Rep): Lockpicks, Joints
• Tier 1 — Street (100 Rep): Pistol Ammo, Coke Baggies
• Tier 2 — Connected (300 Rep): Burner Pager, Pistols, Thermite
• Tier 3 — Trusted (600 Rep): SMGs, Shotguns, Body Armor
• Tier 4 — Inner Circle (1000 Rep): Assault Rifles, Heavy Armor, Drills

Police Mechanics

A fully integrated arrest system gives law enforcement meaningful interaction with the black market.

• Automatic Dispatch Alerts — Officers within 150m trigger alerts
• Surrender System — Aim to force the dealer to put their hands up
• Arrest Window — 10 seconds to cuff before resistance begins
• Escape Chance — 35% chance the dealer flees if pressure drops
• Rewards — $5,000 cash plus $2,500 to police society funds

Hit Squad Retaliation

Violence has consequences.

• 4-Man Hit Squad — Armed NPCs dispatched to hunt attackers
• Dynamic AI — Vehicle pursuit, drive-bys, or on-foot combat
• Difficulty Scaling — Easy (pistols) to Hard (assault rifles)
• Escape Mechanic — Break pursuit by reaching 500m distance

Loot Drop System

• Cash Drops — $500 to $2,500 on death
• Item Drops — 30% of remaining stock (up to 5 item types)
• Loot Bag Prop — Searchable container at death location
• Server-Validated — Anti-exploit, first-come-first-served logic

Blip Discovery

• Proximity-Based Discovery — Temporary blips when within 200m
• Tier-Based Duration — Higher reputation increases visibility (3–10s)
• Cooldown System — Prevents blip spam with a 2-minute cooldown

Pager System

• Burner Pager Item — Available starting at Tier 2
• Success Rates — 40% (T2), 70% (T3), 100% (T4)
• Intel Scaling — Area hints at lower tiers, exact coordinates at Tier 4
• Email Integration — Optional qb-phone support for intel delivery

Respawn & Timers

• Dealer Killed: 10 minutes
• Dealer Arrested: 15 minutes
• Dealer Relocation: Instant

Technical Details

• Framework: QBCore
• Database: oxmysql
• Targeting: qb-target
• Inventory: qb-inventory
• Banking: qb-banking (optional, police funds)
• Phone: qb-phone (optional, Tier 4 pager emails)

Installation

1. Download and extract oxide-blackmarket to your resources folder
2. Add ensure oxide-blackmarket to your server.cfg after dependencies
3. Configure behavior in shared/config.lua
4. Add the pager item to qb-core/shared/items.lua
5. Restart your server

Admin Commands

• /blackmarket:spawn — Force spawn dealer
• /blackmarket:despawn — Remove current dealer
• /blackmarket:relocate — Force relocation
• /blackmarket:setrep — Set player reputation
• /blackmarket:addrep — Add reputation
• /blackmarket:resetrep — Reset reputation to 0

Risk it. Track it. Shut it down — or run it.
Oxide Blackmarket turns your underground economy into a living system.

Oxide Blackmarket by Oxide Studios