Studios
Appearancehouse-3.jpg

Troubleshooting

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

Barber or tattoo changes are lost after paying#

The player has to be within Config.ShopCheckRadius of a shop of that type in Config.Stores when they pay. A shop placed far from its coords or points fails that check, and the player sees "You need to be in the shop to pay".

A ped picked in the ped menu is not saved#

The ped menu needs a grant on the server. /pedmenu gives one. A script that opens the ped menu has to call exports['glitch-appearance']:GrantPedMenu(src) first. The server console prints why a save was refused.

Job clothing disappears from a saved look#

Config.ServerClothingLocks put back an item the player may not wear under Config.CollectionLocks or a department tag. Check the rule's jobs and gangs, or set Config.ServerClothingLocks = false if your server hands job clothing around as items on purpose. With Config.Debug = true the console counts the items it put back.

No prompt appears in a shop#

Check that Config.UseTarget is false for walk-in shops and that the shop key is bound in the FiveM key bindings (default Config.ShopKey). With Config.Debug = true the zones are drawn.

Players can be hurt in the menu#

With glitch-poolcleaning running, the server only allows invincibility at this resource's shops and rooms, in the character creator and in the ped menu. If players change at a locker another script provides, add that place to Config.Stores, Config.ClothingRooms or Config.PlayerOutfitRooms. The exception ends when the player moves away, gets in a vehicle, or deals or takes damage.

The character creator clashes with multicharacter buckets#

The creator uses routing bucket Config.CreatorBucketBase + server id, and the default base is 0. Many multicharacter resources also put each player in the bucket of their server id. Move the base to a range nothing else uses, for example Config.CreatorBucketBase = 5000.

The console says data/clothing-registry.json does not match the streamed clothing#

A clothing pack changed since the registry was built. Run node tools/clothing-registry.js and restart, or set Config.ClothingIdents.Enabled = false. Saved outfits are not changed either way.

Clothing photos do not show#

Config.ThumbnailUrl must point at your own photo store. Set it to false to show numbered tiles.

Scripts that need illenium-appearance do not start#

glitch-appearance provides the illenium-appearance name. Remove illenium-appearance itself, and start glitch-appearance before the scripts that depend on it.

Known limits#

  • The clothing shop fee cannot be enforced, because clothes may be saved from anywhere. A modified client can save new clothes without visiting a shop.
  • On ox_core, job and gang data is not read: job and gang locked items stay locked and boss outfits are off.
  • Addon items saved by drawable number only (clothing idents off) are locked in the menu, not on the server.