Configuration#

The config lives in three files:

General#

Player and equipment#

Cash#

Config.Cash.enabled makes money and black_money real items that mirror the framework accounts in both directions. Config.Cash.accounts maps each item to the ESX and QBCore account names.

ox_inventory compatibility#

Clothing and gear#

Vehicles#

Drops#

Config.Drops controls ground drops: grid size and weight, lifetime (seconds), mergeRadius (drops closer than this merge), maxPerPlayer, renderDistance, physics settling (dropHeight, settleTimeout, settleSpeed) and the pile threshold. Config.DropDots draws the small dots over items on the ground.

Stashes#

Config.Stashes is a list of { name, label, coords, radius, width, height, maxWeight, jobs, shared }. shared = false gives every player their own stash at that spot. You can also create stashes in game. See Admin panel.

Search, frisk and give#

Weapons#

Held items#

Config.Hands controls items held in the hand: the keys (E use, right mouse throw, left mouse put down, X put away), hold and carry animations, props per model in props, and items that cannot be held in deny.

Durability#

An item can override all of this with its own durability = { shot, use, craft }. See Items.

Shops#

Each entry in shared/shops.lua:

{
    name = 'general',
    label = '24/7 Store',
    blip = { sprite = 52, color = 2, scale = 0.7 },
    width = 8,
    locations = { vec3(25.7, -1347.3, 29.49) },
    jobs = nil,
    items = {
        { name = 'water', price = 6 },
        { name = 'bandage', price = 35, stock = 20 },
    },
}

stock limits how many can be bought until the shop restocks. Shops can also be created in game.

Crafting#

Config.Recipes = {
    lockpick = {
        result = { name = 'lockpick', count = 1 },
        ingredients = { scrap_metal = 2 },
        tools = { 'repairkit' },
        duration = 4000,
    },
}

Config.Crafting = {
    aliases = { scrap_metal = { 'scrapmetal' }, cloth = { 'clothe' } },
    hand = { 'bandage', 'lockpick', 'backpack_small' },
    benches = {
        { name = 'workbench', label = 'Workbench', locations = { vec3(-347.11, -133.33, 39.01) }, recipes = { 'lockpick', 'radio' } },
    },
}

• tools are needed but not used up (they lose durability if the durability system tracks them).
• aliases let other item names count as an ingredient, for example the ox item scrapmetal for scrap_metal.
• hand lists recipes available from the inventory without a bench.
• Benches can also be created in game.

Other#