🔧Installation

Here we're going to guide you in the installation of origen_inventory.

First we want you to know that our script only supports the following versions of the two most used frameworks, in older versions it may be usable but we do not provide support since the development focuses on the following versions:

VERY IMPORTANT for any framework

For a safe startup, please do not put your framework and inventory folders in shared folders (they are in brackets)

If you do:

ensure qb-core

ensure origen_inventory

And, we assume that origin_inventory is inside [origen] and then do:

ensure [origen]

This will cause origin_inventory to restart again and make it error out, same for core.

REMOVE THESE RESOURCES FROM BRACKETS FOLDERS AND SET ON ROOT RESOURCES FOLDER.

QBCore

IMPORTANT

From inventory versions 1.9.8 onwards, installation of QB-Core is automatic and requires NO code modifications.

Just install the SQL and the changes that appear in the video.

Only in certain cases it is possible that unrecognized function errors appear, for this we recommend following the steps below and implementing the code snippets.

server.cfg

ensure oxmysql
ensure qb-core
ensure origen_inventory
...(make sure starts other scripts that use inventory functions after the origen_inventory)

Now you have to insert the SQL files into your database:

• origen_inventory/origen_inventory.sql

Add some code

Go to qb-core/server/functions.lua replace those functions:

function QBCore.Functions.CreateUseableItem(item, data)
    QBCore.UsableItems[item] = data
    exports['origen_inventory']:CreateUseableItem(item, data)
end

function QBCore.Functions.UseItem(source, item)
    if GetResourceState('origen_inventory') == 'missing' then return end
    exports['origen_inventory']:UseItem(source, item)
end

function QBCore.Functions.HasItem(source, items, amount)
    if GetResourceState('origen_inventory') == 'missing' then return end
    return exports['origen_inventory']:HasItem(source, items, amount)
end

Go to qb-core/server/player.lua, replace those functions:

function QBCore.Player.GetTotalWeight(items)
    if GetResourceState('origen_inventory') == 'missing' then return 0 end
    return exports['origen_inventory']:GetTotalWeightByItems(items)
end

Replace all the qb-inventory strings with origen_inventory in all the resources folder using visual studio code:

ESX

server.cfg

ensure oxmysql
ensure es_extended
ensure origen_inventory
...(make sure to start other scripts that use inventory functions after the origen_inventory)

Now you have to insert the SQL files into your database:

• origen_inventory/origen_inventory.sql

Add some code

Go to es_extended/client/common.lua and add this code:

if GetResourceState('origen_inventory') ~= 'missing' then
    Config.OrigenInventory = true
end

Go to es_extended/client/functions.lua and replace the ESX.GetPlayerData function:

function ESX.GetPlayerData()
    if Config.OrigenInventory then 
        TriggerEvent('__cfx_export_origen_inventory_getPlayerInventory', function(ref)
            if ref then
                ESX.PlayerData.inventory = ref()
            end
        end)
    end
    return ESX.PlayerData
end

Go to es_extended/server/common.lua and add this code above the StartDBSync function:

if GetResourceState('origen_inventory') ~= 'missing' then
    Config.OrigenInventory = true
    Config.PlayerFunctionOverride = 'OrigenInventory'
end

Go to es_extended/server/common.lua and add this code below the Core.DatabaseConnected = true:

if Config.OrigenInventory then
    ESX.Items = exports['origen_inventory']:GetItemList()
end

Go to es_extended/server/functions.lua and add this code at the end of the file:

AddEventHandler('onResourceStop', function(resourceName)
    if (resourceName == "origen_inventory") then
      	Core.SavePlayers()
    end
end)

Go to es_extended/server/functions.lua and replace the ESX.RegisterUsableItem function:

function ESX.RegisterUsableItem(item, cb)
    Core.UsableItemsCallbacks[item] = cb
    if Config.OrigenInventory then
	exports['origen_inventory']:CreateUseableItem(item, cb)
    end
end

Go to es_extended/server/functions.lua and replace the ESX.UseItem function:

function ESX.UseItem(source, item, ...)
    local src, itm = source, item
    if type(src) == 'string' then item = src source = itm end 

    if ESX.Items[item] then
        local itemCallback = Core.UsableItemsCallbacks[item]
        if Config.OrigenInventory then
            return exports['origen_inventory']:UseItem(item, source, ...)
        end
        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

Go to es_extended/server/functions.lua and replace the ESX.GetItemLabel function:

function ESX.GetItemLabel(item)
    if Config.OrigenInventory then
        return exports['origen_inventory']:GetItemLabel(item)
    end
    if Config.OxInventory then
        item = exports.ox_inventory:Items(item)
        if item then
            return item.label
        end
    end
	
    if ESX.Items[item] then
        return ESX.Items[item].label
    else
        print(('[^3WARNING^7] Attemting to get invalid Item -> ^5%s^7'):format(item))
    end
end

Go to es_extended/server/functions.lua and add this code at the bottom of the file:

exports("GetUseablesItems", function()
    return Core.UsableItemsCallbacks
end)

Add this file to the es_extended/server/classes/overrides folder

3KB

origeninventory.lua