inventory - VORP Core

This documentation is for developers who are making scripts for VORP Core Framework

Exports

These exports are client side only!

Items
Inventory

Getters

getInventoryItems

get all user inventory items

table

returns a table containing all the items in the inventory

local result = exports.vorp_inventory:getInventoryItems()

getInventoryItem

get user inventory item

name

the item name

table

returns a table containing the item name,label,weight,desc metadata, percentage

local result = exports.vorp_inventory:getInventoryItem()

getServerItem

string|table

the item name to get or an table of items to get in one single call, returns the data from items database like label,weight,desc,metadata etc

local result = exports.vorp_inventory:getServerItem("water")
print(result.label)

closeInventory

close inventory

exports.vorp_inventory:closeInventory()

These exports are server side only!

Weapons
Items
Inventory items
Inventory weapons
Inventory misc

Getters

getUserAmmo

get all user ammo

int

required

The player id

function

callback function syncronous or asyncronous

table

returns a table containing all the ammo

exports.vorp_inventory:getUserAmmo(source, callback)

canCarryWeapons

check if player can carry weapons

int

required

The player id

int

required

amount of weapons

function

callback function syncronous or asyncronous

string | number

weapon name or hash its needed to check weight since 3.6

boolean

returns true if the player can carry the weapons

exports.vorp_inventory:canCarryWeapons(source, amount,callback, weaponName)

getUserWeapon

get user inventory weapon

int

required

The player id

function

callback function syncronous or asyncronous

number

weapon id

table

{id:number,name:string,propietary:string,used:boolean,desc:string,group:number,source:number,label:string,serial_number:string,custom_label:string,custom_desc:string}

exports.vorp_inventory:getUserWeapon(source, callback,weaponId)

getUserInventoryWeapons

get user inventory weapons

int

required

The player id

function

callback function syncronous or asyncronous

table

{id:number,name:string,propietary:string,used:boolean,desc:string,group:number,source:number,label:string,serial_number:string,custom_label:string,custom_desc:string}

exports.vorp_inventory:getUserInventoryWeapons(source, callback)

getWeaponBullets

get weapon bullets

int

required

The player id

number

required

weapon id

function

callback function syncronous or asyncronous

number

weapon ammo

exports.vorp_inventory:getWeaponBullets(source,weaponID, callback)

getWeaponComponents

get weapon components

int

required

The player id

number

required

weapon id

function

callback function syncronous or asyncronous

table

returns a table containing the weapon components

exports.vorp_inventory:getWeaponComponents(source, weaponId, callback)

Setters

setWeaponCustomDesc

set weapon custom description

int

required

The player id

number

required

weapon id

string

required

weapon description

function

callback function syncronous or asyncronous

boolean

returns true if the description was successfully set

exports.vorp_inventory:setWeaponCustomDesc(weaponId, desc, cb)

setWeaponCustomLabel

set weapon custom label

int

required

The player id

number

required

weapon id

string

required

weapon label

function

callback function syncronous or asyncronous

boolean

returnstrue if the label was successfully set

exports.vorp_inventory:setWeaponCustomLabel(weaponId, label, cb)

setWeaponSerialNumber

set weapon serial number

int

required

The player id

number

required

weapon id

string

required

weapon serial number

function

callback function syncronous or asyncronous

boolean

returns true if the serial number was successfully set

exports.vorp_inventory:setWeaponSerialNumber(weaponId, serial, cb)

subWeapon

remove weapon from user inventory

int

required

The player id

number

required

weapon id

function

callback function syncronous or asyncronous

boolean

returns true if the weapon was successfully removed

exports.vorp_inventory:subWeapon(source, weaponId, callback)

giveWeapon

give weapon to user

int

required

The player id

number

required

weapon id

int

required

target id

function

callback function syncronous or asyncronous

boolean

returns true if the weapon was successfully given

exports.vorp_inventory:giveWeapon(source, weaponId, target,callback)

createWeapon

create weapon

int

required

The player id

string

required

weapon name

string

required

amount of ammo

table

required

weapon components

table

required

weapon components

function

callback function syncronous or asyncronous

int

leave this as nil, this is used internally only

string

custom serial number for weapon

string

custom label for weapon

string

custom desc for weapons

boolean

if async

exports.vorp_inventory:createWeapon(source, weaponName, ammo, components, comps, callback,serial,label,desc)

deleteWeapon

delete weapon

int

required

The player id

number

required

weapon id

function

callback function syncronous or asyncronous

boolean

if async

exports.vorp_inventory:deleteWeapon(source, weaponId, callback)

addBullets

add bullets

int

required

The player id

string

required

bullet type

number

required

amount of bullets

function

callback function syncronous or asyncronous

boolean

returns true if the bullets were successfully added

exports.vorp_inventory:addBullets(source, bulletType, amount,callback)

subBullets

remove bullets from weapon

number

required

weapon id

string

required

bullet type

number

required

amount of bullets

function

callback function syncronous or asyncronous

boolean

returns true if the bullets were successfully removed

exports.vorp_inventory:subBullets(weaponId, bulletType, amount,callback)

removeAllUserAmmo

remove all user ammo

int

required

The player id

exports.vorp_inventory:removeAllUserAmmo(source)

addWeaponComponent

add a component to a weapon

int

required

The player id

number

required

weapon id

string | number

required

component name or hash

string | number

required

slot category

function

callback function syncronous or asyncronous

boolean

returns true if the component was successfully added

exports.vorp_inventory:addWeaponComponent(source, weaponId, component, category, callback)

addWeaponComponents

add multiple components to a weapon

int

required

The player id

number

required

weapon id

table

required

a table where the key is the component name or hash and the value is the slot category { [component] = category }

function

callback function syncronous or asyncronous

boolean

returns true if the components were successfully added

exports.vorp_inventory:addWeaponComponents(source, weaponId, components, callback)

subWeaponComponent

remove a component from a weapon

int

required

The player id

number

required

weapon id

string | number

required

component name or hash

string | number

required

slot category

function

callback function syncronous or asyncronous

boolean

returns true if the component was successfully removed

exports.vorp_inventory:subWeaponComponent(source, weaponId, component, category, callback)

subWeaponComponents

remove multiple components from a weapon

int

required

The player id

number

required

weapon id

table

required

a table where the key is the component name or hash and the value is the slot category { [component] = category }

function

callback function syncronous or asyncronous

boolean

returns true if the components were successfully removed

exports.vorp_inventory:subWeaponComponents(source, weaponId, components, callback)

Getters

canCarryItem

check if player can carry the item before adding it to the inventory

int

required

The player id

string

required

The item name

int

required

The amount of items

function

The callback function syncronous or asyncronous

boolean

returns true if the player can carry the item

exports.vorp_inventory:canCarryItem(source, item, amount, callback)

getUserInventoryItems

gets all the items in the player inventory

int

required

The player id

function

The callback function syncronous or asyncronous

table

returns a table containing all the items in the inventory

exports.vorp_inventory:getUserInventoryItems(source, callback)

getItemCount

get item amount from player inventory

int

required

The player id

function

callback function for syncronous or asyncronous

string

required

item name

table

item metadata

int

allows to control what items to get, if 0 gets all items with no metadata if meta was not passed if 0 gets items expired, anything above 0 or equal will return those item count

int

returns the amount of items in the inventory

usage

exports.vorp_inventory:getItemCount(source, callback, item, metadata, percentage)

getItemDB

get DB item

string

required

item name

function

callback function asyncronous or syncronous

table

returns a table containing item info

exports.vorp_inventory:getItemDB(item, callback)

getItemById

get item by main id

int

required

The player id

int

required

item id

function

callback function syncronous or asyncronous

table

{id:number, label:string, name:string, metadata:table, group:number, type:string, count:number, limit:number,canUse:boolean,percenage:integer,description:string,weight:number}

exports.vorp_inventory:getItemById(source, id, callback)

getItem

get item data

int

required

The player id

string

required

item name

function

callback function syncronous or asyncronous

table

item metadata

int

get an item only at a certain percentage, if 0 it gets tems expired if nil gets any item if more than 0 gets any item that equals or is above

table

{id:number, label:string, name:string, metadata:table, group:number, type:string, count:number, limit:number,canUse:boolean,weight:number,desc:string,percentage:integer}

exports.vorp_inventory:getItem(source, item,callback, metadata,percentage)

Setters

addItem

add item to user

int

required

The player id

string

required

item name

int

required

amount of item

table

item metadata

function

callback function syncronous or asyncronous

boolean

if true will not trigger the event OnItemCreated

boolean

returns true if the item was successfully added

exports.vorp_inventory:addItem(source, item, amount, metadata, callback,event)

subItem

remove item from user inventory

int

required

The player id

string

required

item name

int

required

amount of item

table

item metadata

function

callback function syncronous or asyncronous

boolean

event OnItemRemoved to be fired, if true it wont be sent, false or nil it will fire the event

int

allows to control percentage of items to remove, if nil removes any, if 0 removes expired items only, if more than 0 it removes anything above or equal

boolean

returns true if the item was successfully removed

exports.vorp_inventory:subItem(source, item, amount, metadata, callback,event,percentage)

subItemById

remove item from user inventory by its id exort available on verion 3.9 and up lower versions uses subItemID

int

required

The player id

int

required

item id

function

callback function syncronous or asyncronous

boolean

event OnItemRemoved to be fired, if true it wont be sent, false or nil it will fire the event

int

amount to remove

boolean

returns true if the item was successfully removed

exports.vorp_inventory:subItemById(source, itemId,callback,event,amount)

setItemMetadata

Split a stack and modify only some items (amount must be less than the current stack)
Merge with an existing stack that has matching metadata (amount must be more or equal than the current stack)
Modify the entire stack’s metadata (amount must be more or equal than the current stack) this only applies if metadata is the same as current stack

int

required

The player id

int

required

item id

table

reserved keys are:

description the description of the item to replace
image the image of the item to replace must exist in item folder.
label the label of the item to replace
weight the weight of the item to replace
tolltip add extra text to the tooltip
context add context buttons to the item
useExpired if true allows to use expired items overriding the useExpired setting in the item db

int

required

amount of item to remove from current stack if less, if more it will remove from here and add to another stack if metadata matches, if not then it updates the entire stack with new meta

function

callback function syncronous or asyncronous

boolean

returns true if the metadata was successfully set

-- FOR CONTEXT BUTTONS USE THIS FORMAT
local metadata = {
  context = { -- key word for context buttons
    { -- array supporting multiple buttons
          text = "BUTTON", -- label shown in menu
          close = true, -- close inv on use
          event = {
              client = "myscript:contextevent", -- client event to trigger
              server = "myscript:contextevent" -- server event to trigger
          },
          arguments = { -- arguments to pass to the event if needed
              "any",
          }
      }
  }
}

-- listen in your scripts client side
AddEventHandler("myscript:contextevent", function(args,itemId)
    
end) 

-- NOTE: for server side events you must whitelist the event using the exports bellow
exports.vorp_inventory:addAllowedContextMenuEvent("myscript:contextevent",GetCurrentResourceName())
-- or as a table
exports.vorp_inventory:addAllowedContextMenuEvent({
  "myscript:contextevent",
  "myscript:contextevent2"
},GetCurrentResourceName())
-- if you dont whitelist the event it will not be triggered this is to ensure only trusted events are triggered

-- to remove a whitelisted event
exports.vorp_inventory:removeAllowedContextMenuEvent("myscript:contextevent",GetCurrentResourceName())
-- or as a table
exports.vorp_inventory:removeAllowedContextMenuEvents({
  "myscript:contextevent",
  "myscript:contextevent2"
},GetCurrentResourceName())

-- server side of your script
AddEventHandler("myscript:contextevent", function(source,args,itemId)

end)

  -- SET ITEM METADATA
  exports.vorp_inventory:setItemMetadata(source, itemId, metadata, amount, callback)

registerUsableItem

Items cant be registered twice they must be unique

string

required

item name

function

required

callback

{source:int, id:number, label:string, name:string, metadata:table, group:number, type:string, count:number, limit:number,canUse:boolean, mainid: integer, percentage:integer}

string

resource name for debug purposes so users can see in what resource this item is registered at

exports.vorp_inventory:registerUsableItem(item, callback,resourceName)

unRegisterUsableItem

un register usable item when you stop a script for example

Items cant be registered twice they must be unique

string

required

item name

exports.vorp_inventory:unRegisterUsableItem(item)

Getters

getCustomInventoryItemCount

get custom inventory item count

string

required

inventory id

string

required

item name

function

callback function syncronous or asyncronous

table

if metadata is provided then it will return the amount of items with the same metadata

number

returns the amount of items in the inventory

exports.vorp_inventory:getCustomInventoryItemCount(invid,itemName,callback,metadata)

getCustomInventoryItems

get custom inventory items

string

required

inventory id

function

callback function syncronous or asyncronous

table

returns a table containing all the items in the inventory

exports.vorp_inventory:getCustomInventoryItems(invid, callback)

Setters

removeItemFromCustomInventory

remove item from custom inventory

string

required

inventory id

string

required

item name

number

required

amount of item

number

required

item crafted id

function

callback function syncronous or asyncronous

boolean

returns true if the item was successfully removed

exports.vorp_inventory:removeItemFromCustomInventory(invid,itemName,callback)

updateCustomInventoryItem

update item in custom inventory

string

required

inventory id

number

required

item id

table

required

metadata to update

number

amount of item

function

callback function syncronous or asyncronous

boolean

returns true if the item was successfully updated

exports.vorp_inventory:updateCustomInventoryItem(invId, item_id, metadata, amount, callback)

addItemsToCustomInventory

add items to custom inventory

string

required

inventory id

table

required

items to add

number

charidentifier of the owner of the storage if custom inv is not shared , if its shared can be any characteridentifer

function

callback function syncronous or asyncronous

boolean

returns true if the items were successfully added

exports.vorp_inventory:addItemsToCustomInventory(invid, items, charid,callback)

setCustomInventoryItemLimit

if in registerCustomInventory you set whitelistItems true then use this export to set which items are whitelisted and their amount

string

required

inventory id

string

required

item name

number

required

item limit

function

callback function syncronous or asyncronous

boolean

returns true if the limit was successfully set

exports.vorp_inventory:setCustomInventoryItemLimit(invId, item, limit, callback)

Getters

getCustomInventoryWeapons

get custom inventory weapons

string

required

inventory id

function

callback function syncronous or asyncronous

table

returns a table containing all the weapons in the inventory

exports.vorp_inventory:getCustomInventoryWeapons(invid, callback)

getCustomInventoryWeaponCount

get custom inventory weapon count

string

required

inventory id

string

required

weapon name

function

callback function syncronous or asyncronous

number

returns the amount of weapons in the inventory

exports.vorp_inventory:getCustomInventoryWeaponCount(invid,weaponName,callback)

Setter

removeCustomInventoryWeaponById

remove weapon from custom inventory by weapon id

string

required

inventory id

number

required

weapon id

function

callback function syncronous or asyncronous

boolean

returns true if the weapon was successfully removed

exports.vorp_inventory:removeCustomInventoryWeaponById(invId, weapon_id, callback)

removeWeaponFromCustomInventory

remove weapon from custom inventory

string

required

inventory id

string

required

weapon name

function

callback function syncronous or asyncronous

boolean

returns true if the weapon was successfully removed

exports.vorp_inventory:removeWeaponFromCustomInventory(invid,weaponName,callback)

addWeaponsToCustomInventory

add weapons to custom inventory

string

required

inventory id

table

required

{name: string, serial_number: string?, custom_label: string?, custom_desc: string?, components: table?}

number

charidentifier of the owner of the storage if custom inv is not shared , if its shared can be any characteridentifer

function

callback function syncronous or asyncronous

boolean

returns true if the weapons were successfully added

exports.vorp_inventory:addWeaponsToCustomInventory(invid, weapons, charid,callback)

setCustomInventoryWeaponLimit

set custom inventory whitelisted weapons, if in registerCustomInventory you set whitelistWeapons true then use this export to set which weapons are whitelisted and their amount

string

required

inventory id

string

required

weapon name

number

required

weapon limit

function

callback function syncronous or asyncronous

boolean

returns true if the limit was successfully set

exports.vorp_inventory:setCustomInventoryWeaponLimit(invId, weapon, limit, callback)

Getters

isCustomInventoryRegistered

check if inventory is registered

string

required

inventory id

function

callback function syncronous or asyncronous

boolean

returns true if the inventory is registered

exports.vorp_inventory:isCustomInventoryRegistered(id, callback)

AddCharIdPermissionTakeFromCustom

add permissions using charids

string

required

inventory id

number

required

charid

boolean

state

exports.vorp_inventory:AddCharIdPermissionTakeFromCustom(id,charid,state)

AddCharIdPermissionMoveToCustom

add permissions using charids

string

required

inventory id

number

required

charid

boolean

state

exports.vorp_inventory:AddCharIdPermissionMoveToCustom(id,charid,state)

getCustomInventorySlots

get cached inventory slots

string

required

inventory id

function

callback function syncronous or asyncronous

exports.vorp_inventory:getCustomInventorySlots(invId,callback)

Setters

deleteCustomInventory

delete custom inventory from data base and cache

string

required

inventory id

exports.vorp_inventory:deleteCustomInventory(invId)

registerInventory

table

required

{ id:string, name:string, limit:number, acceptWeapons:boolean, shared:boolean, ignoreItemStackLimit:boolean, whitelistItems:boolean, UsePermissions:boolean, UseBlackList:boolean, whitelistWeapons:boolean,webhook:string }

exports.vorp_inventory:registerInventory(data)

AddPermissionMoveToCustom

add permissions to move item to inventory by job and grade

string

required

inventory id

string

required

job name

number

required

job grade

exports.vorp_inventory:AddPermissionMoveToCustom(invId, jobName, jobgrade)

AddPermissionTakeFromCustom

add permissions to take item from inventory by job and grade

string

required

inventory id

string

required

job name

number

required

job grade

exports.vorp_inventory:AddPermissionTakeFromCustom(invId, jobName, jobgrade)

BlackListCustomAny

black list items or weapons

string

required

inventory id

string

required

item name | weapon name

exports.vorp_inventory:BlackListCustomAny(invId, item)

removeInventory

remove inventory from session

string

required

inventory id

exports.vorp_inventory:removeInventory(invId)

updateCustomInventorySlots

update inventory slots

string

required

inventory id

number

required

inventory slots

exports.vorp_inventory:updateCustomInventorySlots(invId, slots)

openInventory

open inventory main or secondary

int

required

The player id

string

inventory id

exports.vorp_inventory:openInventory(source, invId)

closeInventory

close inventory main or secondary

int

required

The player id

string

inventory id

exports.vorp_inventory:closeInventory(source, invId)

openPlayerInventory

open player inventory

table

required

{ source:int, target:int, title:string, blacklist:table, itemsLimit:table, timeout:number }

local data = {
    source = source, 
    target = target, 
    title = "Search inventory",
    blacklist = { -- OPTIONAL
        water = true, -- item name or weapon name
    },
    itemsLimit = { -- OPTIONAL
        weapons = { itemType = "item_weapon", limit = 1 }, -- how many weapons user is allowed to take
        items =   { itemType = "item_standard", limit = 2 }, -- how many items user is allowed to take
    },
    timeout = 60, -- OPTIONAL in seconds , if enabled when user reaches limits then a timeout is applied so player cant steal for that amount of time if removed then   once limit reached only after restart they can steal again
}

exports.vorp_inventory:openPlayerInventory(data)

Events

Server Side only

Listen to when an item is used

AddEventHandler("vorp_inventory:Server:OnItemUse",function(data)
    local source = data.source
    local itemName = data.item.name
    local itemMetadata = data.item.metadata
end)

Listen to when an item is created in player inventory

OnItemCreated

AddEventHandler("vorp_inventory:Server:OnItemCreated",function(data,source)
    -- data.count, data.name, data.metadata
end)

Listen to when an item is removed from player inventory

OnItemRemoved

AddEventHandler("vorp_inventory:Server:OnItemRemoved",function(data,source)
    -- data.count , data.name , data.metadata
end)

Listen to when an item is taken from custom inventory

OnItemTakenFromCustomInventory

AddEventHandler("vorp_inventory:Server:OnItemTakenFromCustomInventory", function(item, invId, source)
    -- item.amount , item.name, item.id, item.metadata
end)

Listen to when an item is moved to custom inventory

OnItemMovedToCustomInventory

AddEventHandler("vorp_inventory:Server:OnItemMovedToCustomInventory", function(item, invId, source)
    -- item.amount , item.name, item.id, item.metadata
end)

Listen for inventory state change (opens or closes) including custom inventories

OnInvStateChange

AddEventHandler("vorp_inventory:Client:OnInvStateChange",function(boolean)
    print(boolean)
end)

Block player inventory from server or client side

OnInvBlock server

TriggerClientEvent("vorp_inventory:blockInventory", player_id, true or false)

OnInvBlock client

  TriggerEvent("vorp_inventory:blockInventory", true or false)

Client Side only

Listen to when a weapon is equipped

onWeaponEquipped

AddEventHandler("vorp_inventory:onWeaponEquipped", function(components, weaponId, name, isDual, defaultAttachments)
    -- components: table of the equipped components, weaponId: weapon id, name: weapon name, isDual: boolean, defaultAttachments: table
end)

Listen to when a component is added to a weapon

componentAdded

AddEventHandler("vorp_inventory:componentAdded", function(weaponId, component, category)
    -- weaponId: weapon id, component: component name, category: slot category
end)

Listen to when a component is removed from a weapon

componentRemoved

AddEventHandler("vorp_inventory:componentRemoved", function(weaponId, component, category)
    -- weaponId: weapon id, component: component name, category: slot category
end)

Statebags

contains data from the current weapon used in the inventory or last weapon used.

client side

GetEquippedWeaponData

local key = string.format("GetEquippedWeaponData_%d",weaponHash)
local data = LocalPlayer.state[key]
local serial = data.serialNumber
local id = data.weaponId

server side

GetEquippedWeaponData

local key = string.format("GetEquippedWeaponData_%d",weaponHash)
local data = Player(source).state[key]
local serial = data.serialNumber
local id = data.weaponId

check if inventory is active (open or closed) including custom inventories

client side

IsInvActive

LocalPlayer.state.IsInvActive

server side

IsInvActive

Player(source).state.IsInvActive

Global Statebags

returns timestamp from server to be used in client

local timestamp = GlobalState.TimeNow
-- Get hours, minutes and seconds from timestamp
local seconds = GlobalState.TimeNow % 60
local minutes = math.floor(GlobalState.TimeNow / 60) % 60 
local hours = math.floor(GlobalState.TimeNow / 3600) % 24

​Exports

​Getters

​Getters

​Setters

​Getters

​Setters

​Getters

​Setters

​Getters

​Setter

​Getters

​Setters

​Events

​Statebags

​Global Statebags

Exports

Getters

Getters

Setters

Getters

Setters

Getters

Setters

Getters

Setter

Getters

Setters

Events

Statebags

Global Statebags