Stash

Configuration schema for static world stashes, job access, and item filter lists.

Stash Definition

Configure static world stashes in shared/stash.lua:

{
    name = 'Demo Stash',

    -- Job restrictions
    jobs = {
        police = 0,
        sheriff = 0
    },

    -- Gang restrictions
    gangs = {
        balles = 1,
        lostmc = 0,
    },

    private = true,     -- Personal private stash per player
    maxWeight = 50000,  -- Weight capacity in grams
    slots = 50,         -- Available inventory slots

    -- Item filtering: use either whitelist or blacklist
    whitelist = {'water', 'bread'},
    -- blacklist = {'water', 'bread'},

    zones = {
        {
            coords = vector4(445.09, -975.05, 30.67, 0.0),
            size = vector3(2.5, 1.0, 1.5),
        },
    },
    target = {label = 'Demo Stash', icon = 'fa-vault', distance = 2.5},
    peds = {
        'mp_m_waremech_01',
    },
    scenario = 'WORLD_HUMAN_COP_IDLES'
},

Schema Parameters

Parameter Type Description
name string Unique stash identifier name
jobs table Job names and minimum rank required
gangs table Gang names and minimum rank required
private boolean True restricts stash storage per individual player
maxWeight number Total carry weight limit in grams
slots number Total number of inventory slots
whitelist table Allowed items (mutually exclusive with blacklist)
blacklist table Blocked items (mutually exclusive with whitelist)
zones table Coordinates and interaction bounding box
target table Target interaction label and distance
peds table Ped models to spawn at location
scenario string Ambient scenario played by spawned ped