Client Side

Exports & Events

If you're looking for other data than listed here - feel free to contact us on our Discord Server!

These are the native op-clothing exports and events. The optional ped argument defaults to the local player when omitted.

OpenClothingShop

Opens a clothing shop by id.

exports['op-clothing']:OpenClothingShop(shopId)

---

OpenBarber

Opens a barber shop by id (alias: OpenBarberShop).

exports['op-clothing']:OpenBarber(shopId)

---

OpenTattooShop

Opens a tattoo shop by id.

exports['op-clothing']:OpenTattooShop(shopId)

---

OpenCharacterCreator

Opens the character creator. opts is optional.

exports['op-clothing']:OpenCharacterCreator({
    allowCancel = true,
    allowModelChange = true,
    onComplete = function(appearance)
        print('character created')
    end,
})

---

OpenWardrobe

Opens the free wardrobe (owned outfits + full catalog, no prices). opts is optional.

exports['op-clothing']:OpenWardrobe()

---

GetAppearance

Returns the ped's full appearance table.

local appearance = exports['op-clothing']:GetAppearance()

---

SetAppearance

Applies a full appearance table to the ped.

exports['op-clothing']:SetAppearance(appearance)

---

SetPedSkin

Applies a full appearance table (ped-first argument).

exports['op-clothing']:SetPedSkin(ped, appearance)

---

SetClothing

Applies only the clothing part of an appearance, keeping the face/hair.

exports['op-clothing']:SetClothing(appearance)

---

GetPlayerClothing

Returns a clothing-only payload (components + props), re-applicable through ApplyOutfit.

local outfit = exports['op-clothing']:GetPlayerClothing()

---

SetPlayerClothing

Merges a clothing-only payload onto the ped's current look.

exports['op-clothing']:SetPlayerClothing(clothing)

---

ApplyOutfit

Merges an outfit onto the ped's current look (keeps face, hair, heritage).

exports['op-clothing']:ApplyOutfit(outfit)

---

SaveAppearance

Persists the ped's current look to the database.

exports['op-clothing']:SaveAppearance()

---

ReloadAppearance

Re-pulls the saved look from the server and re-applies it (re-attaches tattoos/decorations).

exports['op-clothing']:ReloadAppearance()

---

IsMenuOpen

Returns a boolean - whether any op-clothing menu is currently open.

local isOpen = exports['op-clothing']:IsMenuOpen()

---

OpenJobLocker

Opens a job locker by its id.

exports['op-clothing']:OpenJobLocker(lockerId)

---

OpenJobLockerByJob

Opens the nearest accessible locker for the given job. Returns a boolean.

local opened = exports['op-clothing']:OpenJobLockerByJob('police')

---

Client Events

op-clothing:client:menuOpened

Fired whenever any clothing/barber/tattoo/creator menu becomes visible.

AddEventHandler('op-clothing:client:menuOpened', function(data)
    -- data = { mode, shopId, free }
end)

---

op-clothing:client:menuClosed

Fired whenever the menu is dismissed (confirm or cancel).

AddEventHandler('op-clothing:client:menuClosed', function(data)
    -- data = { mode }
end)

---

op-clothing:client:appearanceLoaded

Fired after the saved look is (re)applied on spawn or ReloadAppearance.

AddEventHandler('op-clothing:client:appearanceLoaded', function(appearance)
    -- Your Code
end)

---

op-clothing:client:characterCreated

Fired after the character creator finishes.

AddEventHandler('op-clothing:client:characterCreated', function(appearance)
    -- Your Code
end)

---

op-clothing:client:purchased

Fired after a successful clothing purchase.

AddEventHandler('op-clothing:client:purchased', function(data)
    -- data = { shopId, price }
end)

---

Triggerable client events

Drive op-clothing from another resource without grabbing the export reference.

TriggerEvent('op-clothing:client:openShop', shopId)
TriggerEvent('op-clothing:client:openWardrobe', opts)
TriggerEvent('op-clothing:client:openCharacterCreator', opts)
TriggerEvent('op-clothing:client:openJobLocker', lockerIdOrJob)
TriggerEvent('op-clothing:client:reloadAppearance')
TriggerEvent('op-clothing:client:saveAppearance')