Skip to content

items

Items let players use tapes and props directly from inventory.

Auto registration (default)#

In config.lua:

lua
Config.Bridge = {
    AutoRegisterItems = true,
    ConsumeOnUse = false,
}

When enabled, missing items are registered at runtime and can be written to ox_inventory/data/items.lua automatically.

After first start, restart ox_inventory once if prompted in the server console:

bash
ensure ox_inventory

Manual registration#

Use the included manual_items_ox.lua file in the script root.

Open manual_items_ox.lua#

Copy all item blocks.

Paste the item blocks#

Paste them inside return { ... } in ox_inventory/data/items.lua.

Update config.lua#

lua
Config.Bridge.AutoRegisterItems = false

Restart the resources#

Restart ox_inventory and s4-warningtapes.

Export format#

Every item must use the correct resource name:

lua
client = {
    export = 's4-warningtapes.useTapeItem',  -- tapes
    -- or
    export = 's4-warningtapes.usePropItem',  -- props
}

Tape items#

Item nameTape type
tape_policePolice
tape_police_innerInner cordon
tape_fireFire
tape_fire_serviceFire service
tape_cautionCaution
tape_crimeCrime scene
tape_cross_red_whiteRed & white
tape_dangerDanger
tape_danger_yellowYellow danger
tape_do_not_enterDo not enter
tape_warningWarning
tape_standardStandard

Prop items#

Item nameProp
barrier_supply_boxSupply box (menu)
prop_traffic_coneTraffic cone
prop_air_cone_lightAir cone light
prop_barrier_tT-barrier
prop_evidence_markerEvidence marker

Item images#

Place PNG files in s4-warningtapes/items/.

Image path in ox_inventory:

lua
image = 'nui://s4-warningtapes/items/police.png',

Tape images use the model name (e.g. police.png), not the item name.

Give item (admin)#

bash
/giveitem [id] tape_police 1
/giveitem [id] barrier_supply_box 1