API & events

API pública do RCO Appearance, com lado correto e regras de persistência.

A regra principal é: estar visível no ped não significa estar salvo no personagem.

Client APIs servem para visual/preview. Editor persistente e gravação precisam de autorização server-side.

​

Abrir editor persistente

​

Server: OpenEditor(source, options)

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

​

Server: OpenWardrobe(source, options?)

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

É a integração indicada para houses/hotels/camps. Veja Wardrobe integrations.

​

Client: editor persistente

O client não pode autorizar a própria sessão de save. A chamada persistente direta retorna:

false, 'server_authorization_required'

​

Aparência visual

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

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

ApplyAppearance altera o visual; não é save de banco.

GetAppearance lê o ped naquele momento, que pode estar em preview ou estado transitório. Não trate captura live como snapshot canônico sem saber o que está fazendo.

​

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.

​

Quick Clothing

Client:

exports['rco-appearance']:ToggleClothing('hat')
exports['rco-appearance']:SetClothingVisible('coat', false)
exports['rco-appearance']:SetSleeves('rolled')
exports['rco-appearance']:SetCollar('open')

Server:

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

Contrato completo: Quick Clothing.

​

Compatibilidade framework

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

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

para ter o mesmo contrato em RSG e VORP.