Manipulation

AddItem

Add item to player inventory.

exports['skeexs-inventory']:AddItem(source, itemName, count?, metadata?)

Parameter	Type	Default	Description
source	number	-	Player source
itemName	string	-	Item name
count	number	1	Amount
metadata	table	{}	Item metadata

Returns: boolean, string|nil - success, error

-- Simple add
exports['skeexs-inventory']:AddItem(source, 'water', 5)

-- With metadata
exports['skeexs-inventory']:AddItem(source, 'weapon_pistol', 1, {
    ammo = 12,
    serial = 'ABC123',
    durability = 100
})

-- Check result
local success, err = exports['skeexs-inventory']:AddItem(source, 'item', 1)
if not success then
    print('Failed:', err)
end

---

RemoveItem

Remove item from player inventory.

exports['skeexs-inventory']:RemoveItem(source, itemName, count?, metadata?)

Returns: boolean, string|nil - success, error

-- Remove by name
exports['skeexs-inventory']:RemoveItem(source, 'lockpick', 1)

-- Remove with specific metadata
exports['skeexs-inventory']:RemoveItem(source, 'weapon_pistol', 1, {
    serial = 'ABC123'
})

---

SetItemMetadata

Update metadata for a specific item.

exports['skeexs-inventory']:SetItemMetadata(source, itemId, metadata)

Returns: boolean

-- Get item first
local weapon = exports['skeexs-inventory']:GetItems(source, 'weapon_pistol')[1]

-- Update its metadata
exports['skeexs-inventory']:SetItemMetadata(source, weapon.id, {
    ammo = 0,
    durability = 50
})

---

SaveInventory

Force save player inventory to database.

exports['skeexs-inventory']:SaveInventory(source)

Returns: boolean

Inventory auto-saves periodically. Use this for critical saves.

---

ClearInventory

Remove all items from player inventory.

exports['skeexs-inventory']:ClearInventory(source)

Returns: boolean

⚠️ Warning: This permanently removes all items.

---

SetInventory

Replace entire inventory with new items.

exports['skeexs-inventory']:SetInventory(source, items)

Parameter	Type	Description
items	table[]	Array of {name, amount, info?}

Returns: boolean

exports['skeexs-inventory']:SetInventory(source, {
    { name = 'phone', amount = 1 },
    { name = 'water', amount = 5 },
    { name = 'sandwich', amount = 3 }
})

⚠️ Warning: This clears existing inventory first.