# Troubleshooting

Fixes for the problems people actually hit, roughly in the order they show up.

## Scripts calling `exports['illenium-appearance']` error out

The folder is not named `illenium-appearance`. Exports are registered under the folder name.
Rename the folder, or change every export call to the new name.

## Players hang on the loading screen after a restart (ESX)

The resource `provide`s `esx_skin`, so FiveM stops `esx_multicharacter` whenever it restarts.
Koja Appearance starts it again one second later. If the console says it could not, run `ensure esx_multicharacter`.

## The UI is blank

- You changed `web/src`: run `pnpm build` in `web/`, then restart the resource.
- `web/dist` is missing or incomplete: download the archive again.

## Tiles show `?`

- The item has not been captured yet. Capture it in the [Capture panel](/new/appearance/capture-panel).
- Folder mode: the resource was not restarted after capturing. FiveM only serves files that existed when it started.

## The Admin Panel button is missing

- `Config.Koja.Capture.Enabled` is `false`.
- You do not have the ace in `Config.Koja.Capture.AdminGroup` and your framework group is not in `FrameworkGroups`.
- `add_ace resource.illenium-appearance command.add_ace allow` is missing, so the resource could not grant the ace to the group.

## Capture fails, or shots are black or empty

- `screenshot-basic` is not started, or its name does not match `Config.Koja.Capture.ScreenshotResource`.
- You are not on a freemode ped or a ped from `Config.Koja.Capture.Models`.
- Images are blurry or half loaded: raise `SettleMs` and `TextureSettleMs`.

## The Fivemanage key is refused

Use a key from the **Media** product with upload access, and check that the server can reach `api.fivemanage.com`.

## Everything is FREE, or prices are ignored

Items without a saved price use the auto price of their category, then `Config.Koja.Shop.DefaultPrice` (`0` by default).
Check `Config.Koja.Shop.AutoPrices.Enabled` and its `Categories`, or set prices in the Capture panel.

## Players are not charged in clothing shops

With `Config.Koja.Shop.Basket = true` players pay per item in the basket, and the flat `Config.ClothingCost` is not charged.
Set `Basket = false` to go back to the flat price.

## No clerk in the shop, or the old store zones are gone

With `Config.Koja.Shops.Enabled = true` the clerks of `shared/koja_shops.lua` replace `Config.Stores`.
Clerks spawn only within `SpawnDistance`. Use `/shopped` to move a clerk that stands in the wrong place.
Set `Enabled = false` to use your `Config.Stores` again.

## The ox_lib menus are back instead of the wardrobe hub

`Config.Koja.Hub.Enabled` is `false`.

## The clothing item does nothing

- The item `client.export` must use your folder name: `illenium-appearance.useClothing`.
- The item gender must match the player's freemode ped.
- `Config.Koja.ClothingItems.Enabled` must be `true` for bought pieces to be given as items.

:::hint{type="info" title="Need help?"}
Ask on the Discord server: [discord.gg/hexelstore](https://discord.gg/hexelstore).
:::