Installation

Requirements

• A FiveM server running one of: ESX Legacy, QB-Core, or Ox Core
• ox_lib 
• oxmysql 

Steps

1. Download and extract to your server’s resources folder
2. Import the SQL files from the sql/ directory into your database:

-- Required tables
sql/playerskins.sql          -- Appearance data (QB-Core / Ox Core)
sql/player_outfits.sql       -- Saved player outfits
sql/player_outfit_codes.sql  -- Outfit sharing codes
sql/management_outfits.sql   -- Boss-managed job/gang outfits

Note: ESX uses the existing users table (skin column) instead of playerskins.

3. Add to your server.cfg:

ensure ox_lib
ensure oxmysql
ensure illenium-appearance

4. Configure shared/config.lua to match your server setup
5. Restart your server

Migration

From esx_skin

The resource includes automatic migration from esx_skin. On first load, it will convert existing skin data from the users table to the illenium-appearance format.

From qb-clothing

QB-Core migration is handled via the illenium-appearance:server:migrate-qb-clothing event. This converts qb-clothing skin data to the illenium-appearance format in the playerskins table.

From fivem-appearance

If you’re migrating from the original fivem-appearance or aj-fivem-appearance, the data format is compatible. Player skins should work without migration.