Troubleshooting & FAQ

Start with the server console. When the resource starts, it says which framework it found, which tables are missing, and which config values it had to fix. See What the console says.

Opening the menu

Problem	Why, and what to do
"You can't open the menu right now."	The player is dead, downed, cuffed or falling, or your own Config.CanOpenMenu rule said no.
"Go to a shop on the map to open the menu."	Opening a shop by command is for admins. Config.CommandsForEveryone = true lets everyone.
"Close the admin panel before opening the menu."	The panel and the menu can't be open at the same time.
The panel says it's only for admins	Add add_ace group.admin zaiders_appearance.admin allow to server.cfg, and make sure your account is in that group. See Commands & permissions.
Pressing E at a shop does nothing	Stand inside its radius: the key on the sign lights up when E works. Check the shop exists in the panel's Shops, and that Config.Shops.key is 38 (E).
Two clothing menus open at once	Your previous clothing menu is still running. Remove its ensure.

Saving and paying

Problem	Why, and what to do
Nothing is charged or saved	The framework wasn't found. The console says framework: none. Start your framework before ZAIDERS Appearance, or set Config.Framework.
Nothing is saved, and the console mentions oxmysql	Add ensure oxmysql before the resource.
ESX: looks aren't saved	The users table has no skin column. Run the ALTER TABLE the console shows.
"Some garments are out of stock: remove them"	An admin is trying on an out-of-stock garment. Remove it from the cart, or put it back in stock with a right click.
A purchase says it's still being saved	The database is slow, often because of a backup. The money only comes back if the save really fails, and the player is told.

Clothes and photos

Problem	Why, and what to do
Garments show a drawing instead of a photo	No photo has been taken for them yet. Take them in the panel. See Catalog photos.
New photos don't show to players	Run ensure zaiders_fotos after taking photos.
Catalog photos says the photos resource is missing	Copy zaiders_fotos to resources and ensure it before zaiders_appearance.
Some photos came out black or a single color	The game wasn't visible while they were taken. Use Delete the broken ones in the panel, or zappearance_limpiar_fotos, then take them again with the game in front.
A player's clothes look wrong or invisible	/zappearance reloadskin puts the saved clothes on again.
Garments changed after adding or removing a pack	FiveM numbers clothing in start order. Restart the whole server (never a single pack), then join once with an admin. See Clothing IDs & Outfit Shifts.
A garment shows the wrong photo after repacking	Repacking changes a pack's numbers. Take that pack's photos again.

Character creator

Problem	Why, and what to do
It doesn't open for a new character	Your multicharacter fires a different event. Add it to Config.Creator.events.
It doesn't open, and another clothing menu runs	A resource in Config.Creator.skipIfStarted is running, so that one handles new characters.
ESX: esx_skin's menu opens instead	That's expected with esx_skin running (esx_multicharacter needs it). Without a multicharacter, you can stop esx_skin and skinchanger.
The clothing store opened instead of the creator	That character already has a look. The creator is only for new characters.
Esc doesn't leave the creator	A new character leaves by finishing it: Finish character.

HUD, shops and tattoos

Problem	Why, and what to do
The server's HUD shows over the menu	Add your HUD to Config.HideHud.resources with its export or event, or use Config.HideHud.custom. See Config reference.
No blips on the map	Config.Shops.blips = false, or the kind's blips are off in the panel's Map blips.
The big map lists the blips under another script's names	Another script uses blip categories 121 to 124. Set Config.Shops.blipLegend to another number, or false.
"Tattoos on this server are handled by another resource."	A resource from Config.Tattoos.owners is running, so the tattoo shop turned itself off.
"The tattoo shop is turned off on this server."	Config.Tattoos.enabled = false.
"The barber shop is only for freemode characters."	The player is wearing a ped. They can switch to Male or Female in Peds.

Peds

Problem	Why, and what to do
The ped shop is empty	Check Config.PedShop.enabled and the categories in the panel's Peds → Sale. An admin's F8 console has a "ped shop" line saying how many peds it found and why.
A ped is missing from the shop	It's from a newer GTA update than your server's game build, or its category isn't sold.
"Someone else already bought this ped"	One ped, one owner is on, and that ped has its owner.
A ped code doesn't work	It was already redeemed or voided, codes are off (Sale → Redeem codes), or the ped already has its one owner. Codes are typed as they were given, such as M4KQ-2TZB.

Language and config

Problem	Why, and what to do
The console lists config values it fixed	A value in config.lua is missing or written wrong. The menu works anyway. Correct the lines it names. See How the config is checked.
Texts show in English though Config.Locale is another language	That language's file is missing or broken. A missing quote or comma breaks the whole file. Check it with a JSON validator.
You changed Config.Locale and some shop names didn't change	Names you wrote yourself are kept. Only the names the game or the panel gave are translated.

Escrow

Problem	Why, and what to do
You lack the required entitlement	The server's license key isn't from the Cfx.re account that bought ZAIDERS Appearance. See Asset Escrow & Clothing.

Still stuck?

Gather the console lines that start with [zaiders_appearance], your framework and its version, and what you did right before the problem. Then open a ticket. Never send license keys or passwords.

If the game crashes with clothing, the cause is usually your clothing packs, not the menu. Start with Crash Diagnosis.