Troubleshooting

"Resource name must be 'LyraShops'"

The folder was renamed. Rename it back to LyraShops (or LyraAdminShops).

"Config.Framework is "esx" but es_extended is not running"

Start es_extended before Lyra Shops, or set the right framework in both configs.

The admin panel says "You do not have permission"

• QB / QBox: give yourself the permission in Config.AdminPermission (default admin).
• ESX: your group must be admin or superadmin.
• Or allow the ACE command for your identifier.

"Illegal mix of collations" in the console

Your player_stores and players / users tables use different collations. The current version never compares those tables directly. If you still see it, update to the latest release.

Products don't show in the shop

• The item doesn't exist in your inventory's item list. Check the spelling in Config.DefaultProducts or Wholesale.Products.
• The product is out of stock. Products with 0 stock are hidden.

Item images are missing

Check Config.ImagesDirectory for your inventory, and that a .png with the item's name exists there.

Employees show an avatar instead of a photo

• MugShotBase64 isn't running. Start it before LyraShops.
• The player hasn't joined since they were hired. Their photo is taken the next time they log in or open the store.

The store safe doesn't open

Check that Config.Inventory matches your inventory: 'ox_inventory' or 'qb-inventory'. On an old event-based qb-inventory use 'qb-inventory-old'.

Wholesale says access denied

Only the owner and staff with WholesaleAccess can use wholesale. Make sure the player is hired in a store.

The crate can't be used

The item from Wholesale.BoxItemName isn't in your inventory's item list. See Wholesale.

The truck doesn't spawn

Set the truck point first: Store Management → Locations → Truck.