Configuration · origen_blackmarket

All settings live in config.lua.

General

Variable	Default	Description
`Config.Language`	`'en'`	UI language — `'es'` \| `'en'` \| `'fr'` \| `'it'` \| `'zh'`
`Config.Framework`	`'auto'`	Framework — `'auto'` \| `'qbcore'` \| `'esx'`
`Config.Inventory`	`'qb-inventory'`	Inventory system
`Config.Debug`	`false`	Enable debug logging
`Config.BlackMoney`	`false`	If `true`, cash payments use `black_money` instead of `money`

Payment system

Variable	Default	Description
`Config.MoneyItems.enabled`	`true`	`true` = use inventory items as currency. `false` = use framework bank/cash accounts
`Config.MoneyItems['money']`	`'money'`	Item name for cash currency
`Config.MoneyItems['crypto']`	`'lscoins'`	Item name for crypto currency
`Config.MoneyItems['black']`	`'black_money'`	Item name for black money (used when `Config.BlackMoney = true`)

Stock rotation

Variable	Default	Description
`Config.MaxUpdateDays`	`14`	Days before the market stock rotates

Items per rotation

Defines how many items of each type are selected per rotation cycle:

lua

Config.ObjectAmount = {
    masks = {
        min = 1,
        max = 2,
    },
    weapons = {
        min = 2,
        max = 3,
    },
    items = {
        min = 9,
        max = 12,
    }
}

Rarity tiers

Each tier defines a roll chance, stock range, and UI colors:

Tier	Chance	Stock
`common`	90%	12–15
`rare`	70%	10–14
`epic`	40%	8–12
`legend`	5%	4–5
`exotic`	0.5%	3–4
`unique`	0.3%	2–3
`inmortal`	0.1%	1–2

Each tier can also have a custom bgColor and textColor (CSS rgb() strings).

Catalog — `Config.Apperance`

Defines all purchasable items grouped by category and rarity.

Weapon appearances

lua

Config.Apperance["weapons"]["common"] = {
    {
        title       = "Dani Camo Common 1",
        weaponName  = 'WEAPON_COMBATPISTOL',
        weaponLabel = 'Pistola de combate',
        description = 'Apariencia de Dani',
        component   = 'COMPONENT_COMBATPISTOL_VARMOD_LOWDEXY',
        level       = 0,
        image       = "dani_combat.png",  -- filename in html/img/camos/ or full URL
        cash        = 50,
        crypto      = 100,
    },
    -- ...
}

Field	Description
`title`	Display name
`weaponName`	GTA weapon spawn name
`weaponLabel`	Display label
`description`	Short description
`component`	GTA weapon component name
`level`	Required level (0 = no requirement)
`image`	Filename in `html/img/camos/` or a full URL
`cash`	Cash price
`crypto`	Crypto price

Items

lua

Config.Apperance["items"] = {
    { title = "Cerveza",  itemName = "beer",         cash = 50, crypto = 300 },
    { title = "Nitro",    itemName = "nitrous",       cash = 50, crypto = 300 },
    { title = "Taladro",  itemName = "drill",         cash = 50, crypto = 300 },
    -- ...
}

Vehicles

The vehicles list must always contain exactly 4 entries.

lua

Config.Apperance["vehicles"] = {
    {
        title       = "Bati 801",
        vehicleName = "bati",
        cash        = 50,
        crypto      = 300,
        img         = "bati.png",  -- filename in html/img/vehicles/
        top         = -10,         -- CSS top offset for image positioning
    },
    -- 3 more entries required
}

Black market van locations

The market rotates between delivery vans placed around the map. Each van has an NPC driver:

lua

Config.Vans = {
    ["Furgo1"] = {
        position = vector4(2429.5617, 3129.0776, 46.9626, 269.5322),
        npc      = "ig_agent",
        color    = 0,
    },
    ["Furgo2"] = {
        position = vector4(1699.26, -1614.48, 112.21, 3.03),
        npc      = "a_m_m_mlcrisis_01",
        color    = 2,
    },
}

The interaction radius per van is configured in Config.Zones:

lua

Config.Zones = {
    ["Furgo1"] = 25,  -- interaction radius in meters
    ["Furgo2"] = 20,
}

An optional fixed NPC where players can open the black market without needing a van:

lua

Config.MenuNPC = {
    ["model"]  = "a_m_m_og_boss_01",
    ["coords"] = vector4(491.9, -583.38, 24.69, 264.21),
    ["animation"] = {
        ["dict"] = nil,
        ["anim"] = nil,
    },
    ["blip"] = {
        ["active"] = true,
        ["sprite"] = 84,
        ["color"]  = 0,
        ["scale"]  = 0.5,
        ["label"]  = "Desconocido",
    },
}

Van vehicle model

lua

Config.VehicleHash = "speedo4"  -- spawned model for the delivery vans

Object offsets

Positions of props and the NPC relative to the van:

lua

Config.Offsets = {
    attachment = {
        ["prop_boxpile_01a"]       = vector4(0.0, -0.3, -0.15, 0.0),
        ["prop_ld_cont_light_01"]  = vector4(0.0, -1.3,  1.19, 0.0),
        ["npc"]                    = vector4(-0.4, -2.3, 0.85, 200.0),
    },
    cinematic = {
        from = vector4(-3.0, -6.0, 0.6, 0.0),
        to   = vector4( 2.0, -6.0, 0.6, 0.0),
    },
}