💾Installation

Installation and download processes are straightforward and fixed. After following the specified steps, you can easily complete the installation.

Before Starting

Installation and download processes are straightforward and fixed. After following the specified steps, you can easily complete the installation. Skipping a small step can lead to significant errors in the future!

If you get an error, and if the error located in errors page, support it will take much longer for you to get a reply.

If you don't modify configurations file, support it will take much longer for you to get a reply.

Installation

Extract ls-inventory from the downloaded folder and install it on your server.

If the downloaded file has a different name than ls-inventory, rename it to ls-inventory or it will not work and errors will occur!

After installing it on your server, import the SQL database named "ls_inventory.sql" into your server's database.

Before starting, make sure you're started ls-inventory after ls-core start. If you dont, start ls-inventory after ls-core.

Requirements

Do not skip any requirements. It's will errors in future!

First, make sure that the specified resources have been downloaded and installed on your server;

Script	Download
ls-core	https://github.com/LquenS/ls-core
ls-weapons	https://github.com/LquenS/ls-weapons

Framework

QB-CORE

If you're using newest qb-core, replace all ["qb-inventory"] exports with ["ls-inventory"] and, locate "self.Functions.SetPlayerData" and replace whole function with,

function self.Functions.SetPlayerData(key, val)
        if not key or type(key) ~= 'string' then return end
        self.PlayerData[key] = val
        if key == 'items' then exports["ls-inventory"]:SetMainItems(self.PlayerData.source, val) end
        self.Functions.UpdatePlayerData()
end

Thats it, there is no more requirements for change!

If you're using old qb-core version "before inventory update", find qb-core/server/player.lua after that locate these functions.

Functions Required Change

Locate "self.Functions.AddItem" and replace whole function with,

function self.Functions.AddItem(item, amount, slot, info)
    return exports["ls-inventory"]:AddItem(self.PlayerData.source, item, amount, slot, info)
end

Locate "self.Functions.RemoveItem" and replace whole function with,

function self.Functions.RemoveItem(item, amount, slot)
    return exports["ls-inventory"]:RemoveItem(self.PlayerData.source, item, amount, slot)
end

Locate "self.Functions.GetItemBySlot" and replace whole function with,

function self.Functions.GetItemBySlot(slot)
    return exports["ls-inventory"]:GetItemBySlot(self.PlayerData.source, slot)
end

Locate "self.Functions.GetItemByName" and replace whole function with,

function self.Functions.GetItemByName(item)
    return exports["ls-inventory"]:GetItemByName(self.PlayerData.source, item)
end

Locate "self.Functions.GetItemsByName" and replace whole function with,

function self.Functions.GetItemsByName(item)
    return exports["ls-inventory"]:GetItemsByName(self.PlayerData.source, item)
end

Locate "self.Functions.ClearInventory" and replace whole function with,

function self.Functions.ClearInventory()
    exports["ls-inventory"]:ClearInventory(self.PlayerData.source)
end

Locate "self.Functions.SetInventory" and replace whole function with,

function self.Functions.SetInventory(items)
    -exports["ls-inventory"]:SetInventory(self.PlayerData.source, items)
end

After doing changes, its needs to look like.

After doing these steps everything is done!

ESX

ESX, installation is really basic, first find es_extended/server/classes/player.lua after that locate these functions.

Functions Required Change

Locate "self.addInventoryItem" and replace whole function with,

function self.addInventoryItem(name, count, metadata, slot)
    return exports["ls-inventory"]:AddItem(self.source, name, count, slot, metadata)
end

Locate "self.removeInventoryItem" and replace whole function with,

function self.removeInventoryItem(name, count, metadata, slot)
    return exports["ls-inventory"]:RemoveItem(self.source, name, count, slot)
end

Locate "self.getInventoryItem" and replace whole function with,

function self.getInventoryItem(name, metadata)
    return exports["ls-inventory"]:GetItemByName(self.source, name)
end

Locate "self.hasItem" and replace whole function with,

function self.hasItem(item)
    return exports["ls-inventory"]:HasItem(self.source, item, 1)
end

After doing changes, its needs to look like.

Newest ESX versions added item check to their code. This means if you use newest version of ESX you cannot use most items if you want to use all items,

Find es_extended/server/functions.lua after that locate "ESX.UseItem" and replace whole function with,

function ESX.UseItem(source, item, ...)
  --if ESX.Items[item] then
    local itemCallback = Core.UsableItemsCallbacks[item]

    if itemCallback then
      local success, result = pcall(itemCallback, source, item, ...)

      if not success then
        return result and print(result) or
                 print(('[^3WARNING^7] An error occured when using item ^5"%s"^7! This was not caused by ESX.'):format(item))
      end
    end
  --else
  --  print(('[^3WARNING^7] Item ^5"%s"^7 was used but does not exist!'):format(item))
  --end
end

After doing changes, its needs to look like.

After doing these steps everything is done!