> ## Documentation Index
> Fetch the complete documentation index at: https://rust-co.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Checklist prático para problemas de aparência, roupas, wardrobe e migração.

Ligue `Config.Debug = true` só enquanto reproduz **uma sequência exata**. Depois desligue.

## Resource não inicia

Confirme ordem `core → rco-appearance → rco-creator` e verifique se algum resource stock substituído ainda está rodando.

## Aparência errada ao logar

Primeiro teste:

```text theme={"dark"}
/reloadskin
```

Se a aparência correta volta, o snapshot provavelmente está certo e algum script alterou o visual depois.

Se volta errado de novo, investigue persistência/migração e se algum resource antigo ainda grava tabelas legacy.

## Salva, mas relog desfaz

Quase sempre existe outra fonte de verdade ainda ativa. Barber/clothing antigo salvando em `playerskins`/VORP legacy não deve competir com `rco_appearance`.

## Quick Clothing recusa

Leia o `reason`. `blocked_by_coat`, `blocked_by_vest`, `unsupported_npc_clothing` etc. significam que o RCO preferiu não quebrar a composição.

## Sleeves/collar não muda

A roupa MP atual precisa expor wearable state compatível. NPC clothing e algumas shirts MP simplesmente não possuem aquele transform.

## Wardrobe de hotel abre mas não salva

Abra pelo **server**:

```lua theme={"dark"}
exports['rco-appearance']:OpenWardrobe(source)
```

Client não pode autorizar uma sessão persistente por conta própria.

## Noclip fica visível após reload

O RCO preserva visibility/alpha externos durante appearance apply. Se ainda acontecer com um noclip custom, informe qual resource e quais natives ele usa.

## Migração ficou errada

Confirme primeiro se a origem era stock suportada. Appearance de terceiros precisa de conversão específica.

## Ticket útil

Envie framework, personagem novo/migrado, sequência exata, F8, console server, resultado do `/reloadskin` e nomes de scripts externos envolvidos.
