Studios
Card Albumshouse-3.jpg

Troubleshooting

SoonCard AlbumsQBCore · Qbox · ESX
PAGE 05 OF 06  ·  EXAMPLES → TROUBLESHOOTING → COMMANDS & EXPORTSdocs.glitchstudios.dev
Browse docs

Cards show as placeholders#

No artwork ships with the resource. Add one PNG per item, named after the item id, in ox_inventory/web/images, or point Config.ImageBase at a CDN. See Artwork.

A pack is consumed twice, or nothing happens when it is used#

The pack items must keep consume = 0 in ox_inventory/data/items.lua. Otherwise ox_inventory removes a pack before the export runs and the opener takes a second one. Copy the definitions from install/items.lua again if unsure.

Albums lose their cards in trades#

Album items must not be stackable. Album contents live in the item metadata, and trading an album trades its cards.

The new items do not exist#

Restart the server after copying install/items.lua into ox_inventory/data/items.lua, so ox_inventory picks up the items.

Packs open with glitch-lootBox odds, or the built-in opener refuses to run#

The built-in opener does not run while glitch-lootBox is started, so lootBox keeps its own odds and animations. Stop glitch-lootBox to use Config.FallbackOdds, or set Config.BuiltInPacks = false on purpose.

Loot Box version compatibility#

The current Loot Box source on this site does not register GetDropRates or GetMysteryItems. Albums protects those lookups with pcall, so do not assume live odds/mystery metadata is available with that version. The built-in pack opener refuses to run while glitch-lootBox is started. If combining them, configure card packs and rewards in Loot Box and use its usable-item flow; otherwise use Albums' supplied pack definitions with Loot Box stopped. Keep pack consume = 0.