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

# Adicionando Skins

> Aprenda a adicionar novas skins ao sistema

## Métodos de Adição

Existem duas formas de adicionar skins: pelo **Painel Admin** (recomendado) ou via **Banco de Dados**.

<Tabs>
  <Tab title="Painel Admin (Recomendado)">
    ### Usando o Painel Admin

    O RKT Skins possui um painel administrativo completo que permite criar skins diretamente in-game.

    <Steps>
      <Step title="Abra o Painel">
        Digite `/skins` no chat e clique no ícone de **Coroa** (Admin) no menu lateral.

        <Note>
          Requer permissão de administrador configurada no Bridge.
        </Note>
      </Step>

      <Step title="Criar Nova Skin">
        Clique em **"Nova Skin"** (+) e preencha os dados:

        | Campo            | Descrição                  | Exemplo                        |
        | ---------------- | -------------------------- | ------------------------------ |
        | **Nome**         | Nome da skin               | Dragon Lore                    |
        | **Weapon Model** | Nome de spawn da arma      | `WEAPON_PISTOL`                |
        | **Component**    | Hash do componente/textura | `COMPONENT_PISTOL_VARMOD_LUXE` |
        | **Category**     | Categoria da arma          | `pistol`                       |
        | **Rarity**       | Raridade                   | `Legendary`                    |
        | **Preço**        | Valor em dinheiro ou coins | `5000`                         |
        | **Currency**     | Tipo de moeda              | `cash` ou `coins`              |
      </Step>

      <Step title="Adicionar Imagem">
        Cole a URL da imagem no campo **Image URL**.

        <Tip>
          **Conversão Automática**: Cole um link do Discord e o sistema converterá automaticamente para um link permanente (Fivemerr).
        </Tip>
      </Step>

      <Step title="Salvar">
        Clique em **Salvar** e a skin estará disponível imediatamente na loja.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Banco de Dados">
    ### Inserção Manual

    Insira diretamente na tabela `rkt_skins_config`:

    ```sql theme={null}
    INSERT INTO `rkt_skins_config` 
    (`id`, `category`, `component`, `name`, `model`, `color`, `rarity`, `price`, `currency`, `stock`, `image`) 
    VALUES 
    (
      'glock_fade',              -- ID único
      'pistol',                  -- Categoria
      'COMPONENT_PISTOL_FADE',   -- Componente
      'Glock Fade',              -- Nome
      'WEAPON_COMBATPISTOL',     -- Modelo da arma
      'purple',                  -- Cor (opcional)
      'Epic',                    -- Raridade
      5000,                      -- Preço
      'cash',                    -- Moeda
      100,                       -- Estoque (0 = infinito)
      'https://link.com/img.png' -- URL da imagem
    );
    ```
  </Tab>
</Tabs>

## Estrutura da Skin

Cada skin possui os seguintes atributos:

| Campo       | Tipo     | Descrição                                                         |
| ----------- | -------- | ----------------------------------------------------------------- |
| `id`        | `string` | Identificador único da skin                                       |
| `category`  | `string` | Categoria: `pistol`, `smg`, `rifle`, `sniper`, `shotgun`, `heavy` |
| `component` | `string` | Hash do componente GTA (nome da textura)                          |
| `name`      | `string` | Nome de exibição da skin                                          |
| `model`     | `string` | Nome de spawn da arma                                             |
| `color`     | `string` | Cor de destaque (opcional)                                        |
| `rarity`    | `string` | `Common`, `Rare`, `Epic`, `Legendary`                             |
| `price`     | `number` | Preço da skin                                                     |
| `currency`  | `string` | `cash` ou `coins`                                                 |
| `stock`     | `number` | Quantidade disponível (0 = infinito)                              |
| `image`     | `string` | URL da imagem de preview                                          |

## Raridades

<CardGroup cols={4}>
  <Card title="Common" icon="circle" color="#9CA3AF">
    Comum
  </Card>

  <Card title="Rare" icon="star" color="#3B82F6">
    Raro
  </Card>

  <Card title="Epic" icon="gem" color="#8B5CF6">
    Épico
  </Card>

  <Card title="Legendary" icon="crown" color="#F59E0B">
    Lendário
  </Card>
</CardGroup>

## Categorias de Armas

| Categoria | Descrição        | Exemplos                                    |
| --------- | ---------------- | ------------------------------------------- |
| `pistol`  | Pistolas         | WEAPON\_PISTOL, WEAPON\_COMBATPISTOL        |
| `smg`     | Submetralhadoras | WEAPON\_SMG, WEAPON\_SMG\_MK2               |
| `rifle`   | Rifles           | WEAPON\_ASSAULTRIFLE, WEAPON\_CARBINERIFLE  |
| `sniper`  | Snipers          | WEAPON\_HEAVYSNIPER, WEAPON\_MARKSMANRIFLE  |
| `shotgun` | Escopetas        | WEAPON\_PUMPSHOTGUN, WEAPON\_SAWNOFFSHOTGUN |
| `heavy`   | Armas Pesadas    | WEAPON\_MINIGUN, WEAPON\_RPG                |