API & events

Integrações públicas do RCO Appearance para editor, aparência, roupas, dress/undress, wardrobe e Quick Clothing.

A regra principal é simples:

Estar visível no ped não significa automaticamente estar salvo no personagem.

Use APIs client para estado visual/gameplay. Para editor ou aparência persistente, use as APIs autorizadas no server.

​

Abrir editor persistente

​

Server: OpenEditor(source, options)

local ok = exports['rco-appearance']:OpenEditor(source, {
    mode = 'barber', -- creator | clothing | barber | tattoo | wardrobe
})

Use a partir de código server-side confiável.

​

Server: OpenWardrobe(source, options?)

local ok = exports['rco-appearance']:OpenWardrobe(source)

Integração indicada para houses, hotels, camps e properties. Veja Wardrobe integrations.

​

Client: OpenEditor / OpenWardrobe persistente

O client não pode conceder a própria autorização de save. Chamadas client persistentes retornam:

false, 'server_authorization_required'

Para um editor propositalmente local/visual:

local ok = exports['rco-appearance']:OpenEditorLocal({ mode = 'clothing' })

​

Aparência visual

exports['rco-appearance']:ApplyAppearance(snapshot)
exports['rco-appearance']:ApplyAppearance(ped, snapshot)

local snapshot = exports['rco-appearance']:GetAppearance(ped)

ApplyAppearance aplica visualmente. Não é save de banco.

GetAppearance captura o visual atual, que pode estar em preview ou estado transitório.

​

Reload

Client:

exports['rco-appearance']:ReloadAppearance()

Server:

exports['rco-appearance']:ReloadAppearance(source)

Os dois caminhos pedem a aparência RCO salva do personagem.

​

Helpers diretos de roupa

local item = exports['rco-appearance']:GetEquipped('hats')

local ok, reason = exports['rco-appearance']:EquipCategory('hats', itemData)
local ok, reason = exports['rco-appearance']:UnequipCategory('hats')

São helpers do ped live. Para toggle temporário com sync/reapply, prefira Quick Clothing.

​

Dress / Undress

Para medical, bathing, prison, hotel ou outro gameplay que precisa tirar a roupa inteira:

local ok, reason = exports['rco-appearance']:Undress()
local ok, reason = exports['rco-appearance']:Dress()

Ou:

exports['rco-appearance']:SetUndressed(true)
exports['rco-appearance']:SetUndressed(false)

Comportamento:

• Undress() remove as roupas do ped visualmente;
• Dress() pede novamente a aparência salva ao server;
• ficar temporariamente sem roupa não sobrescreve o snapshot salvo;
• um estado Quick Clothing compatível pode ser reaplicado depois que a aparência base voltar.

Para tirar só hat, coat, gunbelt, holsters etc., use Quick Clothing. Para remover a roupa do personagem como um todo, use Undress / Dress.

​

Estado do editor

local open = exports['rco-appearance']:IsEditorOpen()

​

Persistência por personagem

exports['rco-appearance']:GetAppearanceForCharacter(charId, function(snapshot, err)
    -- snapshot canônico salvo
end)

exports['rco-appearance']:SetAppearanceForCharacter(charId, snapshot, function(ok, err)
    -- espere o callback antes de assumir que salvou
end)

charId deve ser tratado como identificador opaco do framework.

​

Outfits

exports['rco-appearance']:ListOutfits(source, function(outfits, err)
    -- outfits salvos do personagem ativo
end)

Para houses/hotels, normalmente é mais simples abrir o wardrobe nativo do RCO.

​

Quick Clothing

exports['rco-appearance']:ToggleClothing('hat')
exports['rco-appearance']:ToggleClothing('holsters')
exports['rco-appearance']:SetClothingVisible('coat', false)

exports['rco-appearance']:ToggleSleeves()
exports['rco-appearance']:SetSleeves('rolled')
exports['rco-appearance']:ToggleCollar()
exports['rco-appearance']:SetCollar('open')
exports['rco-appearance']:TogglePantsTuck()
exports['rco-appearance']:SetPantsTucked(true)

exports['rco-appearance']:ToggleGunBelt()
exports['rco-appearance']:ToggleClosedCoat()

ToggleGunBelt() é um helper para gunbelt.

Para gun holsters use a categoria genérica:

exports['rco-appearance']:ToggleClothing('holsters')

ToggleClosedCoat() é alias do grupo lógico coat, que inclui as variações open/closed e acessórios de coat controlados pelo RCO.

Server:

exports['rco-appearance']:SetPlayerClothingVisible(source, 'hat', false)
exports['rco-appearance']:TogglePlayerClothing(source, 'holsters')
exports['rco-appearance']:SetPlayerClothingTransform(source, 'sleeves', 'rolled')
exports['rco-appearance']:ResetPlayerClothingToggles(source)

Contrato completo: Quick Clothing.

​

Compatibilidade framework

O RCO mantém aliases/shims conhecidos onde existe equivalente seguro, mas resources novos devem preferir:

exports['rco-appearance']:...

para manter o mesmo contrato entre RSG e VORP.