Documentation
Fixes for the most common Quasar Inventory problems: the inventory not opening, missing items or images, wiped inventories, trunks and stashes in use, clothing, weapons, ammo and qs-shops.
What goes wrong most often, what it means, and what to do about it. Most of these are load order or configuration, not faults. Turn on Config.Debug while you investigate — the console then explains what the inventory is doing — and turn it off again afterwards.
The resource folder was renamed. It must be called exactly qs-inventory; rename it back and restart.
qs-inventory requires ox_lib, oxmysql and a server artifact of build 4752 or newer. Make sure both resources are ensured above qs-inventory.
The framework started after the inventory, or the framework is not the Quasar-edited version. Put ensure qs-inventory below your framework in server.cfg, and use the pre-edited ESX, QBCore or Qbox from Installation. Another inventory still running (ox_inventory, qb-inventory, esx_inventory) causes the same symptom.
sql/esx.sql resets users.inventory on purpose, and both SQL files drop and recreate the inventory tables. Restore your backup and import the file only on a fresh install. To bring over stashes, trunks and gloveboxes from the old qs-inventory, use Config.FetchOldInventory instead.
The web/dist/ folder is missing or was only partly uploaded. Re-copy the whole resource from the download.
Switch to compact mode in the customization dock, or start everyone in it with Config.CompactInventory = true.
On QBCore, items are read from qb-core/shared/items.lua, not from the inventory. On ESX and Qbox they are read from qs-inventory/shared/items.lua. Add it to the right file and restart. When a player's saved item no longer exists in the list, the inventory removes it at load and prints a warning.
The PNG is missing from qs-inventory/web/dist/images/, or its name differs from the item's image field (names are case-sensitive on Linux). Add the file and restart the resource.
Check that useable = true, that the item is registered with CreateUsableItem (or has a client block), and that none of its limits apply: job, Config.BlockedItemsHotbar, Config.UseItemInVehicle. A decayed item at 0 % with delete = false reports that it has expired.
Items stack only when they are not unique and their metadata matches.
The weight is full, not the slots. Weights are in grams; check Config.InventoryWeight.weight. The limit per item in Config.OnePerItem also applies — the backpack family shares one limit.
It is listed in Config.notStoredItems (backpacks by default).
Stashes, trunks, gloveboxes and drops open for one player at a time. If a crash left one marked as in use, run /resetinv stash <id> (or trunk / glovebox with the plate). Items are not touched.
When you open a stash with inventory:server:OpenInventory, also trigger inventory:client:SetCurrentStash with the same id, or use the RegisterStash export, which does both.
Stand at the back of the vehicle (the front for cars in Config.BackEngineVehicles), make sure the vehicle is unlocked, and check Config.OpenTrunkAll. Bicycles have no trunk.
With Config.IsVehicleOwned = true, only vehicles in owned_vehicles / player_vehicles keep their contents. If a script changes plates, it must call UpdateVehiclePlate(oldPlate, newPlate).
Drops are cleaned up after Config.DropRefreshTime (15 minutes) without activity.
The clothing tab needs Config.Clothing = true, the freemode male or female model, and the clothing items in your items file (on QBCore, in qb-core/shared/items.lua).
The clothing shop is not calling setInClothing(true) when its menu opens and setInClothing(false) when it closes. See Integrations.
The appearance resource saves the outfit. Make sure it starts before the inventory so it is detected, and that it is one of the supported ones.
That is intended: the inventory controls weapons through the hotbar. A script can return the wheel with exports['qs-inventory']:WeaponWheel(true).
Its quality reached 0 %. Repair it at a bench in Config.WeaponRepairPoints or with weapon_repairkit.
With Config.OneBulletPerAmmoItem = false (the default), each ammo item is a full magazine; with true, each item is a single round. Config.ForceToOnlyOneMagazine decides whether a reload tops up to one magazine or adds a full one. Adjust ammo prices and stack sizes to match.
Add it to Config.CustomWeapons with its components and attachment items, and make sure its name is identical in items, weapons and config.
The link must start with http:// or https:// and point straight at an image. The weapon must have an entry in Config.WeaponTints.
With Config.HideRestrictedShops = true, shops a player is not allowed to use have no blip and no prompt. Check requiredJob, requiredGrade and requiredGang, and that qs-shops starts after qs-inventory.
Products the player does not qualify for (job, grade, gang or licence) are hidden, and a shop with nothing left refuses to open. With Config.UseItemLicenses = true, licences such as weaponlicense must be items in the player's inventory.
Shops with useStock = true sell from a limited stock saved in qs-shops/json/shops-inventory.json. Delivery runs refill it, or turn useStock off for unlimited stock.
Config.DisableShopGenerationOnClient = true only allows shops created on the server. Create them with CreateShop and open them with OpenShop or the inventory:openShop event.
Still stuck? Open a ticket with the start of your server console (with
Config.Debug = true), your framework and its version, the list of resources started beforeqs-inventory, and a screenshot of the F8 console for anything about the interface.
