๐Ox Inventory Install
Step 1: Locate the OX Inventory Folder
Navigate to your FiveM server directory.
Open the
resourcesfolder.Find and open the ox_inventory resource folder.
Step 2: Open the data/items.lua File
data/items.lua FileInside the ox_inventory folder, go to:
ox_inventory/data/items.luaOpen
items.luausing Notepad++, VS Code, or another code editor.
Step 3: Add Your New Item
Add a new entry for your item inside the
items.luafile.Use the following format:
Items Config (consumable)
['djs_basket_chilicheesenachos'] = { --checked
label = 'Chilli Cheese Nachos',
stack = true,
close = false,
weight = 10,
client = {
status = { hunger = 2000000 },
anim = { dict = 'anim@djs@food@plated', clip = 'djs_food_plate_bite_loop' },
prop = { model = 'djs_basket_chilicheesenachos',
bone = 26612,
pos = vec3(0.033000, -0.045000, 0.000000),
rot = vec3(66.450294, 0.000000, 24.299963) },
propTwo = { model = 'djs_prop_nachochip',
bone = 58868,
pos = vec3(0.085000, -0.004000, 0.000000),
rot = vec3(0.000000, 0.000000, 242.657578) },
usetime = 17500,
cancel = true,
notification = 'You have satisfied your hunger'
},
},
['djs_basket_nachos'] = {
label = 'Basket of Nachos',
stack = true,
close = false,
weight = 10,
client = {
status = { hunger = 2000000 },
anim = { dict = 'anim@djs@food@plated', clip = 'djs_food_plate_bite_loop' },
prop = { model = 'djs_basket_nachos',
bone = 26612,
pos = vec3(0.033000, -0.045000, 0.000000),
rot = vec3(66.450294, 0.000000, 24.299963) },
propTwo = { model = 'djs_prop_nachochip',
bone = 58868,
pos = vec3(0.085000, -0.004000, 0.000000),
rot = vec3(0.000000, 0.000000, 242.657578) },
usetime = 17500,
cancel = true,
notification = 'You have satisfied your hunger'
},
},
['djs_large_popcorn'] = {
label = 'Large popcorn',
stack = true,
close = false,
weight = 10,
client = {
status = { hunger = 2000000 },
anim = { dict = 'anim@djs@food@plated', clip = 'djs_food_plate_bite_loop' },
prop = { model = 'djs_large_popcorn',
bone = 18905,
pos = vec3(0.148000, 0.077000, 0.000000),
rot = vec3(0.000000, 0.000000, 0.000000) },
propTwo = { model = 'djs_prop_popcorn',
bone = 58868,
pos = vec3(0.070000, 0.004000, 0.000000),
rot = vec3(0.000000, 0.000000, 0.000000) },
usetime = 17500,
cancel = true,
notification = 'You have satisfied your hunger'
},
},
['djs_medium_popcorn'] = {
label = 'Medium Popcorn',
stack = true,
close = false,
weight = 10,
client = {
status = { hunger = 2000000 },
anim = { dict = 'anim@djs@food@plated', clip = 'djs_food_plate_bite_loop' },
prop = { model = 'djs_medium_popcorn',
bone = 18905,
pos = vec3(0.148000, 0.077000, 0.000000),
rot = vec3(0.000000, 0.000000, 0.000000) },
propTwo = { model = 'djs_prop_popcorn',
bone = 58868,
pos = vec3(0.070000, 0.004000, 0.000000),
rot = vec3(0.000000, 0.000000, 0.000000) },
usetime = 17500,
cancel = true,
notification = 'You have satisfied your hunger'
},
},
['djs_small_popcorn'] = {
label = 'Small popcorn',
stack = true,
close = false,
weight = 10,
client = {
status = { hunger = 2000000 },
anim = { dict = 'anim@djs@food@plated', clip = 'djs_food_plate_bite_loop' },
prop = { model = 'djs_small_popcorn',
bone = 18905,
pos = vec3(0.148000, 0.077000, 0.000000),
rot = vec3(0.000000, 0.000000, 0.000000) },
propTwo = { model = 'djs_prop_popcorn',
bone = 58868,
pos = vec3(0.070000, 0.004000, 0.000000),
rot = vec3(0.000000, 0.000000, 0.000000) },
usetime = 17500,
cancel = true,
notification = 'You have satisfied your hunger'
},
},
['djs_prop_pretzel'] = {
label = 'Pretzel',
weight = 500,
client = {
status = { hunger = 400000 },
anim = { dict = 'mp_player_inteat@burger', clip = 'mp_player_int_eat_burger' },
prop = { model = `djs_prop_pretzel`, bone = 18905, pos = vec3(0.145000, 0.060000, 0.000000), rot = vec3(42.000000, 0.000000, 141.000000) },
usetime = 2500,
cancel = true,
},
},
['djs_movie_ticket'] = {
label = 'Movie Ticket',
weight = 1,
stack = true,
close = true,
},Items Config (non-consumable)
['djs_basket_chilicheesenachos'] = {
label = 'Chilli Cheese Nachos',
stack = true,
close = false,
weight = 10,
},
['djs_basket_nachos'] = {
label = 'Basket of Nachos',
stack = true,
close = false,
weight = 10,
},
['djs_large_popcorn'] = {
label = 'Large popcorn',
stack = true,
close = false,
weight = 10,
},
['djs_medium_popcorn'] = {
label = 'Medium Popcorn',
stack = true,
close = false,
weight = 10,
},
['djs_small_popcorn'] = {
label = 'Small popcorn',
stack = true,
close = false,
weight = 10,
},
['djs_prop_pretzel'] = {
label = 'Pretzel',
weight = 500,
},
['djs_movie_ticket'] = {
label = 'Movie Ticket',
weight = 1,
stack = true,
close = true,
},Adjust label, weight, stack, animations, and props as needed.
Step 4: Add Item Image
OX Inventory allows you to display custom images for items in the inventory.
Where to Place Item Images
Navigate to:
Place your item image inside the
images/folder.
Step 5: Save the File & Restart Server
Save the
items.luafile.Restart your FiveM server using one of the following methods:
Console Command:
Full Server Restart: Stop and start the server manually.
Step 6: Test the Item
Spawn the item using an admin command:
(Replace
yourIDwith your actual player ID andburgerwith your item name.)Open OX Inventory (
F2default key).Verify the item appears and functions correctly.
Step 6: Debugging & Adjustments
If the item does not show, check the server console for errors.
Verify spelling and commas in
items.lua.Ensure
ox_inventoryis running properly.Look at the FiveM forums or Discord for troubleshooting help.
Last updated