Pre use item - Jaksam's Scripts

General

Inventory

Jobs Creator

Drugs Creator

Doors Creator

Missions Creator

Blips Creator

Farming Creator

Shops Creator

Robberies Creator

Vehicles Keys

Dealerships Creator

Races Creator

Trackers Creator

Easy Allowlist

Billing UI

Luxury Clothes Theft

Triggered BEFORE an item is used (before consume, animations, and delays). This hook can cancel item usage. Register with registerHook using the event name onPreUseItem. Execution order: after STATIC_ITEM.canUse and oxServerExport 'usingItem', before consume.

Payload

Field	Data Type	Description
`playerId`	number	The player using the item
`inventoryId`	string	e.g. `"license:abcd1234"`
`slotId`	number	Slot of the item being used
`itemName`	string	e.g. `"bread"`
`metadata`	table \| nil	Item metadata

This hook can prevent item usage by returning false. Useful for global item usage restrictions (e.g., handcuffed players, vehicle restrictions, zone restrictions).

Examples

Block item usage when handcuffed

exports['jaksam_inventory']:registerHook("onPreUseItem", function(payload)
    if IsPlayerHandcuffed(payload.playerId) then
        return false, "You cannot use items while handcuffed"
    end
end)

Block food usage in vehicles

exports['jaksam_inventory']:registerHook("onPreUseItem", function(payload)
    local ped = GetPlayerPed(payload.playerId)
    if IsPedInAnyVehicle(ped, false) then
        return false, "You cannot eat while driving", "warning"
    end
end, {
    itemTypeFilter = {food = true}
})

See Hooks overview for the registerHook API, available filters, and return-value behavior.

Related topics

Hooks Post use item How to use images for items Panic button pressed

⌘I