Qbox Installation

This guide explains how to use ak47_inventory as a complete standalone replacement for ox_inventory on a Qbox (QBX) server.

---

Step 1: Configure server.cfg & ox.cfg

Add the framework convar and ensure qbx_core starts before ak47_inventory:

# inside ox.cfg
setr inventory:framework "qbx"

# inside server.cfg
ensure qbx_core
ensure ak47_inventory

---

Step 2: Edit ak47_inventory/configs/config.lua

Explicitly set the framework to 'qbcore' (around line 154):

Config.Framework = 'qbcore'

---

Step 3: Edit ak47_inventory/fxmanifest.lua

Remove 'qb-inventory' from the provides block:

provides {
    'ak47_qb_inventory',
    'ox_inventory'
}

---

Step 4: Edit qbx_core/server/main.lua

Disable the strict ox_inventory version check around line 5:

if not lib.checkDependency('ox_lib', '3.20.0', true) then
    startupErrors, errorMessage = true, 'ox_lib version 3.20.0 or higher is required'
-- elseif not lib.checkDependency('ox_inventory', '2.42.1', true) then
--     startupErrors, errorMessage = true, 'ox_inventory version 2.42.1 or higher is required'
elseif GetConvar('inventory:framework', '') ~= 'qbx' then

---

Step 5: Edit qbx_core/bridge/qb/server/main.lua

Comment out lines 6 and 7 so it doesn't look for @ox_inventory.data.items:

-- local convertItems = require 'bridge.qb.shared.compat'.convertItems
-- convertItems(require '@ox_inventory.data.items', require 'shared.items')

---

Step 6: Edit qbx_core/bridge/qb/shared/main.lua

Replace lines 3 to 65 with the following parser to dynamically load all items and weapons directly from ak47_inventory:

qbShared.Items = {}

local function loadAk47File(filePath)
    local content = LoadResourceFile('ak47_inventory', filePath)
    if not content then return {} end
    local env = { Config = { Shared = {} } }
    local fn = load(content, '@@ak47_inventory/' .. filePath, 't', env)
    if fn then
        pcall(fn)
    end
    return env.Config.Shared or {}
end

-- 1. Parse Standard Items
local akItems = loadAk47File('shared/items.lua').Items or {}
for item, data in pairs(akItems) do
    qbShared.Items[item] = {
        name = item,
        label = data.label or item,
        weight = data.weight or 0,
        type = data.type or 'item',
        image = data.image or (item .. '.png'),
        unique = data.unique or false,
        useable = data.useable ~= nil and data.useable or true,
        shouldClose = data.close ~= nil and data.close or true,
        combinable = data.combinable or nil,
        description = data.description or nil
    }
end

-- 2. Parse Weapons
local akWeapons = loadAk47File('shared/weapons.lua').Weapons or {}
for weapon, data in pairs(akWeapons) do
    local weaponName = string.lower(weapon)
    qbShared.Items[weaponName] = {
        name = weaponName,
        label = data.label or weaponName,
        weight = data.weight or 0,
        type = 'weapon',
        ammotype = data.ammoname or nil,
        image = weaponName .. '.png',
        unique = true,
        useable = false,
        shouldClose = true,
        combinable = nil,
        description = nil
    }
end

-- 3. Parse Attachments / Components
local akComponents = loadAk47File('shared/components.lua').Components or {}
for component, data in pairs(akComponents) do
    local compName = string.lower(component)
    qbShared.Items[compName] = {
        name = compName,
        label = data.label or compName,
        weight = data.weight or 0,
        type = 'component',
        image = compName .. '.png',
        unique = true,
        useable = false,
        shouldClose = true,
        combinable = nil,
        description = nil
    }
end

-- 4. Parse Ammo
local akAmmo = loadAk47File('shared/ammo.lua').Ammo or {}
for ammo, data in pairs(akAmmo) do
    local ammoName = string.lower(ammo)
    qbShared.Items[ammoName] = {
        name = ammoName,
        label = data.label or ammoName,
        weight = data.weight or 0,
        type = 'ammo',
        image = ammoName .. '.png',
        unique = true,
        useable = false,
        shouldClose = true,
        combinable = nil,
        description = nil
    }
end

---

Step 7: Managing Items & Weapons

Define and manage all your items inside ak47_inventory/shared/:

• Items: shared/items.lua

• Weapons: shared/weapons.lua

• Attachments: shared/components.lua

• Ammo: shared/ammo.lua

Converting Existing Ox Items:

Paste your existing Ox item tables into converter/ox/items.lua (and weapons into converter/ox/weapons.lua). When you restart the resource, ak47_inventory will automatically convert and write them to your shared/ files.