Flake Blackmarkets

Overview

Create multiple black market locations across the map, each with its own inventory, prices, accepted currencies, and delivery method.

Features

• Dual Framework — Auto-detects ESX or QB-Core.
• Multiple Markets — Define as many black markets as you want in config.
• Direct or Pickup — Per-market choice: instant delivery or delayed pickup.
• Custom Currencies — Accept cash, bank, black money, or any item as currency.
• Shop Peds — Optional NPCs at market locations with scenarios.
• Map Blips — Configurable blips per market.
• Server-Side Validation — Prices, items, and funds are validated on the server.
• Discord Logging — Optional webhook logging for purchases.

Requirements

Installation

Place the flake_blackmarkets folder into your server's resources directory and add to server.cfg:

File Structure

flake_blackmarkets/
├── client/
│   └── client.lua       -- Shop UI, peds, blips, pickup logic
├── server/
│   └── server.lua       -- Purchase validation, money, items
├── config/
│   ├── config.lua       -- Framework, settings, notifications (escrow-ignored)
│   ├── edits.lua        -- Notification overrides (escrow-ignored)
│   └── sv_config.lua    -- Markets, items, prices, pickups (escrow-ignored)
├── html/
│   └── build/           -- Shop UI files
└── fxmanifest.lua   -- Resource manifest

Configuration

Main Settings

Market Configuration

Markets are defined in config/sv_config.lua:

Config.BlackMarkets = {
    MyMarket = {
        Label    = "Black Market",
        SaleType = "direct",   -- "direct" or "pickup"

        Blip = {
            sprite     = 459,
            scale      = 0.8,
            colour     = 3,
            shortRange = true,
            name       = "Black Market",
        },

        Items = {
            { label = "Glock 17", item = "WEAPON_GLOCK17", price = 35000 },
        },

        Pos = {
            vector3(927.93, -1488.07, 30.49),
        },

        Currencies = {
            { name = "black_money", label = "Dirty Money" },
        },

        UsePickup = false,
        UsePed    = true,
        ShopPed   = {
            model    = "s_m_y_dealer_01",
            heading  = 180.0,
            scenario = "WORLD_HUMAN_DRUG_DEALER",
        },
        ShopLogo = "blackmarket.png",
    },
}

Schema Reference

Pickup Locations

Config.PickUpLocations = {
    [1] = {
        coords   = vector4(950.5, -203.6, 73.2, 296.1),
        pedModel = "g_m_y_mexgang_01",
        waitTime = 30,  -- seconds
        label    = "BROKEN MOTELS"
    },
}

Accepted Currencies

Usage

Shopping Flow

1. Approach the market marker or ped.
2. Press E to open the shop UI.
3. Add items to your cart.
4. Select a payment method and confirm purchase.
5. If the market uses Direct, items go straight to inventory.
6. If the market uses Pickup, a blip spawns and you must wait before collecting.

Server-Side Validation

• Item prices are checked against the server config — client cannot modify them.
• Payment method must be in the market's accepted currency list.
• Player funds are verified before deducting.
• Invalid items are rejected and logged as potential cheating.

Pickup System

When UsePickup = true on a market, purchased items are not given immediately. Instead, the player receives a blip to a random pickup location.

How It Works

1. Player completes purchase.
2. A random pickup location is selected from Config.PickUpLocations.
3. A blip is created on the player's map.
4. After waitTime seconds, a ped spawns and the order becomes ready.
5. Player approaches the ped and presses E to collect items.

Troubleshooting