Configuration

drug sales is set up in three files at the root of the resource, all shipped open: config.lua (the Config table), strings.lua (every line players read) and logs.lua (logging, read by the server only). The prompt system is a line in client/functions.lua. Changes apply when the resource starts again.

The sections below follow config.lua from the top.

SetupCopy Anchor Link

The custom options are empty branches in client/functions.lua, which ships open. See developers.

DispatchCopy Anchor Link

Config.Setup.dispatch takes cd_dispatch, ps-dispatch, qs-dispatch, core_dispatch, rcore_dispatch, aty_dispatch, op-dispatch, origen_police, emergencydispatch or custom. An alert is sent when a buyer turns a player down and when a bystander reports a sale.

Most alerts read 10-420 | Drug Sale with "A citizen has reported a potential drug sale on" and the street; core_dispatch gets 10-911, "Potential Drug Sale". cd_dispatch, qs-dispatch, rcore_dispatch, aty_dispatch and emergencydispatch alert the jobs in Config.Police.jobs; core_dispatch, op-dispatch and origen_police alert police. The text of each is in PoliceDispatch in client/functions.lua.

custom, the default, sends nothing. To use another dispatch, write its call in PoliceDispatch in client/functions.lua, under the custom branch:

elseif Config.Setup.dispatch == 'custom' then
    -- data.coords: where the seller stands, data.street: the street name
    exports['my-dispatch']:SendAlert({
        code = '10-420',
        title = 'Drug Sale',
        coords = data.coords,
        street = data.street,
        jobs = Config.Police.jobs,
    })
end

(my-dispatch and its SendAlert stand for your dispatch's own export.)

PoliceCopy Anchor Link

ReputationCopy Anchor Link

Config.Reputation = {
    levelUp = 25000,
    levels = {
        [1] = { description = 'Being new to dealing can be tough', priceBoost = 0, reduceReject = 0, reduceRobbery = 0 },
        [2] = { description = 'You\'re getting some loyal clients', priceBoost = 5, reduceReject = 10, reduceRobbery = 0 },
        -- levels 3 to 5 as in the table on the selling page
    }
}

The defaults for every level are on the selling page. XP per sale is set per zone, in addXP.

AnimationsCopy Anchor Link

Each has dict and clip. A prop has model, pos and rot (vectors, relative to the hand), and duration is in milliseconds.

Purity pricingCopy Anchor Link

Config.Metadata lists the items priced by a number in their metadata instead of a zone's price range. Any item from any script can be listed.

Config.Metadata = {
    ['ls_cocaine_bag'] = { key = 'purity', price_per_purity = 2.5, perfect_bonus = 100 },
    ['ls_meth']        = { key = 'purity', price_per_purity = 2.5, perfect_bonus = 100 },
    -- ...
}

Listed by default: ls_cocaine_bag and ls_crack_bag (coke processing), ls_meth (meth crafting) and the six lation weed bags: ls_og_kush_bag, ls_banana_kush_bag, ls_blue_dream_bag, ls_purple_haze_bag, ls_orange_crush_bag and ls_cosmic_kush_bag.

The value is read from the first stack of that item the player carries. A listed item with no value sells for $2 (a value of 1) and F8 prints a warning. Remove an item from the table to price it by its zone's price range again.

ZonesCopy Anchor Link

Config.Zones is a numbered list of zones. Add, move or remove them freely; the six defaults are described on the selling page.

Config.Zones = {
    [1] = {
        name = 'Vinewood',
        coords = vec3(284.3999, -86.8160, 70.1332),
        size = 500,
        settings = { ... },
        drugs = { ... },
        blip = { ... },
        ignoreModels = { 's_f_y_cop_01', 's_m_y_cop_01' },
    },
}

SettingsCopy Anchor Link

Config.Zones[n].settings, with Vinewood's values:

MoneyCopy Anchor Link

What money does depends on your framework:

DrugsCopy Anchor Link

Config.Zones[n].drugs lists the items a zone buys, keyed by item name. Every default zone lists the same nine; see the drugs.

drugs = {
    ['ls_og_kush_bag'] = {
        label = 'OG Kush Weed',
        icon = 'fas fa-cannabis',
        level = 1,
        callChance = 5,
        price = { min = 50, max = 100 },
        quantity = { min = 1, max = 1 },
        object = {
            model = 'prop_weed_bottle',
            position = vec3(0.13, 0.02, 0.0),
            rotation = vec3(-90.0, 0.0, 0.0)
        },
    },
}

To sell another item, add an entry with its item name to every zone that should buy it.

BlipCopy Anchor Link

Ignored modelsCopy Anchor Link

ignoreModels lists ped models that won't buy in that zone. A player who tries one sees "The buyer completely ignores you". The defaults are the two police models, s_f_y_cop_01 and s_m_y_cop_01.

Prompt systemCopy Anchor Link

The selling and claim prompts go through a line at the top of client/functions.lua:

TextCopy Anchor Link

strings.lua holds every line players read, in English, in the Strings table:

LogsCopy Anchor Link

logs.lua is loaded by the server only, so a webhook in it never reaches players.

Every event is off by default, so nothing is logged until you turn one on.