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

# Configuration

> Customize RKT Skins for your server

## Main Configuration

The `config.lua` file contains the main system settings.

```lua config.lua theme={null}
Config = {}

Config.Locale = 'en'              -- System language
Config.Debug = true               -- Enable debug logs
Config.EnableCommand = true        -- Enable /skins command
Config.CommandName = 'skins'       -- Command name

-- Debug Categories
Config.DebugCategories = {
    ['Init'] = true,
    ['Events'] = true,
    ['Database'] = true,
    ['Bridge'] = true,
    ['Market'] = true,
    ['DailyShop'] = true,
}

Config.UI = {
    Logo = 'https://your-logo.com/logo.png',
    Colors = {
        Primary = '#8257e5',       -- Primary color (Purple)
        Background = '#09090A',    -- Background
        Card = '#121214',          -- Cards
        CardHover = '#202024',     -- Cards (hover)
        Text = '#FFFFFF',          -- Main text
        TextSecondary = '#A1A1AA', -- Secondary text
        Success = '#10B981',       -- Success
        Error = '#EF4444',         -- Error
        Warning = '#F59E0B',       -- Warning
        Info = '#3B82F6'           -- Info
    }
}

Config.DailyShop = {
    Enabled = true,
    RotationHour = 0, -- Rotation hour (0 = midnight)
    ItemCount = 4,
    Discount = { Min = 5, Max = 15 }, -- Discount in %
}

Config.NightMarket = {
    StartDate = '2025-12-21 00:00:00',
    DurationDays = 7,
    Discount = { Min = 10, Max = 50 },
    Schedule = { Enabled = true }, -- Auto rotation via server config.json
}

Config.Webhooks = {
    Purchase = "DISCORD_WEBHOOK_URL", -- Purchases
    Transfer = "DISCORD_WEBHOOK_URL", -- Transfers
    Admin = "DISCORD_WEBHOOK_URL",    -- Admin Actions
    Security = "DISCORD_WEBHOOK_URL", -- Security Alerts
}
```

## Bridge Configuration

### Framework

Set the framework in the `bridge/config.lua` file:

<Tabs>
  <Tab title="QBCore">
    ```lua theme={null}
    BridgeConfig = {}
    BridgeConfig.Framework = "qbcore"
    ```
  </Tab>

  <Tab title="Qbox">
    ```lua theme={null}
    BridgeConfig = {}
    BridgeConfig.Framework = "qbx"
    ```
  </Tab>

  <Tab title="Custom">
    ```lua theme={null}
    BridgeConfig = {}
    BridgeConfig.Framework = "custom"
    -- Implement your own functions in bridge/client.lua and bridge/server.lua
    ```
  </Tab>
</Tabs>

## Screenshot Configuration

Configure the image provider in `modules/screenshot/config.lua`:

```lua theme={null}
ScreenshotConfig = {}

-- Provider: 'fivemerr' or 'fivemanage'
ScreenshotConfig.Provider = 'fivemerr'

-- Fivemerr Configuration
ScreenshotConfig.Fivemerr = {
    Token = "YOUR_API_KEY_HERE"
}

-- Fivemanage Configuration (alternative)
ScreenshotConfig.Fivemanage = {
    Token = "YOUR_TOKEN_HERE"
}
```

<Info>
  The **Screenshot** and **Image Converter** modules are **Open Source**. You can adapt them to your own CDN.
</Info>

## Color Customization

The system uses CSS variables that can be customized via `Config.UI.Colors`:

| Variable        | Description          | Default   |
| --------------- | -------------------- | --------- |
| `Primary`       | Main highlight color | `#8257e5` |
| `Background`    | Background color     | `#09090A` |
| `Card`          | Card color           | `#121214` |
| `CardHover`     | Card color (hover)   | `#202024` |
| `Text`          | Main text color      | `#FFFFFF` |
| `TextSecondary` | Secondary text color | `#A1A1AA` |

## Supported Languages

| Code    | Language            |
| ------- | ------------------- |
| `pt-br` | Portuguese (Brazil) |
| `en`    | English             |

To add a new language, create a file in `locales/[code].json`.
