3 min read
Inventory Systems
Start with upstream qb-inventory for a QBCore server. Before replacing it, identify the exact repository and commit, check every calling resource, and test saved inventories on a staging copy. An inventory's appearance does not establish API compatibility or safe persistence.
Available Inventory Systems
QBCore Inventory
Upstream API reference, configuration and server-side inventory operations.
LJ Inventory
Archived community inventory: inspect legacy APIs and storage before migration.
QB Inventory V2
Identify the exact project behind this ambiguous label before installing a fork.
Features Comparison
Compare the implementation you actually plan to install rather than an unversioned feature checklist:
| Resource | Source baseline | Compatibility decision |
|---|---|---|
| Upstream qb-inventory | Commit dc3d07fc | Check exports and the inventories schema against existing callers/storage. |
| LJ Inventory | Commit 86ec0d84; README marks it archived | Uses legacy storage tables and an inventory-open event; not a drop-in replacement for the current server export. |
| “QB Inventory V2” | No single upstream project established by this documentation | Require a repository, commit, API documentation and schema before evaluating it. |
These are source-review baselines, not in-game compatibility certifications. Mobile layout, performance and controller support require evidence for the specific implementation; they cannot be inferred from a name or screenshot.
Installation Guide
Prerequisites
- Record the core, inventory and dependent resource commits and local changes.
- Back up the database, item definitions, images and resource files.
- Restore a staging copy before testing an inventory replacement.
General Installation Steps
- Review the target README,
fxmanifest.lua, exports and SQL at the recorded commit. - Check prerequisites and resource load order. Inventory consumers must start after their provider.
- Disable the competing inventory on staging. Keep the resource name expected by its consumers, or explicitly migrate those consumers.
- Review storage changes before importing SQL;
CREATE TABLE IF NOT EXISTSdoes not migrate existing columns or move inventory contents. - Test player, shop, stash, trunk and glovebox operations, including reconnect, inventory-full rejection and unauthorized access. See the inventory acceptance matrix.
Configuration
Keep shared item names, weights, slot limits and image filenames consistent with the target implementation. The config validator can identify supported static configuration problems; it cannot prove inventory runtime compatibility. Use the resource compatibility checklist for manifests, callers, schemas and runtime checks.
Choosing the Right Inventory
For Beginners: QBCore Inventory
Use the upstream resource and its API reference as a reproducible starting point. Keep related resources at explicitly recorded compatible revisions rather than mixing downloads described only as “latest”.
For Advanced Servers: LJ Inventory
An existing LJ installation requires a legacy API and storage audit. The project README states that support is no longer offered. Read the LJ migration notes before updating core or inventory consumers.
For Custom Setups: QB Inventory V2
Treat “V2” as a label until the supplier identifies the source. Follow the fork evaluation checklist; do not assume an optional compatibility wrapper or a particular UI framework exists.
Common Issues & Solutions
Inventory Not Opening
Capture the first server/F8 error. Check resource state, expected client/server export and execution side. A missing OpenInventory export can indicate an old inventory paired with a new caller; restarting or renaming it does not add that export.
Items Not Showing
Check QBCore.Shared.Items keys first, then image paths and failed NUI requests. Missing images and missing saved item definitions are different failures. See missing shared items and UI diagnostics.
Weight Issues
Compare the configured capacity and shared item weights with the actual AddItem/RemoveItem results. Test the full-inventory rejection path before blaming the UI.
Support & Resources
- Inventory update troubleshooting: APIs, shared items, persistence and rollback.
- Official inventory documentation and upstream issues.
- Independent community documentation: this site is not the official QBCore project.
Found an issue in this guide?
Send the page URL, the affected example, and a source or reproduction to the site maintainer. For a server or resource problem, use the support guide.
