Common Errors

This section lists the most frequent issues users may encounter during installation or setup, along with their causes and quick solutions. Review each point carefully before opening a support ticket — most problems can be fixed easily by following these steps.

---

Issues in illenium-appearance

If your character doesn’t spawn with the correct clothing or appearance when using illenium-appearance, follow these simple steps:

1. Open the fxmanifest.lua file inside your illenium-appearance folder.

2. Remove the following line if it exists:

   provides {esx_skin, skin_changer}

3. Check your other scripts and remove this line too if you find it:

   dependencies {esx_skin, skin_changer}

4. After making these changes, clear your server cache and restart the server.

This ensures the appearance system loads correctly with Quasar scripts.

Compatibility With esx_skin and skinchanger

If you’re using QBCORE, you can skip this step but If you’re using ESX, you need to do this to avoid errors.

Old systems like esx_skin or skinchanger can conflict with qs-appearance, so you have two options:

1. Remove them completely – Go through your server files and delete any references to esx_skin or skinchanger inside your fxmanifest.lua files.

2. Redirect them – Open the file qs-appearance/fxmanifest.lua and add this line at the end:

   provides { "esx_skin", "skinchanger" }

This makes qs-appearance act as a replacement for those old systems, fixing any dependency issues automatically.

How to Add Starter Items?

Remember that if there are problems or incompatibilities with your inventory, you will need to disable this configuration, since the plan is not to have it as a mandatory but optional feature.

This system includes a configuration for starter items, which will allow several different items to be added to the player's spawn. Read the following comments if you have questions.

This setting is completely basic, but if you want to remove it you can simply change it to the following Config.StarterItems = {} or comment inside. Below we will leave the default configuration to better understand your configuration.

Config.StarterItems = {
    { item = 'phone', amount = 1 },
}