# General Settings

### 📁 Configuration File

All general settings are located in:

```
0r-multicharacterv3/config/config.lua
```

***

### 🛠️ Developer Settings

```lua
Config.Debug = true           -- Enable debug messages in console
Config.DeveloperMode = true   -- Enable developer features
```

| Option        | Type    | Default | Description                            |
| ------------- | ------- | ------- | -------------------------------------- |
| Debug         | boolean | true    | Prints debug info to F8/server console |
| DeveloperMode | boolean | true    | Enables additional developer features  |

{% hint style="warning" %}
Set both to `false` in production for better performance!
{% endhint %}

***

### 🌍 Language Settings

```lua
Config.Locale = 'en'  -- Language code
```

#### Available Languages

| Code | Language |
| ---- | -------- |
| en   | English  |
| tr   | Turkish  |
| fr   | French   |
| ar   | Arabic   |

#### Adding Custom Languages

1. Copy `locales/en.json` to `locales/xx.json`
2. Translate all strings
3. Set `Config.Locale = 'xx'`

***

### 🎯 General UI Settings

```lua
Config.HideRadar = false              -- Hide minimap during selection
Config.SkipWarning = false            -- Skip the warning/welcome screen
Config.DisableDeleteCharacter = true  -- Disable character deletion
```

| Option                 | Type    | Default | Description                                  |
| ---------------------- | ------- | ------- | -------------------------------------------- |
| HideRadar              | boolean | false   | Hides the minimap during character selection |
| SkipWarning            | boolean | false   | Skips the initial warning screen             |
| DisableDeleteCharacter | boolean | true    | Prevents players from deleting characters    |

{% hint style="info" %}
`DisableDeleteCharacter = true` is recommended for most servers to prevent accidental deletions.
{% endhint %}

***

### 🔢 Character Slots

```lua
Config.DefaultCharacterSlots = 1  -- Base slots for all players
```

This is the **base** number of character slots. Additional slots can be added through:

* Discord roles
* Tebex purchases
* Redeemable codes
* Admin commands

***

### 📝 ESX Prefix

```lua
Config.Prefix = 'char'  -- Character prefix for ESX identifiers
```

{% hint style="warning" %}
**ESX Only:** This setting defines the character identifier prefix. Default is `char` which creates identifiers like `char1:license123`, `char2:license123`, etc.
{% endhint %}

***

### 📊 Logging Configuration

```lua
Config.Logs = {
    status = true,        -- Enable/disable logging
    logger = 'discord',   -- 'discord' or 'ox_lib'
}
```

| Option | Type    | Values               | Description                   |
| ------ | ------- | -------------------- | ----------------------------- |
| status | boolean | true/false           | Enable or disable all logging |
| logger | string  | 'discord', 'ox\_lib' | Logging system to use         |

#### Discord Webhook Setup

Configure webhooks in `server/webhook.lua`:

```lua
Webhooks = {
    playgame = 'YOUR_WEBHOOK_URL',
    createchar = 'YOUR_WEBHOOK_URL',
    deletechar = 'YOUR_WEBHOOK_URL',
}
```

***

### 🎵 Background Music

```lua
Config.BackgroundMusic = {
    status = true,         -- Enable/disable music
    volume = 0.2,          -- Volume (0.0 to 1.0)
    url = 'bgmusic.mp3',   -- Audio file in web/build/sounds/
}
```

| Option | Type    | Default       | Description                          |
| ------ | ------- | ------------- | ------------------------------------ |
| status | boolean | true          | Enable background music              |
| volume | number  | 0.2           | Music volume (0.0 = mute, 1.0 = max) |
| url    | string  | 'bgmusic.mp3' | Audio filename                       |

#### Using Custom Music

1. Place your audio file in `web/build/sounds/`
2. Update `url` with your filename
3. Supported formats: `.mp3`, `.ogg`, `.wav`

{% hint style="info" %}
Keep music files under 5MB for faster loading.
{% endhint %}

***

### 🎛️ Complete Config Example

```lua
-- config/config.lua

local Config = {}

-- Developer Settings
Config.Debug = false
Config.DeveloperMode = false

-- General Settings
Config.Locale = 'en'
Config.HideRadar = true
Config.Prefix = 'char'
Config.DefaultCharacterSlots = 2
Config.SkipWarning = false
Config.DisableDeleteCharacter = true

-- Logging
Config.Logs = {
    status = true,
    logger = 'discord',
}

-- Background Music
Config.BackgroundMusic = {
    status = true,
    volume = 0.15,
    url = 'bgmusic.mp3',
}

return Config
```

***

### ➡️ Next Steps