⚓Server

🟡 Server Exports

Items

--Get Table of Item List
--@param itemName? string
local origenItems = exports.origen_inventory:Items(itemName)

--- If not itemName then get ALL item list.
--- If itemName then get specific item info.

registerStash

ALIAS: exports.origen_inventory:RegisterStash(...)

--Create runtime stash
---@param id string | number
---@param labelOrStashData string | table
---@param slots number
---@param maxWeight number
---@param owner? table | string -- WIP
---@param groups? table -- WIP
---@param coords? table -- WIP
---@return table | false
exports.origen_inventory:registerStash(id, labelOrStashData, slots, maxWeight, owner, groups, coords)

-- Example usage 1
exports.origen_inventory:registerStash('police_locker', {
    label = "Police Locker",
    slots = 10,
    weight = 100
})

-- Example usage 2
exports.origen_inventory:registerStash('police_locker', "Police Locker", 10, 100000)

getInventory

ALIAS: exports.origen_inventory:GetInventory(...)

---Get object as Inventory associated ID
---@param inventory string | number
---@param inventoryType? string
---@return table | false
local inventory = exports.origen_inventory:getInventory(inventory, inventoryType)



if inventory then
    print("Inventory", json.encode(inventory))
end
--- Examples

local playerId = 1 -- or stashId
local stashId = 'test'
local trunkId = 'trunk_abc1212'
exports.origen_inventory:getInventory(playerId) -- return player inventory
exports.origen_inventory:getInventory(stashId) -- return stash id
exports.origen_inventory:getInventory(trunkId) -- return stash (trunk)

--- IMPORTANT!
--- inventoryType is optional and can be used to force the algorithm to search only one type of inventory, 
--- for example if for some reason you want to search a chest as a stash you can force it.

--- Inventory types:
-- number :: player server id
-- 'stash'
-- 'trunk'
-- 'glovebox'

addItem

ALIAS: exports.origen_inventory:AddItem(...)

---@param inventory string | number
---@param itemName string
---@param count? number
---@param metadata? string | table
---@param slot? number
---@param ignoreWeight? boolean
---@return boolean, (string | table)
exports.origen_inventory:addItem(inventory, itemName, amount, metadata, slot, ignoreWeight)

-- Example
local myStashId = 'iLoveAlex' -- Or playerId (number)
local success, msgOrItem = exports.origen_inventory:addItem(myStashId, 'tosti', 1, false, false, false)
-- or
local success, msgOrItem = exports.origen_inventory:addItem(myStashId, 'tosti', 1)
-- or 
local success, msgOrItem = exports.origen_inventory:addItem(myStashId, 'tosti', 1, { whatIs = 'this' }, false)
-- or
local success, msgOrItem = exports.origen_inventory:addItem(myStashId, 'tosti', 1, { whatIs = 'this' }, 2)
-- or
local success, msgOrItem = exports.origen_inventory:addItem(myStashId, 'tosti', 1, false, 2)

--- If not error, msgOrItem will be a last created item
print(success, msgOrItem)

--- Error msg:
--- invalid_inventory : 'Invalid inventory ID'
--- invalid_item : 'Item not found on item list
--- invalid_slot : 'Slot not found, maybe inventory full?'
--- inventory_full : '...'
--- inventory_slot_mismatch : 'Slot has item but not same name'
--- inventory_slot_mismatch_2 : 'Slot is different to giving'

AddCustomItem

ALIAS: exports.origen_inventory:AddCustomItem(...)

---@param data string | number
exports.origen_inventory:AddCustomItem(data)
local data = {
        name = string,
        label = string,
        weight = number or 0,
        rarity = data.rarity or nil,
        image = data.image or nil,
        type = data.type ('item', 'weapon'),
        description = data.description or '',
        stack = data.stack (true|false),
        close = data.close or true,
        server = data.server or nil,
        client = data.client or nil,
        buttons = data.buttons or {},
        decay = data.decay or nil,
        uses =  data.uses or nil,
    }

addItems

---@param inventory string | number
---@param items table
---@return boolean, (string | table)
exports.origen_inventory:addItems(inventory, items)

-- Example
local myStashId = 'iLoveAlex' -- Or playerId (number)
local success, msg = exports.origen_inventory:addItems(myStashId, {
    { 'tosti', 1 },
    { 'weapon_pistol', 1 }
})
-- or
local success, items = exports.origen_inventory:addItem(myStashId, {
    {
        name = 'tosti',
        amount = 1,
        metadata = {
            pollitoPio = true
        }
    },
    {
        name = 'weapon_pistol',
        amount = 1
    }
})

--- This return a list of items (#items == 0 if errors are encountered)
print(success, items)

removeItem

ALIAS: exports.origen_inventory:RemoveItem(...)

---Remove Inventory Item
---@param inventory string | number
---@param itemName string
---@param count? number Defaults 1
---@param metadata? table
---@param slot? number
---@param ignoreTotal? boolean Equals to remove ALL coincidences of the item.
---@return false
---@return string|table
exports.origen_inventory:removeItem(inventory, itemName, count, metadata, slot, ignoreTotal)

--- Examples
local playerId = 1 -- or stashId
exports.origen_inventory:removeItem(playerId , 'tosti') -- Remove 1
exports.origen_inventory:removeItem(playerId , 'tosti', 2) -- Remove 2
exports.origen_inventory:removeItem(playerId , 'tosti', 1, false, 1) -- Remove 1 on slot 1 (if exist)
exports.origen_inventory:removeItem(playerId , 'tosti', 1, {hello = 'world'}, false, true) -- Remove all with metadata 
exports.origen_inventory:removeItem(playerId , 'tosti', 1, false, 5, true) -- Remove all on slot 5

    --- Error msg:
    --- invalid_inventory : 'Invalid inventory ID'
    --- invalid_item : 'Item not found on item list
    --- invalid_slot : 'Slot not found, maybe inventory empty?
    --- inventory_slot_mismatch : 'Slot has item but not same name'
    --- inventory_slot_mismatch_2 : 'Slot is different to giving'

removeItems

---Remove Inventory Items
---@param inventory string | number
---@param items table
---@return boolean, (string | table)
exports.origen_inventory(inventory, items)
-- Item list
local items = {
    {
        name = 'tosti',
        count = 1,
        metadata? = 1,
        slot? = 1
    }
}

-- Metadata & slot are optional.

getItem

ALIAS: exports.origen_inventory:GetItem(...)

---@param inventory string | number
---@param itemName string
---@param metadata string | table
---@param returnsCount any
---@return false | table, string?
exports.origen_inventory:getItem(inventory, itemName, metadata, returnsCount)

-- Usage

--- Hypothetical inventory
--[[
  {
    [1] = {
      name = 'tosti'.
      amount = 2,
      metadata = {
        whatIs = 'this'
      },
      slot = 1
    },
    [2] = {
      name = 'tosti'.
      amount = 5,
      metadata = {},
      slot = 2
    }
  }
--- ]]

-- Returns the amount with a metadata, the search is NOT strict, meaning if there are many metadata, it will only search for the one you have placed.
-- If you disable returnsCount, the search will be strict and will return all items that match only the metadata provided.

local playerInventory = 1 -- source?
local itemCount = exports.origen_inventory:getItem(playerInventory, 'tosti', false, true)

print(itemCount) -- returns 7

local itemData = exports.origen_inventory:getItem(playerInventory, 'tosti', { whatIs = 'this' }, false)
print(itemData) -- returns {{ name = 'tosti', amount = 1, metadata = { whatIs = 'this' } }}

local itemData = exports.origen_inventory:getItem(playerInventory, 'tosti', false, false)
print(itemData) -- returns all name coincidence items, as table 

getItems

ALIAS: exports.origen_inventory:getInventoryItems(...) exports.origen_inventory:GetInventoryItems(...

---@param inventory string | number
---@return table
local inventoryItems = exports.origen_inventory:getItems(inventory)

for slot, item in pairs(inventoryItems) do
    print("The item on slot", slot, "is", item.name)
end

getSlot

ALIAS: exports.origen_inventory:GetSlot(...)

---Get Inventory Slot
---@param inventory string|number
---@param slot number
---@return boolean
---@return string
exports.origen_inventory:getSlot(inventory, slot)

getItemCount

ALIAS: exports.origen_inventory:GetItemCount(...)

---Get Inventory Item Count
---@param inventory string | number
---@param itemName string
---@param metadata table | string
---@param strict boolean
---@return false, string?
exports.origen_inventory:getItemCount(inventory, itemName, metadata, strict)

-- Same as above, but allowing a strict search or not. (Only returns a number, not the items)
local playerInventory = 1 -- source?
local itemCount = exports.origen_inventory:getItemCount(playerInventory, 'tosti', false, false)
print(itemCount) -- returns 7

local itemCount = exports.origen_inventory:getItemCount(playerInventory, 'tosti', { whatIs = 'this' }, true)
print(itemCount) -- returns 1
  
--- Examples
local fakeInventory = { 
  [1] = { count = 1, metadata = { hello = 'world', test = 'no' }, name = 'tosti' }, 
  [2] = { count = 2, metadata = { hello = 'world' }, name = 'tosti' } 
}
local playerId = 1 -- or stashId
exports.origen_inventory:getItemCount(playerId , 'tosti') -- return 3
exports.origen_inventory:getItemCount(playerId , 'tosti'. {hello = 'world'}) -- return 3
exports.origen_inventory:getItemCount(playerId , 'tosti', {hello = 'world'}, true) -- return 1

getInventoryItems

ALIAS: exports.origen_inventory:getInventoryItems(...)

---Get Inventory Items
---@param inventory string | number
---@return table
exports.origen_inventory:getInventoryItems(inventory)

setMetadata

ALIAS: exports.origen_inventory:SetMetadata(...)

--- Set Metadata to item
--- @param inventory string | number
--- @param slot number
--- @param metadata table
--- @return boolean
--- @return string
exports.origen_inventory:setMetadata(inventory, slot, metadata)

-- Example
local inventory = 'police_locker'
local slot = 1
local metadata = {
    hello = "world"
}
exports.origen_inventory:setMetadata(inventory, slot, metadata)

canCarryItem

ALIAS: exports.origen_inventory:CanCarryItem(...)

---Check if inventory can carry item based on weight
---@param inventory string | number
---@param itemName string
---@param metadata? table | string
---@return boolean, string
exports.origen_inventory:canCarryItem(inventory, itemName, count, metadata)

-- Example
if exports.origen_inventory:canCarryItem(source, 'water', 3) then
    -- Do stuff if can carry
else
    -- Do stuff if can't carry
end

canSwapItem

ALIAS: exports.origen_inventory:CanSwapItem(...)

-- Check if item can swap with another.
---@param inventory string|number
---@param firstItem string
---@param firstItemCount number
---@param testItem string
---@param testItemCount number
---@return boolean
---@return string
exports.origen_inventory:canSwapItem(inventory, firstItem, firstItemCount, testItem, testItemCount)

setMaxWeight

---Set Inventory Max Weight
---@param inventory number | string
---@param weight number
---@return boolean
---@return string
exports.origen_inventory:setMaxWeight(inventory, weight)

setMaxSlots

ALIAS: exports.origen_inventory:SetSlotCount(...)

---Set Inventory Max Weight
---@param inventory number | string
---@param weight number
---@return boolean
---@return string
exports.origen_inventory:setMaxSlots(inventory, slots)

useSlot

---Use Item in Slot
---@param slot number
---@param playerId number
---@return boolean
exports.origen_inventory:useSlot(slot, playerId)

saveInventory

ALIAS: exports.origen_inventory:SaveInventory(...)

---Save Inventory
---@param inventory string | number
---@return boolean
---@return string
exports.origen_inventory:saveInventory(inventory)

getSlotsIdWithItem

---Get all slot ids in an inventory matching the given name and metadata.
---@param inventory string | number
---@param itemName string
---@param metadata table | string
---@param strict boolean
---@return boolean | string
---@return number[]
exports.origen_inventory:getSlotsIdWithItem(inventory, itemName, metadata, strict)

getSlotIdWithItem

---Get a slot id in an inventory matching the given name and metadata.
---@param inventory string | number
---@param itemName string
---@param metadata table | string
---@param strict boolean
---@return boolean | string
---@return number
exports.origen_inventory:getSlotIdWithItem(inventory, itemName, metadata, strict)

setItem

--- Set Inventory Item (set exact amount of item in inventory)
---@param inventory string | number
---@param itemName string
---@param amount number
---@param metadata? table | string
---@return boolean
---@return boolean | string | table
exports.origen_inventory:setItem(inventory, itemName, amount, metadata)

GetItemLabel

exports.origen_inventory:GetItemLabel(itemName)

addItemMetadata

ALIAS: exports.origen_inventory:AddItemMetadata(...)

---Add metadata to slot
---@param inventory string | number
---@param slot number
---@param key string
---@param value any
---@return boolean
---@return string
exports.origen_inventory:addItemMetadata(playerId, item, slot, metadata)

removeItemMetadata

---Remove metadata from slot
---@param inventory string | number
---@param slot number
---@param key string
---@return boolean
---@return string
exports.origen_inventory:removeItemMetadata(playerId, item, slot)

setUses

--- Set Uses to item
---@param inventory string | number
---@param slot number
---@param uses number
---@param ignoreMax boolean
---@return boolean
---@return string
exports.origen_inventory:setUses(inventory, slot, uses, ignoreMax)

notify

---Notify player with item box
---@param playerId number
---@param action string
---@param itemName string
---@return boolean
exports.origen_inventory:notify(playerId, action, itemName)

Shops Exports

createShop

ALIAS: exports.origen_inventory:CreateShop(...)-exports.origen_inventory:RegisterShop(...)

--- Create the shop
---@param shopId
---@param shopData data
exports.origen_inventory:createShop(shopId, shopData)

--- Example:
exports.origen_inventory:createShop({
        label = 'Shop',
        slots = 4,
        blip = {
            enabled = true,
            sprite = 52,
            color = 2,
            scale = 0.8,
            name = 'ORIGEN Shop Armas',
        },
        locations = {vector3(-1299.95, -2458.56, 13.94)},
        items = Config.ShopItems['weapons']
})

Happy Coding!

Deprecated Exports

• These exports continue to function as long as they are on this list, please prioritize replacing with new exports.

• Support for these exports is a lower priority, you can request new exports on our support discord.

StashGetItemByname

exports.origen_inventory:StashGetItemByname(stash_name, item_name)

GiveWeaponToPlayer

exports.origen_inventory:GiveWeaponToPlayer(playerId, weapon_name, ammo)

ClearInventory

exports.origen_inventory:ClearInventory(playerId, filter)

SetInventoryItems

exports.origen_inventory:SetInventoryItems(playerId, item, amount)

GetTotalWeight

exports.origen_inventory:GetTotalWeight(playerId)

HasItem

exports.origen_inventory:HasItem(playerId, item, amount)

GetItemByName

exports.origen_inventory:GetItemByName(playerId, item)

GetSlotsByItem

exports.origen_inventory:GetSlotsByItem(items, item)

GetItemByslot

exports.origen_inventory:GetItemBySlot(playerId, slot)

GetFirstSlotByItem

exports.origen_inventory:GetFirstSlotByItem(items, item)

GetItemTotalAmount

exports.origen_inventory:GetItemTotalAmount(playerId, item)

SetInventoryData

exports.origen_inventory:SetInventoryData(fromInventory, toInventory, fromSlot, toSlot, fromAmount, toAmount)

LoadInventory

-- Note: firstLoading represents whether the inventory should be loaded from the database (true) or from the cache (false).
exports.origen_inventory:LoadInventory(playerId, firstLoading?)

GetPlayerInventory

exports.origen_inventory:getPlayerInventory(playerId)

GetUsableItem

exports.origen_inventory:GetUsableItem(name)

CreateUseableItem

exports.origen_inventory:CreateUseableItem(name, cb)

UseItem

exports.origen_inventory:UseItem(playerId, name)

UseItemSlot

exports.origen_inventory:UseItemSlot(slot, inventory_id)

GetTotalWeightByItems

local items = { 'id_card', 'sandwich' }
exports.origen_inventory:GetTotalWeightByItems(items)

OpenInventoryById

exports.origen_inventory:OpenInventoryById(playerId, otherPlayerId)

GetItemByMetadata

exports.origen_inventory:GetItemByMetadata(playerId, metaKey, metaValue)

GetItemsByMetadata

exports.origen_inventory:GetItemsByMetadata(playerId, metaKey, metaValue)

GetItemByMetaKey

exports.origen_inventory:GetItemByMetaKey(playerId, metaKey)

GetItemsByMetaKey

exports.origen_inventory:GetItemsByMetaKey(playerId, metaKey)

GetItemInfoBySlot

exports.origen_inventory:GetItemInfoBySlot(playerId, itemName, slot)