Discord Store
Urban Supply v2

Configuration

Everything lives in config.lua, except level rewards, which are in server/rewards.lua. Values shown are what ships with the script.

Bridge settings

config.lua
Config.Locale            = 'en'
Config.SharedObjectName  = 'esx:getSharedObject'
Config.Framework         = 'esx'          -- 'esx' | 'qb' | 'qbx'
Config.Inventory         = 'ox'           -- 'ox' | 'qb' | 'custom'
Config.Notify            = 'wasabi'       -- 'esx' | 'qb' | 'ox' | 'wasabi' | 'custom'
Config.Dispatch          = 'dh_mdt'       -- 'dh_mdt' | 'cd_dispatch' | 'rcore_dispatch' | 'aty_dispatch'
                                          -- | 'ak4y_dispatch' | 'wasabi' | 'custom' | 'none'
Config.DirtyMoneyAccount = 'black_money'
Config.GarageScript      = 'dh_garage'    -- 'dh_garage' | 'vms_garagesv2' | 'jg_advancedgarages' | 'custom' | 'none'
Config.GarageScriptDefaultGarage = 'pillboxgarage'  -- jg_advancedgarages only

Core settings

KeyDefaultDescription
StartSell / StopSell'trap' / 'stoptrap'Command names
CopRequired0Police that must be online to start selling
CopAlertPercentage20% chance a sale alerts police (before heat)
CopAlertBlipTime60Seconds the alert blip stays on the police map
RejectPercentage10% chance a buyer rejects the offer
RobPercentage10% chance a rejecting buyer tries to rob you
MaxCustomer15Max buyers in the pool
AllowPoliceToSell / Copstrue / police, sheriffWhether jobs in Config.Cops may sell
AllowEmsToSell / Emstrue / ambulanceWhether jobs in Config.Ems may sell
CustomDispatchfalseUse your own dispatch code in client/utils.lua

Market

config.lua
Config.MarketFluctuation   = true   -- master toggle
Config.MarketMinMultiplier = 0.25   -- lowest a price can go (25% of base)
Config.MarketMaxMultiplier = 1.75   -- highest a price can go (175% of base)
Config.WeeklyRepReset      = false  -- true = wipe zone reputation every Sunday
The market rolls every Sunday at 12:00 PM EST. Only drugs with fluctuates = true change; the rest keep their base price.

Dynamic pricing

config.lua
Config.DynamicPricing = true
Config.DynamicPricingCopBonus = {
    [0]  = 0.0,   -- no police: no bonus
    [2]  = 0.05,  -- 2+ police: +5%
    [5]  = 0.10,  -- 5+ police: +10%
    [10] = 0.20,  -- 10+ police: +20%
}

Heat

config.lua
Config.HeatDecayRate = 15    -- points lost per tick
Config.HeatDecayTick = 180   -- seconds between ticks
Config.HeatLow       = 100   -- low heat
Config.HeatMed       = 500   -- medium heat
Config.HeatHigh      = 1000  -- high heat

Each drug in Config.DrugList can set its own heat per sale.

Zones

A zone is a circle where selling is allowed, with its own modifiers. nil means "use the global value".

config.lua
Config.HeatZones = {
    {
        name          = "Grove",
        center        = { x = 104.02, y = -1939.47 },
        radius        = 50.0,
        bestDrugs     = { "cocaine", "meth_pouch", "crimson_flame" },
        minLevel      = nil,   -- minimum level to sell here
        copChance     = nil,   -- nil = Config.CopAlertPercentage
        robChance     = 3,     -- nil = Config.RobPercentage
        priceModifier = 1.0,   -- stacked on top of the market price
        xpMultiplier  = 1.0,
        allowedDrugs  = nil,   -- nil = every drug, or { "cocaine", "crack" }
    },
}

Leveling

config.lua
Config.XPPerSale  = 100  -- XP per milestone
Config.SalesPerXP = 50   -- sales needed per milestone

Config.Levels = {
    [1] = { xpRequired = 0,     label = "Unknown",       xpBonus = 0    },
    [2] = { xpRequired = 500,   label = "Corner Boy",    xpBonus = 0.02 },
    [3] = { xpRequired = 1500,  label = "Hustler",       xpBonus = 0.05 },
    [4] = { xpRequired = 3000,  label = "Dealer",        xpBonus = 0.08 },
    [5] = { xpRequired = 6000,  label = "Respected",     xpBonus = 0.12 },
    [6] = { xpRequired = 10000, label = "Feared",        xpBonus = 0.16 },
    [7] = { xpRequired = 15000, label = "Boss",          xpBonus = 0.20 },
    [8] = { xpRequired = 25000, label = "Living Legend", xpBonus = 0.25 },
}

Config.RobProtectionByLevel = {
    [1] = 0.00,   -- no protection
    [4] = 0.10,   -- 10% less robbery chance
    [6] = 0.25,
    [8] = 0.50,
}
Halo Backrooms gates its content on these level numbers (default: level 3). If you rename or reorder levels, check Config.RequiredLevel in Backrooms.

Street reputation

Reputation is tracked per zone as a sale count and shown with /rep. The rank sets a price bonus in that zone:

RankSalesBonus
Unknown0 – 500%
Local51 – 150+5%
Known151 – 300+10%
Respected301 – 500+15%
Street Royalty501 – 750+18%
Feared751 – 1000+22%
Living Legend1001++25%

Each day without a sale in a zone drops 10% of your sales there (at least 5). A full week away resets it. Set Config.WeeklyRepReset = true to wipe everyone on Sundays.

Drug list

Prices are per brick (1,000 units). price = { min = 200, max = 200 } means $200,000 per 1,000 units.
config.lua
Config.DrugList = {
    ['white_gold'] = {
        quantity   = { min = 1, max = 5 },      -- units per sale
        price      = { min = 200, max = 200 },  -- per 1,000 units
        blackMoney = true,                      -- true = dirty money, false = clean cash
        fluctuates = true,                      -- true = weekly market price
        heat       = 5,                         -- heat added per sale
    },
}

Buyer peds

config.lua
Config.CustomerPeds = {
    [1] = 's_f_y_baywatch_01',
    [2] = 'a_m_m_hillbilly_02',
    -- repeat a model to make it spawn more often
}

Level rewards

In server/rewards.lua. Leave a level out for no reward. Types: weapon, item, money, black_money, vehicle.

server/rewards.lua
Config.LevelRewards = {
    [2] = {
        { type = 'money', amount = 20000, label = '$20,000 Cash' },
    },
    [3] = {
        { type = 'item', name = 'weed_pouch', count = 200, label = 'Weed Pack' },
    },
    [8] = {
        { type = 'vehicle', model = 'DartyRST', label = 'Chevrolet Tahoe RST' },  -- goes to Config.GarageScript
        { type = 'money',   amount = 200000,    label = '$200,000 Cash' },
    },
}