Quasar Store Logo

Installation

Installation guide — please follow each step carefully and exactly as described to ensure the script works correctly on your server. Skipping or modifying steps may cause the system to not function properly, so follow it step by step.

Download Script

To download the assets needed for this script, you must access the official Cfx.re portal, where all assets purchased through Tebex are managed.

1

Access the Granted Assets Page

Open the Cfx.re granted assets page: https://portal.cfx.re/assets/granted-assets.

This page contains all assets linked to your Cfx.re purchases.

2

Log In with Your Cfx.re Account

Sign in using the same Cfx.re account you used when purchasing the asset.

If you use a different account, the assets will not appear.

3

Download the Housing Assets

In the granted assets list, locate and download:

Appearance

These two packages are required to install the full housing system.

These files include the models, materials, and visual resources required for the proper operation of the housing system.





Download Dependencies

This script requires some mandatory dependencies to function correctly. Make sure to download and extract them inside your server’s main directory, keeping their original folder structure intact.





Remove Other Scripts

This script may cause conflicts or errors if you use other clothing or appearance systems on your server.Common examples include, common examples include: esx_skin, skinchanger, fivem-appearance, esx_barbershop, esx_clotheshop, illenium-appearance, and rcore_clothing.

It’s strongly recommended to completely remove these resources before installation to ensure proper functionality and prevent compatibility issues. Also, delete any tattoo shop resources such as esx_tattooshop from your server’s resources folder.





Database Setup

Avoid using tools like XAMPP or other non-optimized local servers, as they may cause connection errors.

This script includes an essential database required for its operation.You must import it before starting your server, preferably using HeidiSQL or any other manager compatible with MariaDB/MySQL.

ESX/QB





Saving Clothing Images and Token

When you finish generating and saving clothing images, you must disable the option:

Config.ImageSaver.enable = false

If you leave it enabled, your FiveManage token could be exposed and players may steal it.

Your token must be placed here:

-- qs-appearance/config/fivemanage.lua Config.FiveManageToken = "your_token_here"

Always make sure to keep your token private and disable the image saver once the process is complete.





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.