Item Carry - Inventoryaddons

Automatically attach props and play animations when players receive specific items using ox_inventory. Includes vehicle blocking and walk-only options for realistic item carrying.

Configuration

The configuration file is located at itemcarry/config.lua. Each entry in the config table maps an inventory item name to its carry behavior.

Config Properties

Property	Type	Required	Description
`walkOnly`	`boolean`	No	Whether the player can only walk while carrying this item
`blockVehicle`	`boolean`	No	Whether the player is blocked from entering vehicles while carrying this item
`anim`	`table`	Yes	Animation data for the carrying animation
`prop`	`table`	Yes	Prop attachment data for the carried item

Animation Properties

Property	Type	Required	Description
`dict`	`string`	Yes	Animation dictionary name
`clip`	`string`	Yes	Animation clip name
`flag`	`number`	No	Animation flag (controls looping, movement, etc.)

Prop Properties

Property	Type	Required	Description
`bone`	`number`	Yes	Bone index to attach the prop to
`model`	`number \| string`	Yes	Model hash or string for the prop
`placement`	`table`	Yes	Position and rotation of the prop relative to the bone
`placement.pos`	`vec3`	Yes	Position offset relative to the bone
`placement.rot`	`vec3`	Yes	Rotation offset relative to the bone

Examples

Box Carry (Walk Only, No Vehicles)

['box'] = {
    walkOnly = true,
    blockVehicle = true,
    anim = {
        dict = 'anim@heists@box_carry@',
        clip = 'idle',
        flag = 51,
    },
    prop = {
        bone = 60309,
        model = joaat('hei_prop_heist_box'),
        placement = {
            pos = vec3(0.025000, 0.080000, 0.255000),
            rot = vec3(-145.000000, 290.000000, 0.000000),
        },
    },
},

Briefcase Carry (Free Movement)

['briefcase'] = {
    anim = {
        dict = 'anim@heists@briefcase@',
        clip = 'idle',
        flag = 52,
    },
    prop = {
        bone = 60310,
        model = 'prop_briefcase_02',
        placement = {
            pos = vec3(0.035000, 0.070000, 0.240000),
            rot = vec3(-135.000000, 280.000000, 0.000000),
        },
    },
},

Complete Config Example

local config = {
    ['box'] = {
        walkOnly = true,
        blockVehicle = true,
        anim = {
            dict = 'anim@heists@box_carry@',
            clip = 'idle',
            flag = 51,
        },
        prop = {
            bone = 60309,
            model = joaat('hei_prop_heist_box'),
            placement = {
                pos = vec3(0.025000, 0.080000, 0.255000),
                rot = vec3(-145.000000, 290.000000, 0.000000),
            },
        },
    },
    ['briefcase'] = {
        anim = {
            dict = 'anim@heists@briefcase@',
            clip = 'idle',
            flag = 52,
        },
        prop = {
            bone = 60310,
            model = 'prop_briefcase_02',
            placement = {
                pos = vec3(0.035000, 0.070000, 0.240000),
                rot = vec3(-135.000000, 280.000000, 0.000000),
            },
        },
    },
}

The config key (e.g., 'box', 'briefcase') must match the item name in your ox_inventory item definitions. When a player receives the item, the carry behavior activates automatically.

Ensure the animation dictionaries and prop models you reference are valid and available in the game. Invalid references will result in the carry behavior not displaying correctly.

Item Carry
Last updated on