ox_inventory

Slot-based inventory with weight, metadata, stashes, shops and hooks. Supports ox_core, esx and qbx_core.

Activation Contract

Load this skill when the user asks to give, take, count or check items, register a stash or shop, define a new item, react to inventory actions, or migrate from qb-inventory or esx inventory.

Hard Rules

• Call everything through exports.ox_inventory:<fn>(...). There is no global table.
• Grant, remove and count items on the SERVER only. Client exports are for display and UI decisions.
• AddItem can fail. Always check the return value: the player may be over weight or out of slots.
• Check CanCarryItem BEFORE taking payment or removing the traded item, never after.
• Never invent item names. An item must exist in data/items.lua or it silently fails.
• inv is a player source, an identifier, or a stash id. Passing the wrong one returns nil, not an error.
• Metadata makes items non-stackable when it differs. Do not put volatile data in metadata.

Decision Gates