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 provides 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.
• 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.