General Settings

📁 Configuration File#

All general settings are located in:

0r-multicharacterv3/config/config.lua

🛠️ Developer Settings#

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

Set both to false in production for better performance!

🌍 Language Settings#

Config.Locale = 'en'  -- Language code

Available Languages#

Code	Language
en	English
tr	Turkish
fr	French
ar	Arabic

Adding Custom Languages#

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

🎯 General UI Settings#

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

DisableDeleteCharacter = true is recommended for most servers to prevent accidental deletions.

🔢 Character Slots#

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#

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

ESX Only: This setting defines the character identifier prefix. Default is char which creates identifiers like char1:license123, char2:license123, etc.

📊 Logging Configuration#

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:

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

🎵 Background Music#

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#

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

Keep music files under 5MB for faster loading.

🎛️ Complete Config Example#

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