# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.0resmon.org/0resmon/0r-resources/0r-multicharacter-v3/configuration/general-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.