Core Inventory

Requirements

Framework

QBCoreESXQBX

Database

MySQL

Setup

1

Add the Resource

Place core_inventory into your server's resources folder.

resources/
  [c8re]/
    core_inventory/

2

Import the Database

Execute the SQL file included with the resource:

-- Run this in your database
SOURCE core_inventory.sql;

Or import core_inventory.sql through your database management tool (HeidiSQL, phpMyAdmin, etc).

This creates the coreinventories table with the required primary key constraint and adds the inventorysettings column to your players/users table.

TIP

The script can auto-create tables if EnableDatabaseAutoCreation is set to true in config — but running the SQL manually is recommended for first-time setup.

3

Configure the Framework

Open config.lua and set your framework:

Config = {
    Framework = 'qb-core',              -- 'qb-core' or 'esx'
    FrameworkResource = 'qb-core',      -- Resource name of your framework
    NewFrameworkVersion = true,          -- ESX only: set false for versions < 1.8
}

4

Framework-Specific Setup

Choose your framework below and follow the specific setup instructions:

Core Inventory works out of the box with QBCore — no extra setup needed. Just add your items to qb-core/shared/items.lua using the fields described in Item Structure.

1. Add Items

Copy the contents of [items]/QB/required items.lua into your qb-core/shared/items.lua

2. Add Weapons

Copy the contents of [items]/QB/weapons.lua into your qb-core/shared/items.lua

3. Add Attachments

Choose one of the attachment files from [items]/QB/attachments/ based on your config_weapons.lua setup:

• attachments_by_category.lua — if UniqueComponentByWeaponCategory = true (default)
• attachments.lua — if UniqueComponent = true
• attachments_shared.lua — if SharedComponentForAllWeapons = true

WARNING

Reloading core_inventory at runtime (e.g. ensure core_inventory) can cause errors with the default qb-core. Use our modified qb-core fork which routes inventory calls directly, so everything survives resource restarts.

C8RE qb-core

Modified qb-core with built-in core_inventory support — replace your existing qb-core with this

ForkDownload

1. Enable Custom Inventory

In es_extended/shared/config/main.lua, replace:

Config.CustomInventory = false

with:

Config.CustomInventory = 'core_inventory'
Config.CoreInventory = Config.CustomInventory == 'core_inventory'

2. Add the Override File

Download the override file below and place it in es_extended/server/classes/overrides/:

core_inventory.lua

Override file for es_extended/server/classes/overrides/

~7KBDownload

3. Add Items

1. Execute [items]/ESX/setup.sql in your database — this adds columns to your items table for grid sizes and categories
2. Execute [items]/ESX/required items.sql to insert all required items
3. Execute [items]/ESX/weapons.sql to insert weapon items
4. For weapon attachments, choose one of the attachment files from [items]/ESX/attachments/ based on your config_weapons.lua setup

1. FXManifest Change

Add another provide variable in core_inventory/fxmanifest.lua:

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

2. Items

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

Enable the items file in core_inventory/config.lua:

UseItemsFile = true,
ItemsFileMode = 'ox',

Modify the items to include x, y, category and other required fields — you can find all of them in Item Structure.

3. Weapons

Since weapons are declared in data/items.lua, you need to add them there. Grab the weapon items from the provided [items]/QB/weapons.lua and paste them into your ox items file as additional items.

The file core_inventory/data/weapons.lua should already exist in the resource. Make sure it has the following structure so QBX does not error out:

return {
    Weapons = {},
    Components = {},
    Ammo = {}
}

5

Start the Resource

Add to your server.cfg after your framework and oxmysql:

ensure oxmysql
ensure qb-core
ensure core_inventory

DANGER

oxmysql must start before core_inventory. The script requires it for all database operations.

WARNING

Remove any other inventory script (qb-inventory, ox_inventory, etc.) from your server.cfg to avoid conflicts. Core Inventory provides qb-inventory compatibility automatically.

6

Verify

1. Start your server
2. Join and check for any errors in the console
3. Press TAB (default) to open the inventory
4. Check that items, clothing slots, and weapon holders appear correctly

Item Data Override

For real-time item editing without restarts:

ItemsDataOverride = true, -- Edit items in-game via C8RE Tools

When enabled, use the /core_inventory command to open the C8RE Tools panel and edit item properties live.