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.