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

# Adding Skins

> Learn how to add new skins to the system

## Addition Methods

There are two ways to add skins: via **Admin Panel** (recommended) or via **Database**.

<Tabs>
  <Tab title="Admin Panel (Recommended)">
    ### Using the Admin Panel

    RKT Skins has a complete admin panel that allows you to create skins directly in-game.

    <Steps>
      <Step title="Open the Panel">
        Type `/skins` in chat and click the **Crown** icon (Admin) in the sidebar.

        <Note>
          Requires admin permission configured in Bridge.
        </Note>
      </Step>

      <Step title="Create New Skin">
        Click **"New Skin"** (+) and fill in the data:

        | Field            | Description            | Example                        |
        | ---------------- | ---------------------- | ------------------------------ |
        | **Name**         | Skin name              | Dragon Lore                    |
        | **Weapon Model** | Weapon spawn name      | `WEAPON_PISTOL`                |
        | **Component**    | Component/texture hash | `COMPONENT_PISTOL_VARMOD_LUXE` |
        | **Category**     | Weapon category        | `pistol`                       |
        | **Rarity**       | Rarity                 | `Legendary`                    |
        | **Price**        | Value in cash or coins | `5000`                         |
        | **Currency**     | Currency type          | `cash` or `coins`              |
      </Step>

      <Step title="Add Image">
        Paste the image URL in the **Image URL** field.

        <Tip>
          **Auto Conversion**: Paste a Discord link and the system will automatically convert it to a permanent link (Fivemerr).
        </Tip>
      </Step>

      <Step title="Save">
        Click **Save** and the skin will be immediately available in the store.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Database">
    ### Manual Insertion

    Insert directly into the `rkt_skins_config` table:

    ```sql theme={null}
    INSERT INTO `rkt_skins_config` 
    (`id`, `category`, `component`, `name`, `model`, `color`, `rarity`, `price`, `currency`, `stock`, `image`) 
    VALUES 
    (
      'glock_fade',              -- Unique ID
      'pistol',                  -- Category
      'COMPONENT_PISTOL_FADE',   -- Component
      'Glock Fade',              -- Name
      'WEAPON_COMBATPISTOL',     -- Weapon model
      'purple',                  -- Color (optional)
      'Epic',                    -- Rarity
      5000,                      -- Price
      'cash',                    -- Currency
      100,                       -- Stock (0 = infinite)
      'https://link.com/img.png' -- Image URL
    );
    ```
  </Tab>
</Tabs>

## Skin Structure

Each skin has the following attributes:

| Field       | Type     | Description                                                      |
| ----------- | -------- | ---------------------------------------------------------------- |
| `id`        | `string` | Unique skin identifier                                           |
| `category`  | `string` | Category: `pistol`, `smg`, `rifle`, `sniper`, `shotgun`, `heavy` |
| `component` | `string` | GTA component hash (texture name)                                |
| `name`      | `string` | Display name                                                     |
| `model`     | `string` | Weapon spawn name                                                |
| `color`     | `string` | Highlight color (optional)                                       |
| `rarity`    | `string` | `Common`, `Rare`, `Epic`, `Legendary`                            |
| `price`     | `number` | Skin price                                                       |
| `currency`  | `string` | `cash` or `coins`                                                |
| `stock`     | `number` | Available quantity (0 = infinite)                                |
| `image`     | `string` | Preview image URL                                                |

## Rarities

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

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

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

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

## Weapon Categories

| Category  | Description     | Examples                                    |
| --------- | --------------- | ------------------------------------------- |
| `pistol`  | Pistols         | WEAPON\_PISTOL, WEAPON\_COMBATPISTOL        |
| `smg`     | Submachine Guns | WEAPON\_SMG, WEAPON\_SMG\_MK2               |
| `rifle`   | Rifles          | WEAPON\_ASSAULTRIFLE, WEAPON\_CARBINERIFLE  |
| `sniper`  | Snipers         | WEAPON\_HEAVYSNIPER, WEAPON\_MARKSMANRIFLE  |
| `shotgun` | Shotguns        | WEAPON\_PUMPSHOTGUN, WEAPON\_SAWNOFFSHOTGUN |
| `heavy`   | Heavy Weapons   | WEAPON\_MINIGUN, WEAPON\_RPG                |