Skin Migration System

If you are already using illenium-appearance, no migration is necessary — qs-appearance is automatically compatible with it and will take over without any extra steps.

If your server previously used clothing systems like qb-clothing, esx_skin, or fivem-appearance, you can easily migrate existing player skins to work with qs-appearance using the built-in /migrateskins command. This ensures your player base retains their character look without needing to recreate it from scratch.

---

How to Use the Migration Command

This command should be executed only once after switching systems. After migration, make sure to remove or disable the old clothing scripts to prevent data conflicts.

To convert existing skin data from older systems, simply use the following command in-game:

/migrateskins

This will scan your player database and convert all stored appearance data from the following supported systems:

1

qb-clothing

2

esx_skin

3

fivem-appearance

All migrated skins will then be stored in the format used by qs-appearance, allowing a seamless transition for your players.

---

How to Use the Outfit Migration Command

Important: The /migrateoutfits command is only compatible with servers that previously used illenium-appearance. If you were using other systems, this command will not apply.

If you are switching from illenium-appearance and previously used its outfit system (saved presets), you can transfer all outfits seamlessly using the built-in /migrateoutfits command.

This migration is optional and intended for those who wish to retain previously saved outfits under the new qs-appearance system.

To migrate, simply execute the following command in-game:

/migrateoutfits

This will detect and convert all outfits saved under the illenium-appearance format into the qs-appearance compatible structure. Once complete, players will be able to access their old outfits from the wardrobe menu as usual.