Oxide Blackmarket

Oxide Blackmarket brings an underground economy to your FiveM server with a single roaming dealer, reputation-gated inventory, police surrender and arrest mechanics, loot bags, and hit squad retaliation for players who push too far.

Key Features

• Single roaming dealer: One synced NPC dealer relocates between configured map locations on a timer.
• Reputation tiers: Players unlock better inventory as blackmarket_rep increases.
• Dirty money support: Buy, sell, and loot payouts can use either an account or an item-based cash model.
• Police pressure: Officers can force surrender, arrest the dealer, and trigger dispatch pressure.
• Hit squad retaliation: Killing the dealer can spawn an armed squad that hunts the killer.
• Loot bags: Dealer death can create a first-come-first-served loot drop with cash and stock items.
• Pager intel: A burner pager can reveal dealer intel with tier-based success and detail.

Requirements

Resource	Purpose
ox_lib	Locale, commands, and utility helpers
o-link	Framework, job, money, inventory, notify, phone, banking, callback, and targeting abstraction

This resource expects your o-link setup to provide character metadata, job checks, target interactions, inventory access, money handling, notifications, and optional phone and banking integrations.

OneSync

The dealer ped is created server-side and synced through the network, so OneSync must be enabled:

set onesync on

Quick Start

1. Place oxide-blackmarket in your server's resources folder.
2. Start ox_lib, then o-link, then oxide-blackmarket.
3. Add blackmarket_pager to your inventory system's item registry.
4. Review shared/config.lua and shared/items.lua.
5. Restart the server and verify the dealer spawns.

ensure ox_lib
ensure o-link
ensure oxide-blackmarket

See the Installation Guide for the full setup flow.

Reputation Tiers

Tier	Name	Rep Required
0	Unknown	0
1	Street	100
2	Connected	300
3	Trusted	600
4	Inner Circle	1000

Reputation is stored through olink.character in the player's blackmarket_rep metadata. Selling configured items increases rep, killing the dealer removes rep, and tier changes update available shop inventory.

Core Systems

Dealer lifecycle

• The dealer spawns at a random entry from Config.Locations.
• Relocation runs on Config.RelocationInterval.
• Stock resets whenever a fresh dealer spawns.
• New players are synced through olink:server:playerReady.

Dirty money

Config.DirtyMoney controls how shop and loot cash is handled:

• mode = 'account': uses olink.money with Config.DirtyMoney.account
• mode = 'item': uses an inventory item with Config.DirtyMoney.item

Police gameplay

• Police detection is based on the player's job matching Config.PoliceJobs.
• Officers can force surrender by aiming within Config.AimSurrenderDistance.
• Arrest rewards use olink.money, with optional department deposits through olink.banking.
• Config.DispatchAlerts controls transaction and proximity dispatch pressure.

Pager intel

The blackmarket_pager item can reveal dealer intel once the player reaches Tier 2:

Tier	Success Rate	Result
2	40%	Area intel from the spawn location
3	70%	Area intel from the spawn location
4	100%	Exact GPS intel, waypoint, and phone/email when available

See Features and Configuration for the complete behavior and tuning options.