Installation Guide

Let's start with the initial installation steps you need to follow to make the script work correctly.

Step 1: Download Our Free Redesign

Download our redesigned version of ox_inventory from pinkFrog_inventoryAddon/installation/githubLink.txt

---

Step 2: Installing Dependencies

Our script requires the following dependencies:

• ox_lib

• oxmysql

• ox_target

• ox_inventory ← redesigned by us (download in Step 1)

Additionally, we recommend using MariaDB as your Database Management System.

---

---

Step 3: Import Old Data

If you used ox_inventory before, simply copy your existing files such as:

• items.lua

• shops.lua

• weapons.lua

and paste them into the data/ folder of the new version. Do the same with all item images.

---

If you want to keep your own items.lua, you must also add our custom items listed below to your existing file.

🧥 Add Clothing and Extra Items

You must add the following items to your ox_inventory/data/items.lua file.

Items.lua

	
	['backpack'] = {
		label = 'Extra Backpack',
		weight = 5000,
		stack = true,
		close = true,
		description = 'Add extra slots and weight',
		rarity = 'unique', -- can be unique, rare, epic, legendary, mythic
	},

		['extrabag'] = {
		label = 'Extra Bag',
		weight = 7000,
		stack = true,
		close = true,
		description = 'Add extra slots and weight',
		rarity = 'epic', -- can be unique, rare, epic, legendary, mythic
		canThrow = true, -- if true, then you can throw this item (only if Config.throwingSettings.enable = true in pinkFrog_inventoryAddon/config.lua)
		-- if you enable canThrow without prop it's going to use default prop of bag 
		-- propThrow = 'prop_nigel_bag_pickup', -- prop to show when you throw item (only if canThrow = true) 
		client = {
		   image = 'bags.png',
		}
	},

	['bag_clothes'] = {
		label = 'Bag (Clothes)',
		weight = 1000,
		stack = false,
		close = true,
		consume = 0,
		description = 'A stylish bag to carry your clothes',
		rarity = 'rare', -- can be unique, rare, epic, legendary, mythic
		canRename = true, -- if true, then you can rename this item (only if Config.canRenameAllItems = false in config.lua)
	    canChangeDescription = true, -- if true, then you can change description for this item (only if Config.canChangeDescription = false in config.lua)
		canThrow = true, -- if true, then you can throw this item (only if Config.throwingSettings.enable = true in pinkFrog_inventoryAddon/config.lua)
		propThrow = 'prop_nigel_bag_pickup', -- prop to show when you throw item (only if canThrow = true)
		client = {
			export = 'pinkFrog_inventoryAddon.useBagClothes',
		},
	},

	-- it's exmample you can register as many items as you want below
  ['plate_armor'] = {
	label = 'Plate armor',
	weight = 100,
	stack = true,
	close = true,
	rarity = 'rare',
	consume = 0,
	description = 'Adds 50 extra protection to your bulletproof vest',
	client = {
		   export = 'pinkFrog_inventoryAddon.fasterUsePlate',
	},
  },

 
  ['plate_reinforced'] = {
	label = 'Plate armor (Reinforced)',
	weight = 100,
	stack = true,
	close = true,
	rarity = 'rare',
	consume = 0,
	description = 'Adds 75 extra protection to your bulletproof vest',
	client = {
		   image = 'plate_armor.png',
		   export = 'pinkFrog_inventoryAddon.fasterUsePlate',
	},
   },

    
  ['plate_military'] = {
	label = 'Plate armor (Military)',
	weight = 100,
	stack = true,
	close = true,
	rarity = 'rare',
	consume = 0,
	description = 'Adds 100 extra protection to your bulletproof vest',
	client = {
		   image = 'plate_armor.png',
		   export = 'pinkFrog_inventoryAddon.fasterUsePlate',
	},
},



	-- You need to add the following items to your ox_inventory/data/items.lua file
['hat'] = {
	label = 'Hat',
	weight = 100,
	stack = false,
	close = true,
	description = nil,
	buttons = {      
		
        {
            label = 'Hide hair', -- additional button to hide hair
            action = function(slot) 
                TriggerEvent('pinkFrog:repairFivemBrokenModels', slot, 'hat', 'clear')
            end
        },
        {
            label = 'Show hair',
            action = function(slot)
                TriggerEvent('pinkFrog:repairFivemBrokenModels', slot, 'hat', 'restore')
            end
        },
    },
},

['ears'] = {
		label = 'Ears',
		weight = 100,
		stack = true,
		close = true,
		description = nil,

},
	
['tshirt'] = {
	label = 'T-shirt',
	weight = 100,
	stack = false,
	close = true,
	description = nil,
},



['torso'] = {
	label = 'Torso',
	weight = 0,
	stack = false,
	close = true,
	description = nil,
},


['arms'] = {
	label = 'Arms',
	weight = 100,
	stack = true,
	close = true,
	description = nil,
},

['legs'] = {
	label = 'Pants',
	weight = 100,
	stack = false,
	close = true,
	description = nil,
},


['shoes'] = {
	label = 'Shoes',
	weight = 100,
	stack = false,
	close = true,
	description = nil,	
},

['mask'] = {
    label = 'Mask',              
    weight = 100,           
    stack = false,                 
    close = true,                   
    description = nil,             
    buttons = {           
        {
            label = 'Hide face', -- additional button to hide face
            action = function(slot) 
                TriggerEvent('pinkFrog:repairFivemBrokenModels', slot, 'mask', 'clear')
            end
        },
        {
            label = 'Show face',
            action = function(slot)
                TriggerEvent('pinkFrog:repairFivemBrokenModels', slot, 'mask', 'restore')
            end
        },
    },
},

['chain'] = {
	label = 'Chain',
	weight = 100,
	stack = false,
	close = true,
	description = nil,
},


['glasses'] = {
	label = 'Glasses',
	weight = 100,
	stack = false,
	close = true,
	description = nil,
},


['bproof'] = {
	label = 'Bulletproof',
	weight = 100,
	stack = false,
	close = true,
	description = nil,
	   buttons = {           
        {
            label = 'Add a plate', -- additional button to add plate
            action = function(slot) 
                TriggerEvent('pinkFrog:addPlateToBproof', slot)
            end
        },
	},
},


['bags'] = {
	label = 'Bag',
	weight = 100,
	stack = false,
	close = true,
	description = nil,
},

['watches'] = {
	label = 'Watches',
	weight = 100,
	stack = false,
	close = true,
	description = nil,
},

Images add to: ox_inventory/web/images/

100KB

itemsImages.zip

archive

Open

---

Step 4: Configuration

1. Open pinkFrog_inventoryAddon/shared/config.lua file

2. Configure our script basing on your needs.

1. Open ox_inventory/init.lua file

2. Configure our script basing on your needs.

Step 5: Start order

ensure ox_inventory
ensure pinkFrog_inventoryAddon

It's important to start in logical order to prevent any errors in your server console!

It's only EXAMPLE of starting order, should looks similiar but do not copy this.

ensure oxmysql
ensure ox_lib
ensure es_extended # your framework can be qbx-core or qb it's only example!
ensure ox_target
ensure ox_inventory # inventory here
ensure pinkFrog_inventoryAddon # our addon script here

1. Save all changes

2. Go to file ox_inventory

Step 6: Clothing Script Setup

If your clothing framework or script isn’t listed here, open a ticket on our Discord — we’ll help you adapt it!

illenium-appearance installation

Option 1: Use attached files and replace in script [ONLY FOR FRESH AND LATEST VERSION]

Replace this file with illenium-appearance/client/client.lua

26KB

client.lua

Open

Replace this file with illenium-appearance/client/outfits.lua

4KB

outfits.lua

Open

Replace this file with illenium-appearance/game/nui.lua

4KB

nui.lua

Open

Option 2: Follow guide below and do it by yourself

illenium-appearance Guide

Add Clothing Events

1. Go to illenium-appearance/client/client.lua and find this below

RegisterNetEvent("illenium-appearance:client:changeOutfit", function(data)

1. Paste this event

   TriggerEvent('pinkFrog_syncWithClotheShopAfterBuy')

   like on screenshot below!

   
2. Go to illenium-appearance/client/outfits.lua and find function LoadJobOutfit(oData)

3. Paste this event

   TriggerEvent('pinkFrog_syncWithClotheShopAfterBuy')

   like on screenshot below!

   
4. Go to illenium-appearance/game/nui.lua and find

appearance_save

1. Paste this event

   TriggerEvent('pinkFrog_syncWithClotheShopAfterBuy')

   like on screenshot below!

   

esx_skin installation

Option 1: Use attached file and replace it in script [ONLY FOR FRESH AND LATEST VERSION]

4KB

menu.lua

Open

Replace this file with esx_skin/client/modules/menu.lua

Option 2: Follow guide below and do it by yourself

esx_skin Guide

We recommend using LATEST and FRESH version of esx_skin to avoid any issues and errors!

Add our Clothing Event

• Find function Menu:Saveable(submitCb, cancelCb, restrict)

• Paste this event

  TriggerEvent('pinkFrog_syncWithClotheShopAfterBuy')

  like on screenshot below!

  

---

qb-clothing installation

Option 1: Use attached file and replace it in script [ONLY FOR FRESH AND LATEST VERSION]

77KB

main.lua

Open

Replace this file with qb-clothing/client/main.lua

Option 2: Follow guide below and do it by yourself

qb-clothing Guide

We recommend using LATEST and FRESH version of qb-clothing to avoid any issues and errors!

Add Export to Get Data

• Find local function SaveSkin() and add this code like on screenshot!

• Paste this event

  TriggerEvent('pinkFrog_syncWithClotheShopAfterBuy')

  like on screenshot below!

  

---

17Mov_CharacterSystem Setup

Option 1: Follow guide below and do it by yourself

17Mov_CharacterSystem Guide

1. Go to 17Mov_CharacterSystem/client/functions.lua and Locate in the file

RegisterNetEvent("17mov_CharacterSystem:SkinMenuClosed", function()

and copy this code:

RegisterNetEvent("17mov_CharacterSystem:SkinMenuClosed", function()
    -- You can add custom code after skin menu open
    TriggerEvent('pinkFrog_syncWithClotheShopAfterBuy')
    if GetResourceState("qs-inventory") ~= "missing" then
        exports['qs-inventory']:setInClothing(false)
    end
end)

To look like this:

1. Set in pinkFrog_inventoryAddon/shared/config.lua

   Config.skinSystem = 'illenium-appearance' --- 'illenium-appearance' or 'skinchanger' or editable by yourself in client_editable.lua (if you use rcore_clothing set it to skinchanger

---

rcore_clothing installation

To enable compatibility with the RCore clothing system

1. Go to pinkFrog_inventoryAddon/shared/config.lua and set to true to enable RCore clothing compatibility

   Config.enableRcoreClothing = true -- ✅ Set to true to enable RCore clothing compatibility

2. Locate the file rcore_clothing/client/impl/impl.lua and replace its contents with the code below.

    AddEventHandler('rcore_clothing:onClothingShopClosed', function()
       local outfit = nil
   
       if Config.Framework == 1 then
           outfit = PedToSkinchanger()
       elseif Config.Framework == 2 then
           outfit = GetPedQBCoreSkin()
       end
   
       if outfit then
           TriggerServerEvent('rcore_clothing:impl:setFallbackOutfit', outfit)
           TriggerEvent('pinkFrog_syncWithClotheShopAfterBuy') -- here our event
       end
   end)

fivem-appearance (from wasabi) installation

Option 1: Use attached file and replace it in script [ONLY FOR FRESH AND LATEST VERSION]

11KB

client.lua

Open

Replace this file with fivem-appearance/client/client.lua

10KB

functions.lua

Open

Replace this file with fivem-appearance/client/functions.lua

To enable compatibility with the fivem-appearance system

1. Go to pinkFrog_inventoryAddon/shared/config.lua and change skin System to:

   Config.skinSystem = 'fivem-appearance' -- 'illenium-appearance' / 'skinchanger' / 'fivem-appearance' or editable by yourself in client_editable.lua (fivem-appearance supported from wasabi)

2. Locate in the file fivem-appearance/client/client.lua

   exports['fivem-appearance']:startPlayerCustomization(function (appearance)

   and replace its contents with the code below.

3. exports['fivem-appearance']:startPlayerCustomization(function (appearance)
   		if (appearance) then
   			TriggerServerEvent('fivem-appearance:save', appearance)
               TriggerEvent('pinkFrog_syncWithClotheShopAfterBuy')
   			ESX.SetPlayerData('ped', PlayerPedId())
   		else
   			ESX.SetPlayerData('ped', PlayerPedId())
   		end
   end, config)

4. In the same file locate event:

   RegisterNetEvent('fivem-appearance:setOutfit')

and replace its content with the code below:

RegisterNetEvent('fivem-appearance:setOutfit')
AddEventHandler('fivem-appearance:setOutfit', function(data)
	local pedModel = data.ped
	local pedComponents = data.components
	local pedProps = data.props
	local playerPed = PlayerPedId()
	local currentPedModel = exports['fivem-appearance']:getPedModel(playerPed)
	if currentPedModel ~= pedModel then
    	exports['fivem-appearance']:setPlayerModel(pedModel)
		Wait(500)
		playerPed = PlayerPedId()
		exports['fivem-appearance']:setPedComponents(playerPed, pedComponents)
		exports['fivem-appearance']:setPedProps(playerPed, pedProps)
		local appearance = exports['fivem-appearance']:getPedAppearance(playerPed)
		TriggerServerEvent('fivem-appearance:save', appearance)
		ESX.SetPlayerData('ped', PlayerPedId())
	else
		exports['fivem-appearance']:setPedComponents(playerPed, pedComponents)
		exports['fivem-appearance']:setPedProps(playerPed, pedProps)
		local appearance = exports['fivem-appearance']:getPedAppearance(playerPed)
		TriggerServerEvent('fivem-appearance:save', appearance)
		ESX.SetPlayerData('ped', PlayerPedId())
	end
    TriggerEvent('pinkFrog_syncWithClotheShopAfterBuy')
end)

1. In the same file locate event:

   RegisterNetEvent('esx_skin:openSaveableMenu')

and change whole function with code below:

RegisterNetEvent('esx_skin:openSaveableMenu')
AddEventHandler('esx_skin:openSaveableMenu', function(submitCb, cancelCb)
	local config = {
		ped = true,
		headBlend = true,
		faceFeatures = true,
		headOverlays = true,
		components = true,
		props = true
	}
	exports['fivem-appearance']:startPlayerCustomization(function (appearance)
		if (appearance) then
			TriggerServerEvent('fivem-appearance:save', appearance)
			ESX.SetPlayerData('ped', PlayerPedId())
			if submitCb then submitCb() end
            TriggerEvent('pinkFrog_syncWithClotheShopAfterBuy')
		else
			if cancelCb then cancelCb() end
			ESX.SetPlayerData('ped', PlayerPedId())
            TriggerEvent('pinkFrog_syncWithClotheShopAfterBuy')
		end
	end, config)
end)

1. Open fivem-appearance/client/functions.lua and locate function:

   openShop = function(store, price)

   and change whole function with code below:

   openShop = function(store, price)
       local ped = cache.ped
       local currentAppearance = exports['fivem-appearance']:getPedAppearance(ped)
       local tetovaze = exports['fivem-appearance']:getPedTattoos(ped)
       currentAppearance.tattoos = tetovaze
       local config = {}
       InMenu = true
       if store == 'clothing' then
           TriggerEvent('fivem-appearance:clothingShop', price)
       else
           if store == 'clothing_menu' then 
               config = {
                   ped = false,
                   headBlend = false,
                   faceFeatures = false,
                   headOverlays = false,
                   components = true,
                   props = true,
                   tattoos = false
               }
           elseif store == 'barber' then
               config = {
                   ped = false,
                   headBlend = true,
                   faceFeatures = true,
                   headOverlays = true,
                   components = false,
                   props = false,
                   tattoos = false
               }
           elseif store == 'tattoo' then 
               config = {
                   ped = false,
                   headBlend = false,
                   faceFeatures = false,
                   headOverlays = false,
                   components = false,
                   props = false,
                   tattoos = true
               }
           end
           exports['fivem-appearance']:startPlayerCustomization(function (appearance)
               if (appearance) then
   		if json.encode(appearance.tattoos) == '[]' then
                       appearance.tattoos = tetovaze
                   end
                   if price then
                       local paid = lib.callback.await('fivem-appearance:payFunds', 100, price)                    
                       if paid then
                           lib.notify({
                               title = Strings.success,
                               description = (Strings.success_desc):format(addCommas(price)),
                               duration = 3500,
                               icon = 'basket-shopping',
                               type = 'success'
                           })
                           TriggerServerEvent('fivem-appearance:save', appearance)
                           TriggerEvent('pinkFrog_syncWithClotheShopAfterBuy')
                           InMenu = false
                           ESX.SetPlayerData('ped', PlayerPedId())
                       else
                           lib.notify({
                               title = Strings.no_funds,
                               description = Strings.no_funds_desc,
                               duration = 3500,
                               icon = 'ban',
                               type = 'error'
                           })                           
                           exports['fivem-appearance']:setPlayerAppearance(currentAppearance)
                           InMenu = false
                           TriggerServerEvent('fivem-appearance:save',currentAppearance)
                           ESX.SetPlayerData('ped', PlayerPedId())
                       end
                   else
                       TriggerServerEvent('fivem-appearance:save', appearance)
                       TriggerEvent('pinkFrog_syncWithClotheShopAfterBuy')
                       InMenu = false
                       ESX.SetPlayerData('ped', PlayerPedId())
                   end
               else
                   ESX.SetPlayerData('ped', PlayerPedId())
                   inMenu = false
               end
           end, config)
       end
   end

qs-appearance installation

Use attached file and replace it in script [ONLY FOR FRESH AND LATEST VERSION]

766B

ox_inventory.lua

Open

Replace this file with qs-appearance\client\custom\inventory\ox_inventory.lua

Set in our config: "qs-appearance" pinkFrog_inventoryAddon/shared/config.lua

crm-appearance installation

Use attached file and replace it in script [ONLY FOR FRESH AND LATEST VERSION]

6KB

crm-main.lua

Open

Replace this file with crm-appearance/crm-open/crm-client/crm-main.lua

Set in our config: "crm-appearance" pinkFrog_inventoryAddon/shared/config.lua

---

tgiann-clothing installation

Use attached file and replace it in script [ONLY FOR FRESH AND LATEST VERSION] _{Note: The problem is that tgiann didn’t add an export or an editable option for finishing or saving clothes. But I managed to work around it a bit I just don’t like this solution, because even if we don’t change anything and simply close the UI, it still adds the items. Try to get in touch with him to add an export or something in editable.lua that allows checking whether someone saved their skin, because this is only a temporary solution. Once he adds it, please inform me on the ticket.}

To enable compatibility with the tgiann-clothing system

1. Go to pinkFrog_inventoryAddon/shared/config.lua and change skin System to:

   Config.skinSystem = 'tgiann-clothing' -- 'illenium-appearance' / 'skinchanger' / 'fivem-appearance' / crm-appearance / qs-appearance / tgiann-clothing  or editable by yourself in client_editable.lua (fivem-appearance supported from wasabi)

2. Locate in the file tgiann-clothing/client/editable.lua

   function uiIsOpen(open)

   and replace its contents with the code below.

3. function uiIsOpen(open)
       if open then
           TriggerEvent("tgiann-hud:ui", false)
           TriggerEvent("tgiann-lumihud:ui", false)
       else
           TriggerEvent("tgiann-hud:ui", true)
           TriggerEvent("tgiann-lumihud:ui", true)
           TriggerEvent('pinkFrog_syncWithClotheShopAfterBuy')
       end
       if config.displayRadar then
           DisplayRadar(not open)
       end
   end