Ox Inventory Install
Step 1: Locate the OX Inventory Folder
Navigate to your FiveM server directory.
Open the
resources
folder.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.lua
Open
items.lua
using Notepad++, VS Code, or another code editor.
Step 3: Add Your New Item
Add a new entry for your item inside the
items.lua
file.Use the following format:
Items Config
['djs_drink_aldente'] = {
label = 'Aldente Drink',
weight = 500,
client = {
status = { thirst = 400000 },
anim = { dict = 'anim@djs@drink@soda', clip = 'djs_drink_soda_sip_long' },
prop = { model = `djs_drink_aldente`, bone = 57005, pos = vec3(0.110000, -0.080000, -0.040000), rot = vec3(-77.893997, 0.000000, 0.000000) },
usetime = 2500,
cancel = true,
},
},
['djs_drink_normal'] = {
label = 'Normal Drink',
weight = 500,
client = {
status = { thirst = 400000 },
anim = { dict = 'anim@djs@drink@soda', clip = 'djs_drink_soda_sip_long' },
prop = { model = `djs_drink_normal`, bone = 57005, pos = vec3(0.110000, -0.080000, -0.040000), rot = vec3(-77.893997, 0.000000, 0.000000) },
usetime = 2500,
cancel = true,
},
},
['djs_drink_pizzathis'] = {
label = 'Pizza This Drink',
weight = 500,
client = {
status = { thirst = 400000 },
anim = { dict = 'anim@djs@drink@soda', clip = 'djs_drink_soda_sip_long' },
prop = { model = `djs_drink_pizzathis`, bone = 57005, pos = vec3(0.110000, -0.080000, -0.040000), rot = vec3(-77.893997, 0.000000, 0.000000) },
usetime = 2500,
cancel = true,
},
},
['djs_melt_buffalochicken'] = {
label = 'Buffalo Chicken Melt',
weight = 200,
stack = true,
close = true,
client = {
status = { hunger = 100000 },
anim = { dict = 'mp_player_inteat@burger', clip = 'mp_player_int_eat_burger_fp' },
prop = {
model = 'djs_melt_buffalochicken',
bone = 18905,
pos = vec3(0.124000, 0.076000, 0.000000),
rot = vec3(-0.680000, 0.000000, 184.618378),
},
usetime = 17500,
cancel = true,
}
},
['djs_melt_cheeseburger'] = {
label = 'Cheeseburger Melt',
weight = 200,
stack = true,
close = true,
client = {
status = { hunger = 100000 },
anim = { dict = 'mp_player_inteat@burger', clip = 'mp_player_int_eat_burger_fp' },
prop = {
model = 'djs_melt_cheeseburger',
bone = 18905,
pos = vec3(0.124000, 0.076000, 0.000000),
rot = vec3(-0.680000, 0.000000, 184.618378),
},
usetime = 17500,
cancel = true,
}
},
['djs_melt_chickenbacon'] = {
label = 'Chicken Bacon Melt',
weight = 200,
stack = true,
close = true,
client = {
status = { hunger = 100000 },
anim = { dict = 'mp_player_inteat@burger', clip = 'mp_player_int_eat_burger_fp' },
prop = {
model = 'djs_melt_chickenbacon',
bone = 18905,
pos = vec3(0.124000, 0.076000, 0.000000),
rot = vec3(-0.680000, 0.000000, 184.618378),
},
usetime = 17500,
cancel = true,
}
},
['djs_melt_meatlovers'] = {
label = 'Meat Lovers Melt',
weight = 200,
stack = true,
close = true,
client = {
status = { hunger = 100000 },
anim = { dict = 'mp_player_inteat@burger', clip = 'mp_player_int_eat_burger_fp' },
prop = {
model = 'djs_melt_meatlovers',
bone = 18905,
pos = vec3(0.124000, 0.076000, 0.000000),
rot = vec3(-0.680000, 0.000000, 184.618378),
},
usetime = 17500,
cancel = true,
}
},
['djs_melt_pepperoni'] = {
label = 'Pepperoni Melt',
weight = 200,
stack = true,
close = true,
client = {
status = { hunger = 100000 },
anim = { dict = 'mp_player_inteat@burger', clip = 'mp_player_int_eat_burger_fp' },
prop = {
model = 'djs_melt_pepperoni',
bone = 18905,
pos = vec3(0.124000, 0.076000, 0.000000),
rot = vec3(-0.680000, 0.000000, 184.618378),
},
usetime = 17500,
cancel = true,
}
},
['djs_plate_breadsticks'] = {
label = 'Bread Sticks',
weight = 1,
stack = true,
close = true,
client = {
status = { hunger = 2000000 },
anim = { dict = 'anim@djs@food@plated', clip = 'djs_food_plate_bite_loop' },
prop = {model = 'djs_plate_breadsticks',
bone = 18905,
pos = vec3(0.200000, -0.030000, 0.030000),
rot = vec3(0.000000, 0.000000, 205.087402)
},
propTwo = { model = 'djs_prop_cheesybreadsticks',
bone = 57005,
pos = vec3(0.130000, 0.020000, -0.120000),
rot = vec3(-88.739998, 0.000000, 0.000000)
},
usetime = 17500,
cancel = true,
notification = 'You have satistfied your hunger'
},
},
['djs_plate_cheesybreadsticks'] = {
label = 'Cheesy Bread Sticks',
weight = 1,
stack = true,
close = true,
client = {
status = { hunger = 2000000 },
anim = { dict = 'anim@djs@food@plated', clip = 'djs_food_plate_bite_loop' },
prop = {model = 'djs_plate_cheesybreadsticks',
bone = 18905,
pos = vec3(0.200000, -0.030000, 0.030000),
rot = vec3(0.000000, 0.000000, 205.087402)
},
propTwo = { model = 'djs_prop_cheesybreadsticks',
bone = 57005,
pos = vec3(0.130000, 0.020000, -0.120000),
rot = vec3(-88.739998, 0.000000, 0.000000)
},
usetime = 17500,
cancel = true,
notification = 'You have satistfied your hunger'
},
},
['djs_plate_chocolatedonutbites'] = {
label = 'Chocolate Donut Bites',
weight = 1,
stack = true,
close = true,
client = {
status = { hunger = 2000000 },
anim = { dict = 'anim@djs@food@plated', clip = 'djs_food_plate_bite_loop' },
prop = {model = 'djs_plate_chocolatedonutbites',
bone = 18905,
pos = vec3(0.120000, 0.030000, 0.020000),
rot = vec3(0.000000, 0.000000, 0.000000)
},
propTwo = { model = 'djs_prop_chocolatedonutbites',
bone = 57005,
pos = vec3(0.130000, 0.030000, -0.050000),
rot = vec3(96.628006, 0.000000, 0.000000)
},
usetime = 17500,
cancel = true,
notification = 'You have satistfied your hunger'
},
},
['djs_plate_cookie'] = {
label = 'Chocolate Chip Pizookie',
weight = 1,
stack = true,
close = true,
client = {
status = { hunger = 2000000 },
anim = { dict = 'anim@djs@food@plated', clip = 'djs_food_plate_bite_loop' },
prop = {model = 'djs_plate_cookie',
bone = 18905,
pos = vec3(0.120000, 0.020000, 0.000000),
rot = vec3(0.000000, 0.000000, 0.000000)
},
propTwo = { model = 'djs_spoon',
bone = 57005,
pos = vec3(0.090000, 0.026000, 0.000000),
rot = vec3(99.945862, 0.000000, 175.937973)
},
usetime = 17500,
cancel = true,
notification = 'You have satistfied your hunger'
},
},
['djs_plate_cinammonsticks'] = {
label = 'Cinammon Sticks',
weight = 1,
stack = true,
close = true,
client = {
status = { hunger = 2000000 },
anim = { dict = 'anim@djs@food@plated', clip = 'djs_food_plate_bite_loop' },
prop = {model = 'djs_plate_cinammonsticks',
bone = 18905,
pos = vec3(0.200000, -0.030000, 0.030000),
rot = vec3(0.000000, 0.000000, 205.087402)
},
propTwo = { model = 'djs_prop_cinammonsticks',
bone = 57005,
pos = vec3(0.130000, 0.020000, -0.120000),
rot = vec3(-88.739998, 0.000000, 0.000000)
},
usetime = 17500,
cancel = true,
notification = 'You have satistfied your hunger'
},
},
['djs_slice_bbqchicken'] = {
label = 'BBQ Chicken Pizza',
weight = 200,
stack = true,
close = true,
client = {
status = { hunger = 100000 },
anim = { dict = 'mp_player_inteat@burger', clip = 'mp_player_int_eat_burger_fp' },
prop = {
model = 'djs_slice_bbqchicken',
bone = 18905,
pos = vec3(0.151000, 0.101000, 0.000000),
rot = vec3(-199.748215, 0.000000, -20.400007),
},
usetime = 17500,
}
},
['djs_slice_buffalochicken'] = {
label = 'Buffalo Chicken Pizza',
weight = 200,
stack = true,
close = true,
client = {
status = { hunger = 100000 },
anim = { dict = 'mp_player_inteat@burger', clip = 'mp_player_int_eat_burger_fp' },
prop = {
model = 'djs_slice_buffalochicken',
bone = 18905,
pos = vec3(0.151000, 0.101000, 0.000000),
rot = vec3(-199.748215, 0.000000, -20.400007),
},
usetime = 17500,
}
},
['djs_slice_cheese'] = {
label = 'Cheese Pizza',
weight = 200,
stack = true,
close = true,
client = {
status = { hunger = 100000 },
anim = { dict = 'mp_player_inteat@burger', clip = 'mp_player_int_eat_burger_fp' },
prop = {
model = 'djs_slice_cheese',
bone = 18905,
pos = vec3(0.151000, 0.101000, 0.000000),
rot = vec3(-199.748215, 0.000000, -20.400007),
},
usetime = 17500,
}
},
['djs_slice_hawaiian'] = {
label = 'Hawaiian Pizza',
weight = 200,
stack = true,
close = true,
client = {
status = { hunger = 100000 },
anim = { dict = 'mp_player_inteat@burger', clip = 'mp_player_int_eat_burger_fp' },
prop = {
model = 'djs_slice_hawaiian',
bone = 18905,
pos = vec3(0.151000, 0.101000, 0.000000),
rot = vec3(-199.748215, 0.000000, -20.400007),
},
usetime = 17500,
}
},
['djs_slice_meatlovers'] = {
label = 'Meat Lovers Pizza',
weight = 200,
stack = true,
close = true,
client = {
status = { hunger = 100000 },
anim = { dict = 'mp_player_inteat@burger', clip = 'mp_player_int_eat_burger_fp' },
prop = {
model = 'djs_slice_meatlovers',
bone = 18905,
pos = vec3(0.151000, 0.101000, 0.000000),
rot = vec3(-199.748215, 0.000000, -20.400007),
},
usetime = 17500,
}
},
['djs_slice_pepperoni'] = {
label = 'Meat Lovers Pizza',
weight = 200,
stack = true,
close = true,
client = {
status = { hunger = 100000 },
anim = { dict = 'mp_player_inteat@burger', clip = 'mp_player_int_eat_burger_fp' },
prop = {
model = 'djs_slice_pepperoni',
bone = 18905,
pos = vec3(0.151000, 0.101000, 0.000000),
rot = vec3(-199.748215, 0.000000, -20.400007),
},
usetime = 17500,
}
},
['djs_slice_supreme'] = {
label = 'Supreme Pizza',
weight = 200,
stack = true,
close = true,
client = {
status = { hunger = 100000 },
anim = { dict = 'mp_player_inteat@burger', clip = 'mp_player_int_eat_burger_fp' },
prop = {
model = 'djs_slice_supreme',
bone = 18905,
pos = vec3(0.151000, 0.101000, 0.000000),
rot = vec3(-199.748215, 0.000000, -20.400007),
},
usetime = 17500,
}
},
['djs_slice_veggie'] = {
label = 'Supreme Pizza',
weight = 200,
stack = true,
close = true,
client = {
status = { hunger = 100000 },
anim = { dict = 'mp_player_inteat@burger', clip = 'mp_player_int_eat_burger_fp' },
prop = {
model = 'djs_slice_veggie',
bone = 18905,
pos = vec3(0.151000, 0.101000, 0.000000),
rot = vec3(-199.748215, 0.000000, -20.400007),
},
usetime = 17500,
}
},
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:
ox_inventory/web/images/
Place your item image inside the
images/
folder.
Step 5: Save the File & Restart Server
Save the
items.lua
file.Restart your FiveM server using one of the following methods:
Console Command:
restart ox_inventory
Full Server Restart: Stop and start the server manually.
Step 6: Test the Item
Spawn the item using an admin command:
/giveitem yourID prop_name 1
(Replace
yourID
with your actual player ID andburger
with your item name.)Open OX Inventory (
F2
default 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_inventory
is running properly.Look at the FiveM forums or Discord for troubleshooting help.
Last updated