🎒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 (consumable)

	['djs_frap_chocolatemocha'] = {
		label = 'Chocolate Mocha',
		weight = 0,
		client = {
			status = { thirst = 0 },
			anim = { dict = 'anim@djs@drink@soda', clip = 'djs_drink_soda_sip_long' },
			prop = { model = `djs_frap_chocolatemocha`, bone = 58868, pos = vec3(0.042000, 0.060000, 0.000000), rot = vec3(-0.300000, 0.000000, 20.849972) },
			usetime = 10000,
			cancel = true,
			--notification = 'You quenched your thirst with cola'
		}
	},
	['djs_frap_cottoncandy'] = {
		label = 'Cotton Candy',
		weight = 0,
		client = {
			status = { thirst = 0 },
			anim = { dict = 'anim@djs@drink@soda', clip = 'djs_drink_soda_sip_long' },
			prop = { model = `djs_frap_cottoncandy`, bone = 58868, pos = vec3(0.042000, 0.060000, 0.000000), rot = vec3(-0.300000, 0.000000, 20.849972) },
			usetime = 10000,
			cancel = true,
			--notification = 'You quenched your thirst with cola'
		}
	},
	['djs_frap_lavender'] = {
		label = 'Lavender',
		weight = 0,
		client = {
			status = { thirst = 0 },
			anim = { dict = 'anim@djs@drink@soda', clip = 'djs_drink_soda_sip_long' },
			prop = { model = `djs_frap_lavender`, bone = 58868, pos = vec3(0.042000, 0.060000, 0.000000), rot = vec3(-0.300000, 0.000000, 20.849972) },
			usetime = 10000,
			cancel = true,
			--notification = 'You quenched your thirst with cola'
		}
	},
	['djs_frap_macha'] = {
		label = 'Macha',
		weight = 0,
		client = {
			status = { thirst = 0 },
			anim = { dict = 'anim@djs@drink@soda', clip = 'djs_drink_soda_sip_long' },
			prop = { model = `djs_frap_macha`, bone = 58868, pos = vec3(0.042000, 0.060000, 0.000000), rot = vec3(-0.300000, 0.000000, 20.849972) },
			usetime = 10000,
			cancel = true,
			--notification = 'You quenched your thirst with cola'
		}
	},
	['djs_frap_mocha'] = {
		label = 'Mocha',
		weight = 0,
		client = {
			status = { thirst = 0 },
			anim = { dict = 'anim@djs@drink@soda', clip = 'djs_drink_soda_sip_long' },
			prop = { model = `djs_frap_mocha`, bone = 58868, pos = vec3(0.042000, 0.060000, 0.000000), rot = vec3(-0.300000, 0.000000, 20.849972) },
			usetime = 10000,
			cancel = true,
			--notification = 'You quenched your thirst with cola'
		}
	},
	['djs_frap_shortcake'] = {
		label = 'Strawberry Shortcake',
		weight = 0,
		client = {
			status = { thirst = 0 },
			anim = { dict = 'anim@djs@drink@soda', clip = 'djs_drink_soda_sip_long' },
			prop = { model = `djs_frap_shortcake`, bone = 58868, pos = vec3(0.042000, 0.060000, 0.000000), rot = vec3(-0.300000, 0.000000, 20.849972) },
			usetime = 10000,
			cancel = true,
			--notification = 'You quenched your thirst with cola'
		}
	},
	['djs_frap_smores'] = {
		label = 'Smores',
		weight = 0,
		client = {
			status = { thirst = 0 },
			anim = { dict = 'anim@djs@drink@soda', clip = 'djs_drink_soda_sip_long' },
			prop = { model = `djs_frap_smores`, bone = 58868, pos = vec3(0.042000, 0.060000, 0.000000), rot = vec3(-0.300000, 0.000000, 20.849972) },
			usetime = 10000,
			cancel = true,
			--notification = 'You quenched your thirst with cola'
		}
	},
	['djs_frap_strawberry'] = {
		label = 'Strawberry',
		weight = 0,
		client = {
			status = { thirst = 0 },
			anim = { dict = 'anim@djs@drink@soda', clip = 'djs_drink_soda_sip_long' },
			prop = { model = `djs_frap_strawberry`, bone = 58868, pos = vec3(0.042000, 0.060000, 0.000000), rot = vec3(-0.300000, 0.000000, 20.849972) },
			usetime = 10000,
			cancel = true,
			--notification = 'You quenched your thirst with cola'
		}
	},
	['djs_frap_toffee'] = {
		label = 'Toffee',
		weight = 0,
		client = {
			status = { thirst = 0 },
			anim = { dict = 'anim@djs@drink@soda', clip = 'djs_drink_soda_sip_long' },
			prop = { model = `djs_frap_toffee`, bone = 58868, pos = vec3(0.042000, 0.060000, 0.000000), rot = vec3(-0.300000, 0.000000, 20.849972) },
			usetime = 10000,
			cancel = true,
			--notification = 'You quenched your thirst with cola'
		}
	},
	['djs_frap_vanillabean'] = {
		label = 'Vanilla Bean',
		weight = 0,
		client = {
			status = { thirst = 0 },
			anim = { dict = 'anim@djs@drink@soda', clip = 'djs_drink_soda_sip_long' },
			prop = { model = `djs_frap_vanillabean`, bone = 58868, pos = vec3(0.042000, 0.060000, 0.000000), rot = vec3(-0.300000, 0.000000, 20.849972) },
			usetime = 10000,
			cancel = true,
			--notification = 'You quenched your thirst with cola'
		}
	},

Items Config (non-consumable)

['djs_frap_chocolatemocha'] = {
		label = 'Chocolate Mocha',
		weight = 0,
	},
	['djs_frap_cottoncandy'] = {
		label = 'Cotton Candy',
		weight = 0,
	},
	['djs_frap_lavender'] = {
		label = 'Lavender',
		weight = 0,
	},
	['djs_frap_macha'] = {
		label = 'Macha',
		weight = 0,
	},
	['djs_frap_mocha'] = {
		label = 'Mocha',
		weight = 0,
	},
	['djs_frap_shortcake'] = {
		label = 'Strawberry Shortcake',
		weight = 0,
	},
	['djs_frap_smores'] = {
		label = 'Smores',
		weight = 0,
	},
	['djs_frap_strawberry'] = {
		label = 'Strawberry',
		weight = 0,
	},
	['djs_frap_toffee'] = {
		label = 'Toffee',
		weight = 0,
	},
	['djs_frap_vanillabean'] = {
		label = 'Vanilla Bean',
		weight = 0,
	},

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

73KB

frappuccino_photo.zip

archive

Open

---

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.