🎒Ox Inventory Install

Step 1: Locate the OX Inventory Folder

  1. Navigate to your FiveM server directory.

  2. Open the resources folder.

  3. Find and open the ox_inventory resource folder.


Step 2: Open the data/items.lua File

  1. Inside the ox_inventory folder, go to:

    ox_inventory/data/items.lua
  2. 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_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_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

  1. Navigate to:

    ox_inventory/web/images/
  2. Place your item image inside the images/ folder.


Step 5: Save the File & Restart Server

  1. Save the items.lua file.

  2. 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

  1. Spawn the item using an admin command:

    /giveitem yourID prop_name 1

    (Replace yourID with your actual player ID and burger with your item name.)

  2. Open OX Inventory (F2 default key).

  3. 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