Studios
Loot Boxhouse-3.jpg

Troubleshooting

FreeLoot BoxQBCore · Qbox · ESX
PAGE 05 OF 07  ·  EXAMPLES → TROUBLESHOOTING → COMMANDS & EXPORTSdocs.glitchstudios.dev
Browse docs

Common issues#

The console says a crate item is not loaded#

Add the item to ox_inventory (see install/items.lua), restart ox_inventory, then restart the resource.

A reward never drops#

Its item is missing from ox_inventory, or it needs glitch-crafting and that resource is not running. Rewards like that are left out of the roll, with one warning per crate at start. If none of a crate's rewards exist, the crate is skipped.

Using the crate does nothing#

The crate item has a client.export or server.export in ox_inventory. Remove it. Also check the console for "could not register ... as a usable item", which means no supported framework was running when the resource started.

"Make some room in your inventory"#

Before a crate is taken the player must be able to carry every possible reward, so a full inventory cannot filter out bad rolls. Lower the amounts or the item weights, or ask the player to free space.

"You cannot open a crate right now"#

The player is dead, in last stand or cuffed. Set config.server.blockWhenIncapacitated = false to allow it.

Item images are blank#

Set config.ui.inventory.iconPath to your image folder, or add entries to iconOverrides.

The demo crates load instead of mine#

cratePack = 'auto' picks the demo pack when a resource named glitch-economy exists. Set config.server.cratePack = 'generic'.

The server warns about winnerIndex#

ui.winnerIndex must be between 12 and reelLength - 4. Until you fix it the server uses reelLength - 8.

Loot arrives late after a login#

Rolled loot that could not be delivered is kept in KVP and handed over after the character loads. Raise pendingTries if your players load in slowly.

Updating safely#

Back up your config/ folder, replace the other files, merge new keys, then restart ox_inventory and glitch-lootBox in that order.

Getting help#

Include the resource version, framework, reproduction steps and the server console lines that start with [glitch-lootBox] in a support ticket.