Examples

Job Script

Basic mining job with item requirements:

RegisterNetEvent('miner:startMining', function()
    local src = source
    
    -- Require pickaxe
    if not exports['skeexs-inventory']:HasItem(src, 'pickaxe', 1) then
        TriggerClientEvent('QBCore:Notify', src, 'You need a pickaxe', 'error')
        return
    end
    
    -- Check weight capacity
    if not exports['skeexs-inventory']:CanCarryWeight(src, 1500) then
        TriggerClientEvent('QBCore:Notify', src, 'Inventory full', 'error')
        return
    end
    
    -- Start client animation
    TriggerClientEvent('miner:client:animation', src)
    
    Wait(5000)
    
    -- Give ore
    exports['skeexs-inventory']:AddItem(src, 'iron_ore', 3, {
        quality = math.random(50, 100)
    })
    
    TriggerClientEvent('QBCore:Notify', src, 'You mined 3x Iron Ore', 'success')
end)

---

Durability System

Lockpick with durability that breaks after uses:

-- Register usable item
exports['skeexs-inventory']:CreateUsableItem('lockpick', function(src, item)
    local durability = item.metadata.durability or 100
    
    if durability <= 0 then
        TriggerClientEvent('QBCore:Notify', src, 'Lockpick is broken', 'error')
        return false
    end
    
    TriggerClientEvent('lockpick:start', src, item.id)
    return false
end, false)

-- Handle result
RegisterNetEvent('lockpick:result', function(itemId, success)
    local src = source
    local item = exports['skeexs-inventory']:GetItemById(src, itemId)
    if not item then return end
    
    local durability = item.metadata.durability or 100
    durability = durability - (success and 10 or 30)
    
    if durability <= 0 then
        exports['skeexs-inventory']:RemoveItem(src, 'lockpick', 1)
        TriggerClientEvent('QBCore:Notify', src, 'Lockpick broke!', 'error')
    else
        item.metadata.durability = durability
        exports['skeexs-inventory']:SetItemMetadata(src, itemId, item.metadata)
    end
end)

---

Crafting System

local Recipes = {
    ['lockpick'] = {
        time = 5000,
        requires = {
            { name = 'metalscrap', amount = 2 },
            { name = 'plastic', amount = 1 }
        },
        result = { name = 'lockpick', amount = 1 }
    }
}

RegisterNetEvent('craft:item', function(recipeName)
    local src = source
    local recipe = Recipes[recipeName]
    if not recipe then return end
    
    -- Check materials
    for _, req in ipairs(recipe.requires) do
        if not exports['skeexs-inventory']:HasItem(src, req.name, req.amount) then
            TriggerClientEvent('QBCore:Notify', src, 'Missing materials', 'error')
            return
        end
    end
    
    -- Check space
    local canAdd = exports['skeexs-inventory']:CanAddItem(src, recipe.result.name, recipe.result.amount)
    if not canAdd then
        TriggerClientEvent('QBCore:Notify', src, 'No space', 'error')
        return
    end
    
    -- Remove materials
    for _, req in ipairs(recipe.requires) do
        exports['skeexs-inventory']:RemoveItem(src, req.name, req.amount)
    end
    
    Wait(recipe.time)
    
    -- Give result
    exports['skeexs-inventory']:AddItem(src, recipe.result.name, recipe.result.amount)
    TriggerClientEvent('QBCore:Notify', src, 'Crafted ' .. recipeName, 'success')
end)

---

Police Evidence Locker

CreateThread(function()
    local storage, err = exports['skeexs-inventory']:CreateStorage({
        id = 'evidence_mrpd',
        label = 'MRPD Evidence Locker',
        coords = vector3(450.0, -980.0, 30.0),
        slots = { width = 10, height = 10 },
        maxWeight = 500000,
        access = {
            jobs = { 'police' },
            grades = { 2, 3, 4 }
        }
    })
    
    if storage then
        print('Evidence locker created')
    end
end)

-- Log evidence actions
AddEventHandler('skeexs-inventory:itemAdded', function(source, itemName, count, metadata)
    if metadata and metadata.storageId == 'evidence_mrpd' then
        print('[Evidence] Player', source, 'added', count, 'x', itemName)
    end
end)

---

Weapon Ammo Check

RegisterNetEvent('police:fireWeapon', function()
    local src = source
    
    local weapon = exports['skeexs-inventory']:GetPlayerEquippedWeapon(src)
    if not weapon then return end
    
    local ammo = weapon.metadata.ammo or 0
    
    if ammo <= 0 then
        TriggerClientEvent('QBCore:Notify', src, 'No ammo!', 'error')
        return
    end
    
    -- Decrease ammo
    weapon.metadata.ammo = ammo - 1
    exports['skeexs-inventory']:SetItemMetadata(src, weapon.id, weapon.metadata)
end)