Quick Clothing

Comandos, exports e events para roupas rápidas, sleeves/collar e radial menus.

Quick Clothing serve para mudanças temporárias de gameplay: tirar o chapéu, abrir a gola, enrolar a manga, remover o coat e colocar de volta depois.

Ele não reescreve o outfit salvo.

​

Ações disponíveis

hat
mask
eyewear
shirt
vest
coat
gloves
pants
boots
chaps
sleeves
collar

As dez primeiras são visibilidade. sleeves e collar são transforms e dependem do wearable state real exposto pela peça MP atual.

​

Commands

/hat /mask /eyewear /shirt /vest /coat
/gloves /pants /boots /chaps /sleeves /collar

Radial simples pode usar:

ExecuteCommand('hat')

Mas export é melhor quando você precisa saber se funcionou.

​

Client exports

local ok, reason = exports['rco-appearance']:ToggleClothing('hat')
local ok, reason = exports['rco-appearance']:SetClothingVisible('coat', false)

local ok, reason = exports['rco-appearance']:ToggleSleeves()
local ok, reason = exports['rco-appearance']:SetSleeves('rolled')

local ok, reason = exports['rco-appearance']:ToggleCollar()
local ok, reason = exports['rco-appearance']:SetCollar('open')

local ok, reason = exports['rco-appearance']:ResetClothingToggles()
local state = exports['rco-appearance']:GetClothingToggleState()
local visible = exports['rco-appearance']:IsClothingVisible('hat')

Sleeves:

exports['rco-appearance']:SetSleeves('rolled')
exports['rco-appearance']:SetSleeves('full')

Collar:

exports['rco-appearance']:SetCollar('open')
exports['rco-appearance']:SetCollar('closed')

​

Local client events

TriggerEvent('rco-appearance:client:ToggleClothing', 'hat')
TriggerEvent('rco-appearance:client:SetClothingVisible', 'hat', false)
TriggerEvent('rco-appearance:client:ToggleSleeves')
TriggerEvent('rco-appearance:client:SetSleeves', 'rolled')
TriggerEvent('rco-appearance:client:ToggleCollar')
TriggerEvent('rco-appearance:client:SetCollar', 'open')
TriggerEvent('rco-appearance:client:ResetClothingToggles')

São events locais, não network events.

​

Server exports

local state = exports['rco-appearance']:GetPlayerClothingToggleState(source)
local ok, reason = exports['rco-appearance']:SetPlayerClothingVisible(source, 'hat', false)
local ok, reason = exports['rco-appearance']:TogglePlayerClothing(source, 'coat')
local ok, reason = exports['rco-appearance']:SetPlayerClothingTransform(source, 'sleeves', 'rolled')
local ok, reason = exports['rco-appearance']:ResetPlayerClothingToggles(source)

​

Por que algumas ações são bloqueadas

O resolver é conservador. Se tirar uma peça pode quebrar a composição, o RCO retorna um motivo em vez de destruir o visual.

Motivos comuns:

invalid_category
invalid_argument
no_component
blocked_by_coat
blocked_by_vest
blocked_by_boots
blocked_by_chaps
blocked_by_gauntlets
blocked_by_spats
blocked_by_spurs
unsupported
unsupported_npc_clothing
unknown_body_state
editor_open
dead
busy
superseded
rollback_failed

​

NPC clothing

Toggles de visibilidade passam pelo pipeline NPC do RCO. sleeves/collar não são inventados para uma mesh NPC que não possui esse conceito; nesses casos o retorno pode ser unsupported_npc_clothing.

​

Tailor, wardrobe e /reloadskin

Ao abrir editor, o RCO trabalha sobre a aparência base real. Depois do Save/Cancel, o estado Quick Clothing é revalidado e reaplicado quando ainda faz sentido.

Se uma nova shirt não suporta mais rolled, só esse transform é limpo.

​

OneSync

O State Bag replica intenção semântica, não snapshots/shop hashes completos:

{
    hidden = { hat = true, coat = true },
    transforms = { sleeves = 'rolled', collar = 'open' }
}

Isso evita scan de players por frame e evita restaurar hash velho de outro player depois que ele troca de roupa.