Inicio › Documentación › Configuración · origen_blackmarket

Configuración · origen_blackmarket

Todos los ajustes están en config.lua.

General

Variable Por defecto Descripción
Config.Language 'en' Idioma de la interfaz: 'es' | 'en' | 'fr' | 'it' | 'zh'
Config.Framework 'auto' Framework: 'auto' | 'qbcore' | 'esx'
Config.Inventory 'qb-inventory' Sistema de inventario
Config.Debug false Activa los logs de depuración
Config.BlackMoney false Si es true, los pagos en efectivo usan black_money en lugar de money

Sistema de pago

Variable Por defecto Descripción
Config.MoneyItems.enabled true true = usa objetos del inventario como moneda. false = usa las cuentas de banco/efectivo del framework
Config.MoneyItems['money'] 'money' Nombre del objeto para la moneda en efectivo
Config.MoneyItems['crypto'] 'lscoins' Nombre del objeto para la criptomoneda
Config.MoneyItems['black'] 'black_money' Nombre del objeto para el dinero negro (se usa cuando Config.BlackMoney = true)

Rotación de stock

Variable Por defecto Descripción
Config.MaxUpdateDays 14 Días que pasan antes de que rote el stock del mercado

Objetos por rotación

Define cuántos objetos de cada tipo se seleccionan en cada ciclo de rotación:

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

Niveles de rareza

Cada nivel define una probabilidad de aparición, un rango de stock y los colores de la interfaz:

Nivel Probabilidad 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

Cada nivel también puede tener un bgColor y un textColor personalizados (cadenas rgb() de CSS).

Catálogo — Config.Apperance

Define todos los objetos comprables agrupados por categoría y rareza.

Aspectos de armas

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,
    },
    -- ...
}
Campo Descripción
title Nombre que se muestra
weaponName Nombre de generación del arma en GTA
weaponLabel Etiqueta que se muestra
description Descripción breve
component Nombre del componente de arma de GTA
level Nivel obligatorio (0 = sin requisito)
image Nombre de fichero en html/img/camos/ o una URL completa
cash Precio en efectivo
crypto Precio en cripto

Objetos

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 },
    -- ...
}

Vehículos

La lista de vehículos debe contener siempre exactamente 4 entradas.

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
}

Ubicaciones de las furgonetas del mercado negro

El mercado va rotando entre furgonetas de reparto repartidas por el mapa. Cada furgoneta tiene un NPC conductor:

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,
    },
}

El radio de interacción de cada furgoneta se configura en Config.Zones:

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

Menú del NPC (punto de acceso fijo)

Un NPC fijo opcional desde el que los jugadores pueden abrir el mercado negro sin necesidad de una furgoneta:

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",
    },
}

Modelo del vehículo de la furgoneta

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

Desplazamientos de los objetos

Posiciones de los props y del NPC respecto a la furgoneta:

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),
    },
}