QBX

FRAMEWORK CONFIGURATION

Choose your framework version. Complete the neccicerry changes and continue at BASICS to finalize installation.

(NEW) FOR QBX_CORE HIGHER OR EQUAL TO 1.23.0

This is the simplest and most recommended installation for the newest qbx_core version.

FXMANIFEST CHANGE

Add another provide varaible in core_inventory/fxmanifest.lua

-- Aprox line 75
provide 'qb-inventory'
provide 'ox_inventory' -- Add this

ITEMS

• Move your ox_inventory/data/items.lua into core_inventory/data/ folder

• Enable UseItemsFile = true in core_inventory/config.lua also set ItemsFileMode = 'ox'

• Modify the items to include x, y, category... variables you can find all of them in ITEMS

WEAPONS

• Since our weapons are declared in data/items.lua you will need to add them there you can grab them from our provided [items]/QB/weapons.lua and paste the lines in your ox items.lua file carefully as addicional items.

• Create an empty file core_inventory/data/weapons.lua so qbx does not bug out

START ORDER

ensure mysql-async
ensure framework -- your framework qbcore, es_extended, qbox

ensure PolyZone -- Required if any of your scripts use it 

ensure core_focus -- Here you place core_focus if you use it
ensure qb-target
ensure ox_target

ensure core_inventory -- Here you start core_inventory

...

---

BASICS

IMAGES

• Add the image of your items in core_inventory/html/img folder.

• All your images should have the same name as your items. For example, if you have an item called sandwich_bacon, the image name should be sandwich_bacon.png.

• Only .png image are included in the FXManifest so be sure to use this extension for your images

ITEMS

• Add default items from [items] folder.

• Use StartItems in core_inventory/config.lua

• For all your weapons items in your qb-core/shared/items.lua file, add ["category"] = 'weapons' . Or even better, you can use the weapons.lua we provide in [items] folder. All weapons have a size and the right category already set on it.

• Open config_weapon.lua and choose your attachment component mode, then add the attachment items in your qb-core/shared/items.lua related to the mode you choose.

• For every other item in your data/items.lua or items table in database set a category parameter ["category"] = (your category). This will change its color, sound, stacking properties in inventory. If not set will default to misc category.

• Setup every added category in core_inventory/config.lua under ItemCategories = { . Make sure to read the variables and what they do in config

• Setup item sizes in data/items.lua or items table in database by defining x and y parameters. ["x"] = 2, ["y"] = 2 . The x defines how many slots the items takes up horizontally and the y vertically.

• For more item information checkout ITEMS

---

MONEY AS ITEM

in qbcore/config.lua, please make to modify moneytypes and dontAllowminus like this :

QBConfig.Money.MoneyTypes = { cash = 500, bank = 5000, crypto = 0, black_money = 0 } 
QBConfig.Money.DontAllowMinus = { 'cash', 'crypto', 'black_money' }  

In core_inventory/config.lua make sure to enable the money as item option and set the right account name in the option, for example :

MoneyAsItem = true, -- enable / disable money as item
AccountMoneyAsItem = 'cash', -- account name
ItemMoneyAsItem = 'money', -- item name

DirtyMoneyAsItem = true, -- enable / disable balck money as item
AccountDirtyMoneyAsItem = 'black_money', -- account name
ItemDirtyMoneyAsItem = 'markedbills', -- item name

Make sure to have the item money and the item markedbills in your items.lua and for each one make sure to have the right category (money for moneyitem and markedbill for markedbills item) :

money = { name = 'money', label = 'Money', category = 'money', weight = 1000, type = 'item', image = 'cash.png', unique = true, useable = false, shouldClose = true, description = 'Money' },
markedbills = { name = 'markedbills',  category = 'markedbill', label = 'Marked Money', weight = 1000, type = 'item', image = 'markedbills.png', unique = true, useable = false, shouldClose = true, description = 'Money?' },