Installation

Place the resource

Place oxide-blackmarket in your server's resources folder.

Add startup order

Start oxmysql, ox_lib, and o-link before this resource:

ensure oxmysql
ensure ox_lib
ensure o-link
ensure oxide-blackmarket

If your framework or inventory resources start oxmysql and o-link for you, just make sure oxide-blackmarket comes after them.

Add the pager item

The "Burner Pager" lets players ask around for the dealer's location. The resource handles what happens when the item is used — you only need to add the item itself to your inventory system so it exists.

An item image (blackmarket_pager.png) ships in the root of the resource folder. Copy it to your inventory's image folder as part of the steps below.

QBCore — add the item to qb-core/shared/items.lua, then copy blackmarket_pager.png to qb-inventory/html/images/:

blackmarket_pager = { name = 'blackmarket_pager', label = 'Burner Pager', weight = 100, type = 'item', image = 'blackmarket_pager.png', unique = true, useable = true, shouldClose = true, description = 'A disposable pager for underground contacts' },

QBX / ESX (ox_inventory) — add the item to ox_inventory/data/items.lua, then copy blackmarket_pager.png to ox_inventory/web/images/:

['blackmarket_pager'] = {
    label = 'Burner Pager',
    weight = 100,
    stack = false,
    close = true,
    description = 'A disposable pager for underground contacts',
},

Set up dirty money

The shop pays players in "dirty money" when they sell, and takes it when they buy. Open shared/config.lua and set Config.DirtyMoney to match your framework.

ESX — use the built-in black_money account:

Config.DirtyMoney = {
    mode = 'account',
    account = 'black_money',
}

QBX — ox_inventory ships a black_money item, so use item mode (each item in the stack is worth $1):

Config.DirtyMoney = {
    mode = 'item',
    item = 'black_money',
}

QBCore — QBCore does not ship a stackable dirty money item out of the box, so either add one to qb-core/shared/items.lua and use item mode like the QBX example, or use marked bills that store their dollar value in metadata:

Config.DirtyMoney = {
    mode = 'item',
    item = 'markedbills',
    useMetadata = true,
    metadataKey = 'worth', -- match the field your bills actually use
}

Simplest option (any framework) — regular cash works everywhere:

Config.DirtyMoney = {
    mode = 'account',
    account = 'cash',
}

Review configuration

Check these files before going live:

• shared/config.lua — dealer behavior, economy, police, loot, hit squad, spawn locations
• shared/items.lua — what the dealers buy and sell, with prices

Settings worth checking first:

• Config.Debug — turn on (true) while setting up to see helpful console output; leave off on a live server
• Config.EnableTiers — whether players need reputation to unlock better stock
• Config.DealerCount — how many dealers roam at once (default 3; capped at the number of Config.Locations)
• Config.PoliceJobs — the job names on your server that count as police
• Config.Locations — where dealers can spawn (you need at least as many as Config.DealerCount)
• Config.ArrestDropOffs — where officers deliver arrested dealers (add points near your police stations)
• Config.ArrestPoliceIntegration — turn on only if you run oxide-police and want the reward paid into department treasuries

The item names in shared/items.lua must match items that actually exist in your inventory system. The defaults reference items from other Oxide resources (weed, meth, weapon printing) — remove or replace any your server doesn't have.

See the Configuration Reference for the full option list.

Set Config.Debug = true for the first run and watch server console output for:

[oxide-blackmarket] Settings loaded from DB (N keys)
[oxide-blackmarket] Pager item registered
[oxide-blackmarket] Resource starting...
[oxide-blackmarket] Initializing dealers...
[oxide-blackmarket] Spawned dealer 1 at location 3 (entity: ..., netId: ...)
[oxide-blackmarket] Dealer initialization complete (3/3)

The Settings loaded from DB line confirms the settings table was created and read. On the very first start it also imports your config files into the table. If any configured item names aren't recognized by your inventory, a warning lists them here — fix those typos in shared/items.lua.