⚙️Inventory ( v2 )

Acompanhe abaixo as nossas exports juntamente com exemplos de funcionamento e as instruções precisas para realizar a exportação de forma correta.

🧊openInventory:

inventory:openInventory( player )

✅ giveItem:

Uso do giveitem apenas para enviar um novo item para o inventário.

inventory:giveItem( player, 'agua', 1 )

Uso do giveitem para clonar o item ( utilizado em baú ou quando desejar apenas herdar os dados do item como o payload, durabilidade e uuid ).

local uuid = '1ddb2511ad87647825b5dfdb4f21c89f' -- Esse é o identificador único do item, para que você possa 'clonar' todas as informações do item para utilizar por exemplo em um baú você precisa saber esse UUID, pois o item do inventário possui além do identificar único, um payload, onde registra a ação do item como por exemplo a placa de um veículo para um sistema de chave.
local checkQuantity, checkDurability, checkPayload, checkUUID = inventory:getItem( player, 'agua', uuid )
inventory:giveItem( player, 'agua', 1, checkDurability, checkUUID, checkPayload )

📍 takeItem:

Se o item possuir UUID no config do sistema, utilize informando o UUID no último argumento para que faça a ação no item correto.

inventory:takeItem( player, 'agua', 1 )

🔆 getItem:

Se o item possuir UUID no config do sistema, utilize informando o UUID no último argumento para que faça a ação no item correto.

local checkQuantity, checkDurability, checkPayload, checkUUID = inventory:getItem( player, 'agua' )

🧠 getItemFromUUID:

local type = 'chest' -- 'inventory', 'chest' ou 'trunk'
local identify = 'Nome do Baú'
local infos = inventory:getItemFromUUID( uuid, type, identify )

ℹ️ notify_item:

Possui 3 modos de aviso:

1 - 'give' 2 - 'take' 3 - 'send'

inventory:notify_item( player, 'agua', 1, 'give' )

👀 getItemConfig:

local config = inventory:getItemConfig( 'agua' )

📦 dropItem:

A função de dropItem precisa que seja informado o UUID do item para que a função possa buscar as demais informações como a durabilidade, payload entre outros.

inventory:dropItem( player, 'agua', uuid, 1 )

🔫garmas:

Essa função faz guardar todas as armas que o player possuir equipadas

inventory:garmas( player )

Caso deseje apenas guardar uma arma especifica utilize: nome do item ou modelo configurado no config do sistema.

inventory:garmasOne( player, 'm4' ou 31 )

🔐Exemplo da utilização do payload:

Neste exemplo abaixo, eu estou inserindo um payload dentro do meu item 'chave carro' a qual registra a placa daquele veículo e também valida se o player já não possui o mesmo item com o mesmo payload. Desta maneira você consegue utilizar o item para apenas executar o payload único.

local inventory = exports['[HS]Inventory']
local plate = getVehiclePlateText( vehicle )
local itens = inventory:getPlayerAllItens( player )
if plate ~= 'EMPLC' then
    for i, v in ipairs( itens or { } ) do
        if v.item == 'chave carro' and v.payload == plate then
            return false
        end
    end
    inventory:giveItem( player, 'chave carro', 1, false, false, false, plate )
end

⚖️ checkWeight:

Essa função verifica se você possui espaço na sua mochila.

local check = inventory:getItemConfig( 'agua' )
inventory:checkWeight( player, ( check.kg * quantidade ) )

⚖️ isBagOverweight:

Essa função valida se a mochila do player possui espaço suficiente para a lista de itens informada.

local list = {
    { item = 'agua', quantity = 10 };
    { item = 'm4', quantity = 1 }
}
local check = inventory:isBagOverweight( player, list )

🎒 setPlayerkg:

Essa função seta KG na mochila.

inventory:setPlayerkg( player, 'agua', quantidade )

🎒 takePlayerkg:

Essa função remove KG da mochila.

inventory:takePlayerkg( player, 'agua', quantidade )

🎒setKgMaxDefault:

inventory:setKgMaxDefault( player )

🎒 getPlayerkg:

Essa função obtém o valor em KG da mochila do player, você pode passar tanto o elemento do player quanto o account direto.

inventory:getPlayerkg( player ou account )

👮inspectInventory:

Essa função abre o inventário do revistado e o inventário de quem está revisando.

inventory:inspectInventory( player, alvo )

👛 openChest:

Essa função abre o baú obtendo o nome do baú através do elementData.

local name = getElementData( alvo, 'HS:chest' ) or false
if name then
    inventory:openChest( player, name )
end

👛createChest:

    local chest = 'Nome do Baú'
    local password = 1234
    local x, y, z = getElementPosition( player )
    local rx, ry, rz = getElementRotation( player )
    inventory:createChest( chest, {
        max = 100,
        settings = {
            password = password,
            pos = { x, y, z - 1 },
            rot = rz,
            dim = getElementDimension( player ),
            int = getElementInterior( player ),
            webhook = ''
        };
        items = {
            { item = 'taco', quantity = 1 };
            { item = 'chips', quantity = 2 };
            { item = 'hamburguer', quantity = 3 };
        };
    } )

👛resetChest:

local chest = 'Nome do Baú'
inventory:resetChest( chest )

👛 deleteChest:

local chest = 'Nome do Baú'
inventory:deleteChest( chest )

🚗 openTrunk:

inventory:openTrunk( player, vehicle )

🐸getStorage:

Essa função obtém os dados do baú ( chest ) e porta malas ( trunk ). No baú o identify é o nome do baú e no porta malas o identificar é a placa do veículo.

local type = 'chest'
local identify = 'Nome do Baú'
local infos = inventory:getStorage( type, identify )

🐸giveItemToStorage:

local type = 'chest'
local identify = 'Nome do Baú'
inventory:giveItemToStorage( type, player, identify, uuid, quantidade )

🐸 takeItemFromStorage:

local type = 'chest'
local identify = 'Nome do Baú'
inventory:takeItemFromStorage( type, player, identify, uuid, quantidade )