Appearance & Tattoo Scripts

Config.AppearanceSystem = 'auto'
Config.TattooSystem     = 'auto'

#Appearance scripts

#illenium-appearance

The most complete integration: face editor for the implant, save hooks, outfit-change notices, a server-side read of the stored appearance, and tattoos.

Pin v5.7.0 or newer. Because illenium provides the esx_skin and skinchanger names, 'auto' checks it first — otherwise an illenium server would resolve to esx_skin and lose the face editor.

#17mov Character System

Its Skin module replaces the appearance scripts unless Skin.Enabled = false.

#qs-appearance

We use its illenium-style exports, and we never call its own OpenSurgeonShop — that has its own price and its own flow, which would bypass Config.Implant.Price, the cooldown and the identity reset entirely.

#tgiann-clothing

Its Wear and UnWear calls fire no event we can listen to. That is fine: every player's own look is re-read every 1.5 seconds (Config.Performance.SelfPollMs), so the change is noticed anyway. The only cost is up to 1.5 seconds of delay before an outfit change is reflected.

#fivem-appearance

Unmaintained since 2023 and widely forked. The save event name differs between forks, so the instant outfit-change notice may not fire on yours; the 1.5-second re-read still catches the change. Everything else works.

#qb-clothing

Works for outfit-change notices and the saved appearance. It has no face-only editor, so the implant clinic falls back to Config.Implant.NoEditorPolicy — 'skip' by default: new identity, new name, same face.

#esx_skin / skinchanger

A restricted face menu is opened for the implant. Keys are the flat users.skin shape.

#Tattoo sources

rcore_tattoos and illenium tattoos can coexist on the same ped; the bridge reads whichever one is selected, and the natives fallback still runs underneath.

#What the tattoo cue actually uses

Tattoos only count while their body zone is visible right now:

Turn a zone off entirely in Config.Tattoos.Zones. See Face Coverage, Clothing & Tattoos.

#Overlays you do not want counted

Config.Tattoos.IgnoreHairFades = true
Config.Tattoos.BlockOverlays = {
    -- { collection = 'mpbeach_overlays', overlay = 'FM_Hair_Fuzz' },
}

Hair shops add fade "tattoos" that nobody would describe as a tattoo. They are ignored by default. Add any other overlay your server uses as a badge or decal.

#Outfit-change notices

Where the appearance script tells us an outfit was saved, the script picks up the new look at once — useful because a changed outfit is exactly what breaks other people's memory of them.

Where it does not, the 1.5-second re-read picks the change up anyway; it is just up to 1.5 seconds later. Nothing is shown to the player either way.

#The face editor and the implant

With no usable editor, Config.Implant.NoEditorPolicy decides: 'skip' (new identity and name, face unchanged) or 'block' (the clinic refuses).

See Face Implant & Clinics.

#Non-freemode peds

Players on a ped-menu or addon model are handled by Config.NonFreemode, not by the appearance bridge:

Per-model overrides: Config.NonFreemode.Overrides['a_c_chop'] = 'unrecognizable'.

#Custom

Set Config.AppearanceSystem = 'custom' (or Config.TattooSystem = 'custom') and fill the branch in bridge/appearance_client.lua / bridge/appearance_server.lua.

See Writing a Custom Adapter.