Skip to Content
ZH AppearanceFunctionsClient

Client Functions & Exports

Client-side exports provided by zh_appearance.

OpenAppearance

Opens the appearance customization UI.

exports.zh_appearance:OpenAppearance(config, cb)
  • config?: table
    • label?: string - UI Title label
    • tabs?: AppearanceTab[] - Array of visible tabs ('heritage', 'features', 'hair', 'skin', 'clothing', 'props', 'tattoos')
  • cb?: function(appearance) - Callback invoked when menu closes (returns AppearanceData if saved, nil if cancelled)

OpenShop

Opens a pre-configured shop type.

exports.zh_appearance:OpenShop(shop)
  • shop: string | ShopTypeConfig - Shop type name (e.g. 'clothing', 'barber', 'tattoo', 'surgeon', 'mask') or custom shop type config table.

GetAppearance

Returns the current character appearance data.

local appearance = exports.zh_appearance:GetAppearance()

SetAppearance

Applies complete appearance data to the player.

exports.zh_appearance:SetAppearance(appearanceData)

SetModel

Changes the player ped model.

local success = exports.zh_appearance:SetModel(model)
  • model: string | number - Model name (e.g. 'mp_m_freemode_01') or model hash.
  • Returns: boolean

Component & Prop Exports

-- Get / Set single component local component = exports.zh_appearance:SetComponent(componentId, drawable, texture) local components = exports.zh_appearance:GetComponents() exports.zh_appearance:SetComponents(components) -- Get / Set single prop local prop = exports.zh_appearance:SetProp(propId, drawable, texture) local props = exports.zh_appearance:GetProps() exports.zh_appearance:SetProps(props)

Face & Head Overlays Exports

-- Head Blend local blend = exports.zh_appearance:GetHeadBlend() exports.zh_appearance:SetHeadBlend(blend) -- Face Features local features = exports.zh_appearance:GetFaceFeatures() exports.zh_appearance:SetFaceFeatures(features) -- Head Overlays & Colors local overlays = exports.zh_appearance:GetHeadOverlays() exports.zh_appearance:SetHeadOverlays(overlays) exports.zh_appearance:SetHairColor(color, highlight) exports.zh_appearance:SetEyeColor(eyeColor)

Tattoo Exports

local tattoos = exports.zh_appearance:GetTattoos() exports.zh_appearance:SetTattoos(tattoos)
Last updated on