> ## 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.

# Instalação

> Guia completo para instalar o RKT Skins no seu servidor

## Requisitos

Antes de instalar, certifique-se de ter os seguintes recursos:

<CardGroup cols={2}>
  <Card title="ox_lib" icon="box" href="https://github.com/overextended/ox_lib">
    Interface e utilitários
  </Card>

  <Card title="oxmysql" icon="database" href="https://github.com/overextended/oxmysql">
    Conexão com banco de dados
  </Card>
</CardGroup>

<Note>
  Você também precisará de uma conta no [Fivemerr](https://fivemerr.com) ou [Fivemanage](https://fivemanage.com) para hospedagem de imagens.
</Note>

## Passo 1: Download e Extração

Baixe a versão mais recente e extraia a pasta `rkt_skins` para o diretório `resources` do seu servidor.

```
resources/
├── [standalone]/
├── [core]/
└── rkt_skins/        <-- Extraia aqui
    ├── bridge/
    ├── modules/
    ├── web/
    └── ...
```

## Passo 2: Configuração do Framework

Abra o arquivo `bridge/config.lua` e defina seu framework:

<CodeGroup>
  ```lua QBCore theme={null}
  BridgeConfig.Framework = "qbcore"
  ```

  ```lua Qbox theme={null}
  BridgeConfig.Framework = "qbx"
  ```

  ```lua Custom theme={null}
  BridgeConfig.Framework = "custom"
  ```
</CodeGroup>

## Passo 3: Banco de Dados

Execute o arquivo `database.sql` no seu banco de dados para criar as tabelas necessárias.

<Tabs>
  <Tab title="HeidiSQL">
    1. Conecte ao seu banco de dados
    2. Abra o arquivo `database.sql`
    3. Clique em **Executar**
  </Tab>

  <Tab title="phpMyAdmin">
    1. Acesse seu phpMyAdmin
    2. Selecione o banco de dados do servidor
    3. Vá em **Importar** e selecione o arquivo `database.sql`
  </Tab>
</Tabs>

<Info>
  Se você usa o **Admin Panel** para criar skins, as tabelas serão preenchidas automaticamente.
</Info>

### Estrutura das Tabelas

| Tabela                | Descrição                          |
| --------------------- | ---------------------------------- |
| `rkt_skins`           | Skins dos jogadores                |
| `rkt_skins_config`    | Configuração das skins disponíveis |
| `rkt_market_listings` | Anúncios do marketplace            |
| `rkt_market_offers`   | Ofertas nos anúncios               |
| `rkt_transactions`    | Histórico de transações            |
| `rkt_daily_shop`      | Ofertas da Loja Diária             |
| `rkt_night_market`    | Ofertas do Night Market            |

## Passo 4: Configuração do Servidor

Adicione ao seu `server.cfg`:

```cfg theme={null}
# Dependências
ensure ox_lib
ensure oxmysql

# RKT Skins
ensure rkt_skins
```

<Warning>
  Certifique-se de que `ox_lib` e `oxmysql` estejam **antes** do `rkt_skins` no arquivo.
</Warning>

## Atualização (Migração)

Se você está atualizando de uma versão anterior, verifique os arquivos `.sql` de migração na pasta raiz (ex: `migration_add_daily_shop.sql`) e execute-os se necessário para criar novas tabelas sem perder dados.

## Passo 5: Configurar API de Imagens

Configure a API do provedor de imagens em `modules/screenshot/config.lua`:

<CodeGroup>
  ```lua Fivemerr theme={null}
  ScreenshotConfig.Provider = 'fivemerr'
  ScreenshotConfig.Fivemerr = {
      Token = "SUA_API_KEY_AQUI"
  }
  ```

  ```lua Fivemanage theme={null}
  ScreenshotConfig.Provider = 'fivemanage'
  ScreenshotConfig.Fivemanage = {
      Token = "SEU_TOKEN_AQUI"
  }
  ```
</CodeGroup>

## Verificação

Após iniciar o servidor, verifique o console para confirmar:

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

<Check>
  Se você ver essas mensagens, o recurso foi instalado com sucesso!
</Check>