> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rktscripts.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Soluções para problemas comuns

## Problemas Comuns

<AccordionGroup>
  <Accordion title="UI não abre ao digitar /skins" icon="window">
    **Possíveis causas:**

    1. **ox\_lib não iniciado**: Verifique se `ox_lib` está no `server.cfg` antes do `rkt_skins`
    2. **Comando desabilitado**: Verifique `Config.EnableCommand = true` no `config.lua`
    3. **Nome do comando diferente**: Verifique `Config.CommandName` no `config.lua`

    **Solução:**

    ```cfg theme={null}
    ensure ox_lib
    ensure oxmysql
    ensure rkt_skins
    ```
  </Accordion>

  <Accordion title="Erro: Bridge.Framework is nil" icon="cube">
    **Causa:** Framework não foi carregado corretamente.

    **Solução:**

    1. Verifique se `BridgeConfig.Framework` está correto em `bridge/config.lua`
    2. Para QBCore: verifique se o export `rkt_core:GetCoreObject` existe
    3. Para Qbox: verifique se o export `qbx_core:GetCoreObject` existe
  </Accordion>

  <Accordion title="Imagens não aparecem" icon="image">
    **Possíveis causas:**

    1. **Link quebrado**: Links do Discord expiram após um tempo
    2. **CORS bloqueado**: Provedor de imagem não permite requests externos

    **Solução:**
    Use o conversor automático do painel admin ou hospede as imagens no Fivemerr/Fivemanage.
  </Accordion>

  <Accordion title="Skins não salvam no banco" icon="database">
    **Possíveis causas:**

    1. **oxmysql não iniciado**: Verifique no `server.cfg`
    2. **Tabelas não criadas**: Execute o `database.sql`
    3. **Permissões do banco**: Verifique credenciais no `server.cfg`

    **Verificação:**

    ```sql theme={null}
    SHOW TABLES LIKE 'rkt%';
    ```
  </Accordion>

  <Accordion title="Jogador não consegue comprar skins" icon="credit-card">
    **Possíveis causas:**

    1. **Sem dinheiro suficiente**: Verifique saldo do jogador
    2. **Bridge incorreto**: Framework não retornando dados corretamente
    3. **Estoque zerado**: Skin sem estoque disponível

    **Debug:**
    Verifique o console do servidor (F8) para mensagens de erro.
  </Accordion>

  <Accordion title="Painel Admin não aparece" icon="crown">
    **Causa:** Jogador não tem permissão de admin.

    **Solução:**
    Verifique a função `Bridge.IsPlayerAdmin()` em `bridge/server.lua` e ajuste para seu sistema de permissões.

    ```lua theme={null}
    function Bridge.IsPlayerAdmin(source)
        -- Customize conforme seu sistema
        return Bridge.Framework.Functions.HasPermission(source, 'admin')
    end
    ```
  </Accordion>
</AccordionGroup>

## Logs e Debug

### Console do Servidor

Verifique mensagens de inicialização:

```
[Bridge] QBCore detectado e carregado
```

### Console do Cliente (F8)

Verifique erros de NUI ou carregamento:

```
[Bridge Client] Jogador carregado (QBCore)
```

## Suporte

<CardGroup cols={2}>
  <Card title="Discord" icon="discord" href="https://discord.gg/UN5w7ZGJBt">
    Entre no nosso Discord para suporte
  </Card>

  <Card title="GitHub Issues" icon="github" href="https://github.com/rktscripts/">
    Reporte bugs e solicite features
  </Card>
</CardGroup>