Items

HasItem

Check if player has an item.

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

Parameter	Type	Default	Description
source	number	-	Player source
itemName	string	-	Item name
count	number	1	Minimum amount
metadata	table	nil	Metadata to match

Returns: boolean

if exports['skeexs-inventory']:HasItem(source, 'lockpick') then
    -- Has at least 1 lockpick
end

-- Check for specific metadata
if exports['skeexs-inventory']:HasItem(source, 'keycard', 1, { level = 'admin' }) then
    -- Has admin keycard
end

---

GetItemCount

Get total count of an item.

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

Returns: number

local count = exports['skeexs-inventory']:GetItemCount(source, 'water')
print('Player has', count, 'water bottles')

---

GetItems

Get all items of a specific type.

exports['skeexs-inventory']:GetItems(source, itemName)

Returns: table[] - Array of items

local weapons = exports['skeexs-inventory']:GetItems(source, 'weapon_pistol')
for _, weapon in ipairs(weapons) do
    print(weapon.id, weapon.metadata.ammo, weapon.metadata.serial)
end

---

GetItemById

Get a specific item by its ID.

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

Returns: table|nil

local item = exports['skeexs-inventory']:GetItemById(source, 'abc-123')
if item then
    print(item.name, item.count, item.metadata)
end

---

GetInventory

Get player's full inventory.

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

Returns: table|nil

local inv = exports['skeexs-inventory']:GetInventory(source)
-- inv.items, inv.weight, inv.maxWeight, inv.width, inv.height

---

GetWeight

Get player's current and max weight.

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

Returns: number, number - currentWeight, maxWeight

local current, max = exports['skeexs-inventory']:GetWeight(source)
local percent = (current / max) * 100

---

CanAddItem

Check if an item can be added.

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

Returns: boolean, string|nil - success, reason

local canAdd, reason = exports['skeexs-inventory']:CanAddItem(source, 'gold_bar', 10)
if not canAdd then
    print('Cannot add:', reason)  -- "Too heavy" or "No space"
end

---

CanCarryWeight

Check if player can carry additional weight.

exports['skeexs-inventory']:CanCarryWeight(source, weight)

Returns: boolean

if exports['skeexs-inventory']:CanCarryWeight(source, 5000) then
    -- Can carry 5kg more
end