Overview
About nCore Inventory
Grid inventory for FiveM where every item takes real cells and the server decides every move. Standalone, ESX, QBCore, QBox, ND_Core and ox_core.
- Grid inventory, every item takes real cells and the server re-checks every move
- Backpacks and vests show on your character; bags carry their own inventory
- 106 weapons as items with wear, jamming and serial numbers
- Runs standalone or on ESX, QBCore, QBox, ND_Core and ox_core
- Admin panel with offline inventories, kits, logs, item editor and live config
You press F2 and the panel opens on a grid. Every item takes the cells it needs. R turns it while you drag, and the cells show whether it fits before you let go.
It runs standalone or on top of ESX, QBCore, QBox, ND_Core or ox_core, and it saves to oxmysql or to the server's own storage. The panel only asks, the server decides every move.
What you carry#
Backpacks are worn on your character and carry their own inventory. Take one off and it drops with everything in it. Duffels and the plate carrier hold things as well, and vests show on the body.
Clothing pieces are items, so a jacket can be handed over or kept in a stash. Outfits save at the wardrobes of 8 clothing stores. This only works on freemode characters, and you need an appearance resource such as ncore_character, illenium-appearance, fivem-appearance, qb-clothing or esx_skin.
Drop a gun and it lies on the ground as that gun. A pile shows the model of what's in it, and you can also throw an item or place it where you want. Weapons and evidence can only be destroyed at a disposal point, like the Los Santos Foundry.
Food goes one bite at a time. Pull out a burger, left click takes a bite and right click puts it away. What's left stays in the item and it gets lighter as you eat. If someone is standing next to you, you can offer them a bite and they get a Y/U prompt.
Food also goes off over time. A cooler bag or a fridge slows it down, a freezer stops it.
Weapons#
106 weapons ship as items. They wear and can jam, and every firearm has a serial number. Guns you carry show on your body, and parts go on at a 3D gun bench.
Other players and cars#
/trade opens a window for items and cash. Both players see both offers and confirm after a short countdown. I added the countdown so nobody gets rushed into a bad trade.
/search and /rob work on other players. X puts your hands up.
Keys are items for cars, doors, houses, businesses and safes, so handing someone a key gives them access. L locks the nearest car you have a key for and opens it again. Trunks and gloveboxes have their own space, set per vehicle class and per model, and the ones of owned cars are only saved if you run oxmysql.
Around the map#
Eight shops are already placed on 44 counters: 24/7, LTD, Robs Liquor, hardware stores, Ammu-Nation, Binco, a fence and a pawn shop. Each counter has its own stock that sells out and comes back, and a shop or a single row can be locked to a job. A row can also need a license. There are also 256 vending machines, about 7,800 bins and dumpsters players can dig through, and mailboxes and newspaper boxes where someone can hide a thing for someone else to find.
Crafting has a workbench, a gunsmith bench and a mechanic bench. You can queue a few jobs and walk off, the finished items wait for you in a tray.
Moving from another inventory#
Scripts written for the QBCore inventory exports (AddItem, RemoveItem, HasItem, OpenInventory, CreateShop and the rest) keep working on any framework, and AddItem and RemoveItem take either common argument order. On QBox and ESX Legacy, the small compatibility folder in the package answers for the frameworks and scripts that ask for an inventory by name. A script that checks whether another inventory is running before it calls won't work unchanged.
Your players' saved items come across with invmigrate in the server console, from four common saved-data layouts. It only reports until you add apply, which runs only with nobody online, and it only reads your old tables. Stashes, trunks and gloveboxes come along too, except from ESX, which has no stash tables. This part needs oxmysql.
For you as the owner#
/invadmin opens the admin panel, where you can open a player's inventory even when they're offline, give items and kits, and read the logs.
In the item editor you change an item's label, weight, stack size, value, rarity and rules, and the change reaches every player at once. It's stored by the server, so data/items.lua isn't touched. You can also add simple items there that have no use of their own. In the Config tab every setting shows whether a change applies live or at the next restart, and the ones that can only be changed in the file are marked as such.
The Economy tab counts every item on the server and shows which resource created how many per hour. When a resource suddenly makes far more than its usual hour, admins online get a notice. You can see who holds an item, and pull the whole history of one gun or unique item by its serial or id.
There's a testing guide that walks your staff through every feature, and a demo mode I use to record videos like the one above.
Other resources can watch or refuse moves, uses, buys, crafts and trades with RegisterHook, add items at runtime with RegisterItem, and add stashes with RegisterStash. Every export and event is listed in DOCUMENTATION.md.
The interface comes in 8 languages: English, Hungarian, German, French, Spanish, Brazilian Portuguese, Polish and Turkish.
FEATURES.md comes with the script and lists everything.
Requirements#
- OneSync
- Optional: oxmysql for database storage,
invmigrateand saved trunks of owned cars, ox_target or qb-target, an appearance resource for clothing - No ox_lib and no build step (QBox still needs ox_lib for itself)
- On QBox and ESX Legacy, the small ox_inventory compatibility folder that comes in the package
- ESX Legacy 1.14 and 1.15 need
setr inventory:accounts "[]"in server.cfg - Game build 3407 or newer is recommended so every weapon works
Code and updates#
The Lua code is protected by Cfx.re escrow, while config.lua, the item and data files, languages, shops, benches, framework bridges and the web panel stay open to edit.
Updates don't install themselves. You download the new version again from your Cfx.re account, keep your config.lua and copy the new shared/defaults.lua over the old one. The changelog says what else to copy for each version.
Support#
I reply to support requests within 72 hours. Refunds are handled by Tebex under their terms.
nCore Inventory is made by nCore Development.
Not approved, sponsored or endorsed by Rockstar Games.
Features
What it does
Grid and Body Tabs
Items take real cells and R rotates them. Five tabs on the body hold items, keys, weapons, clothes and bag.
Worn Bags and Clothing
Backpacks and vests show on your character, and backpacks, duffels and the plate carrier carry their own inventory. Clothing pieces are items, and outfits save at the wardrobes of 8 clothing stores.
Weapons
106 weapons as items with wear, jamming, serial numbers, weapons on the body and a 3D gun bench.
Drops, Food and Trade
Dropped guns lie on the ground as that gun, food goes bite by bite and spoils over time. Trades need both players to confirm.
Keys and Vehicles
Physical keys for cars, doors, houses, businesses and safes. Trunks and gloveboxes have their own space.
Shops and World Loot
8 shop types on 44 counters, 256 vending machines, 7,884 searchable bins and 1,369 hiding spots.
Crafting
Blueprints, tool wear and a background queue, plus carry strength that grows as you haul things around.
Admin Panel
/invadmin opens online and offline inventories, kits, logs, an item editor, an economy view and live config.
What you get
Config open, core escrowed
Compatibility
Will it run on your server?
Frameworks
- Standalonestable
- ESXstableESX 1.1 to Legacy; ESX Legacy also needs the bundled ox_inventory compatibility folder
- QBCorestable
- QBoxstableNeeds the bundled ox_inventory compatibility folder
Resources
- ND_Coredeep integration
- ox_coredeep integration
- oxmysqldeep integrationStorage; without it the server's KVP store is used
- ox_targetdeep integration
- qb-targetdeep integration
- ncore_characterdeep integrationClothing
- illenium-appearancedeep integrationClothing
- fivem-appearancedeep integrationClothing
- qb-clothingdeep integrationClothing
- esx_skindeep integrationClothing
- ox_doorlockdeep integrationDoor keys
- qb-doorlockdeep integrationDoor keys. nui_doorlock is not supported
- ps-mdtdeep integrationGun registry
Docs
Read it before you buy
The same docs that ship with the script, updated with every release.
This is the reference for server owners and script authors. README.md is the short overview, FEATURES.md the full feature list and INSTALLATION.md the setup guide.
Most settings live in config.lua. Items, stashes, shops and benches have their own files: data/items.lua, data/stashes.lua, modules/shop/shops.lua, modules/craft/benches.lua and modules/gunbench/benches.lua, plus the language packs in locales/. shared/defaults.lua fills in any key your own config.lua does not have, so keep your config.lua when you update and copy the new shared/defaults.lua over the old one. The admin panel's Config tab shows for each setting whether it takes effect at once or after a restart.
Grid inventory for FiveM. Standalone, ESX, QBCore, QBox, ND_Core and ox_core.
nCore Development · intelnpc.com · Resource: ncore_inventory · Version: see fxmanifest.lua
What it is#
A backpack is a real backpack on your character. A gun you drop lies on the ground as that gun. A burger goes one bite at a time, and a trade only happens when both players confirm it.
The inventory runs as one resource, on its own or on top of your framework, and saves to oxmysql or to the server's own storage. The server decides every move, the panel only asks.
What it does#
- Grid inventory where every item takes real cells. R rotates, and the server re-checks every move.
- Five tabs on the body: items, keys, weapons, clothes and bag.
- Backpacks and vests show on your character. Backpacks, duffels and the plate carrier carry their own inventory.
- Clothing pieces are items. Outfits save at the wardrobes of 8 clothing stores.
- Drop, throw or place items. A pile shows the real model of what's in it.
- Food and drinks go bite by bite, spoil over time, and you can share them.
- 106 weapons as items with wear, jamming, serial numbers, weapons on the body and a 3D gun bench.
- Trade window for items and cash, searching and robbing, hands up.
- Trunks, gloveboxes and physical keys for cars, doors, houses, businesses and safes.
- 8 shop types on 44 counters, 256 vending machines, 7,884 searchable bins, 1,369 hiding spots.
- Crafting with blueprints, tool wear and a background queue. Carry strength that grows as you haul things around.
- Admin panel (
/invadmin) with online and offline inventories, kits, logs, an item editor, an economy view and live config. - Demo mode for recording showcase videos and a testing guide for your staff.
- 488 items with pictures and descriptions in 8 languages.
The full feature list, with how to reach each feature and the setting that switches it, is in FEATURES.md.
What's in the package#
| Folder | What it is |
|---|---|
ncore_inventory |
The inventory itself, with sql/install.sql for owners who create the tables by hand and the four docs listed at the bottom. |
ox_inventory |
A small compatibility folder for QBox and ESX Legacy. It has no inventory of its own and stores nothing, it forwards every call to ncore_inventory. Only install it on QBox or ESX Legacy, see INSTALLATION.md. |
Requirements#
- OneSync on.
- Optional: oxmysql (database storage,
invmigrate, saved trunks and gloveboxes of owned cars, which it reads from the framework's vehicle table), ox_target or qb-target, an appearance resource for clothing (ncore_character, illenium-appearance, fivem-appearance, qb-clothing or esx_skin). - No ox_lib and no build step. QBox needs ox_lib for qbx_core itself.
- Game build:
set sv_enforceGameBuild 3407or newer is recommended so every shipped weapon works.
Setup, server.cfg order per framework and the database notes are in INSTALLATION.md.
Works with#
| Area | Resources |
|---|---|
| Frameworks | Standalone, ESX (1.1 to Legacy), QBCore, QBox, ND_Core, ox_core. Picked up at start, so they go above ensure ncore_inventory. |
| Storage | oxmysql, or the server's own KVP store without it |
| Target eye | ox_target or qb-target. Without one, everything opens with E. |
| Clothing | ncore_character, illenium-appearance, fivem-appearance, qb-clothing, esx_skin |
| Door and house keys | ox_doorlock, qb-doorlock. House keys for bcs_housing, loaf_keysystem and qb-houses. nui_doorlock isn't supported. |
| Car keys | Work without a key script. FEATURES.md lists the vehicle key scripts it hands the lock to, and what each one gets. |
| Other | txAdmin for the save before a scheduled restart, ps-mdt for the gun registry, screenshot-basic for /invthumbs |
Your other scripts and old saves#
Scripts written for the QBCore inventory exports (AddItem, RemoveItem, HasItem, OpenInventory, CreateShop and the rest) keep working on any framework, and AddItem and RemoveItem take either common argument order. Search, GetItemCount, CanCarryItem and other common export names also answer under exports.ncore_inventory. On QBox and ESX Legacy the bundled ox_inventory folder answers for the frameworks and scripts that ask for an inventory by that name. A script that checks whether another inventory is running before it calls won't work unchanged. The details are in FEATURES.md under "Scripts that call other inventories".
Your item list comes across with invmigrate items, once. Saved inventories come across with invmigrate in the server console, from four common saved-data layouts. It only reports until you add apply, which runs only with nobody online, and it only reads the old tables. Stashes, trunks and gloveboxes come along too, except from ESX, which has no stash tables. It needs oxmysql, see section 4 of DOCUMENTATION.md.
For your own resources, RegisterHook watches or refuses moves, takes, opens, uses, buys, crafts and trades, RegisterItem adds items at runtime, and RegisterStash adds stashes. Every export, event and state bag is in section 4 of DOCUMENTATION.md.
Keys and commands players use#
| What | Default |
|---|---|
| Open the inventory | F2 or /inventory |
| Hotbar | 1 to 5 |
| Rotate while dragging | R |
| Stop the current action | Backspace |
| Give an item | drag onto a player, or /give |
| Trade | /trade |
| Search or rob | /search, /rob |
| Hands up | X or /handsup |
| Accept or decline a request | Y or U |
| Lock or unlock the nearest car you have a key for | L |
| Fix a stuck screen | /invunstuck |
Every key can be changed by the player under Settings > Key Bindings > FiveM. Admin and console commands are in section 5 of DOCUMENTATION.md, and invmigrate is in section 4.
Where to configure#
| File | What's in it |
|---|---|
config.lua |
Every setting. Start here. |
shared/defaults.lua |
Fills in any setting missing from your config.lua. Don't edit it, copy the new one over when you update. |
data/items.lua |
Item definitions: weight, size, stack, use, food, containers, weapons. |
data/descriptions.lua |
Item descriptions in all 8 languages. |
data/aliases.lua |
Maps other scripts' item names onto the shipped items. |
data/imported_items.lua |
Items copied from your framework or previous inventory by invmigrate items apply. Written by the server on your machine, yours to keep and edit, never shipped. |
data/stashes.lua |
World stashes, lockers, fridges and wardrobes. |
modules/shop/shops.lua |
Shops, counters, stock and prices. |
modules/craft/benches.lua |
Crafting benches and recipes. |
modules/gunbench/benches.lua |
Gun bench locations. |
locales/*.lua |
Interface text in 8 languages. |
data/demo.lua |
The demo tour. |
In the escrow edition all of these files stay readable, plus the framework bridges (bridge.lua, bridge/*.lua) and the web panel.
Updating#
Updates don't install themselves. Download the new version again (escrow from your Cfx.re account, full source from Tebex), keep your own config.lua (and data/imported_items.lua, if invmigrate items apply wrote it), and copy the new shared/defaults.lua over the old one so every new setting gets its default. CHANGELOG.md says what else to copy for each version.
Troubleshooting#
The inventory stops at start with a red box that names another inventory. It won't run beside a known one. Take that resource out of server.cfg and restart.
QBox shuts the whole server down at start. Check that setr inventory:framework "qbx" is in server.cfg and that the bundled ox_inventory folder starts right after ncore_inventory. Delete any other folder named ox_inventory (stopping it isn't enough) and don't add provide 'ox_inventory' anywhere.
The console says your framework started after the inventory. Move the framework's ensure line above ensure ncore_inventory, the framework is only picked up at start.
On ESX Legacy the console shows a red "ESX IS RUNNING ITS OWN INVENTORY" box. Follow the fix printed in that box.
The console prints an ALTER TABLE line at start. Your database user can't add a column. Run that line as a user with ALTER rights, then restart the resource.
A player's screen stays blurred or the cursor is stuck. /invunstuck closes the panel and clears the blur, cursor and camera, and any player can run it.
One E press opens two menus at a Binco counter or a wardrobe. Your clothing resource has its own point there. Move one of them, or add enabled = false to wardrobe_store in data/stashes.lua and to binco in modules/shop/shops.lua.
Some weapons are refused as invalid. Your server enforces an older game build. Set sv_enforceGameBuild to 3407 or newer.
Hungarian or Turkish doesn't show. GTA has no such game language, so set Config.Locale = 'hu' (or 'tr') or add setr lr:locale "hu" (or "tr") to server.cfg.
Docs#
- INSTALLATION.md - setup step by step.
- FEATURES.md - everything the script does.
- DOCUMENTATION.md - every setting, item field, export, event and admin tool.
- CHANGELOG.md - what changed in each version.
Support#
Support is on intelnpc.com and I reply within 72 hours. It covers installing, configuring and bugs in the script as shipped. Send your framework, server build, the console error and your Tebex transaction ID.
nCore Inventory is made by nCore Development. It is not approved, sponsored or endorsed by Rockstar Games.
Requirements#
- OneSync on (
set onesync onin server.cfg, or the OneSync setting in txAdmin). The server reads player peds and vehicles for reach checks, clothing checks, ground drops, trunks, gloveboxes and car keys. With OneSync off those fail, and the console prints a warning at start. - oxmysql is optional. Without it everything is saved in the server's own KVP store (unless
Config.Database.preferis'none', which saves nothing). You need oxmysql for:invmigrate, which brings over another inventory's saved data;- keeping the trunks and gloveboxes of owned vehicles, and owner-only trunks (the framework's vehicle table is read through oxmysql);
- the starter kit's check, on a framework, that a character is really new.
- No ox_lib and no build step are needed.
- A framework is optional: ESX, QBCore, QBox, ND_Core or ox_core. Without one there are no jobs or police checks, no bank accounts and no licenses, and money is the
cashitem. - QBox and ESX Legacy also need the bundled
ox_inventorycompatibility folder (step 2). - A recent game build is recommended. Some shipped weapons and models come from recent GTA Online updates. On a server that enforces an older build (
sv_enforceGameBuildin server.cfg), those weapons are refused as invalid, and a pile model the build lacks falls back to a plainer one (the console says so once). The Large backpack's model needs build 2545 or newer and the Tactical backpack's needs 2802 or newer; below that they show an older bag model. Setsv_enforceGameBuildto a recent build your FiveM server artifacts support.
Updates don't install themselves. When a new version is out, download it again (escrow from your Cfx.re account, full source from Tebex), keep your own config.lua (and data/imported_items.lua, if invmigrate items apply wrote it), and copy the new shared/defaults.lua over the old one so every new setting gets its default. Each version below says what else to copy. New versions are announced on intelnpc.com.
1.0.41#
- Fixed the keyboard focus ring on the search and sort fields announced in 1.0.40 is now in the stylesheet.
- To update: copy the new
web/folder; keep yourconfig.lua.
From the same studio
More from nCore
FAQ
About nCore Inventory
What does it need to run?
OneSync. oxmysql is optional, without it everything is saved in the server's own KVP store. No ox_lib and no build step are needed, and a framework is optional.
Which frameworks work?
Standalone, ESX (1.1 to Legacy), QBCore, QBox, ND_Core and ox_core. The framework is picked up at start, so it goes above ensure ncore_inventory in server.cfg.
Do I need the ox_inventory folder?
Only on QBox and ESX Legacy. It is a small compatibility folder in the package that forwards every call to ncore_inventory and stores nothing itself. Delete any other folder named ox_inventory first.
Can I move from another inventory?
Yes. invmigrate in the server console brings over saved inventories from four common layouts, and invmigrate items brings the item list. It only reports until you add apply, which runs only with nobody online, and it needs oxmysql.
Will my scripts keep working?
Scripts written for the QBCore inventory exports keep working on any framework, and the bundled ox_inventory folder answers on QBox and ESX Legacy. A script that checks whether another inventory is running before it calls won't work unchanged.
It stops at start with a red box. Why?
It won't run beside a known other inventory. Take that resource out of server.cfg and restart.
Is the code escrowed?
The core is, through Cfx asset escrow. Everything you normally tune stays open: config.lua, shared/defaults.lua, data files (items, stashes, descriptions), locales, framework bridges, shop and bench lists and web panel.
Do I need a licence key? Does it phone home?
No key from us and nothing calls back to us - we run no licence server. Escrowed files are checked by Cfx itself: the Cfx account that owns your server key must hold the script, so buy with that account.
Which Cfx.re account should I buy with?
The Cfx.re account that owns your server's licence key. Escrowed scripts only start on servers whose key belongs to the account that bought them.
€44.99
Ready when you are
Instant delivery, checkout right here on the site, and a Discord full of people who will answer before you pay.




