Configuration

Page dedicated to how to configure our Multicharacter

Configuration Guide (config.lua)

Framework & Inventory Detection While the script attempts to auto-detect your framework, you must explicitly define your inventory system so starter items are distributed correctly.

-- Supported options: 'ox_inventory', 'esx', 'qb'
Config.Inventory = 'ox_inventory' 

Character Slot Management You have absolute control over how many characters a player can create. The Config.Slots array determines the maximum slot count and the properties of each slot.

Config.Slots = {
    { type = "free" }, -- Slot 1: Available immediately
    { type = "free" }, -- Slot 2: Available immediately
    { type = "paid", url = "https://yourtebex.com/category/slots" }, -- Slot 3: Shows a purchase prompt
    { type = "locked" }, -- Slot 4: Completely hidden until unlocked by an Admin
}

Cinematic Cutscenes You can map specific interior locations to specific character slots to create unique backdrops during selection.

Config.Cutscenes = {
    -- Slot 1 will load the Agency Office interior with a specific timecycle modifier
    [1] = { 
        name = "fix_agy_int1", 
        timecycle = "super_lod", 
        coords = vector3(-1147.0691, -1522.1497, 10.6327) 
    },
}

Character Templates & Starting Wealth If Config.CharacterTemplate.enable = true, players are prompted to select a "Background" (e.g., Gangster, Civilian, Police) during creation. This background defines their starting cash, bank balance, and potentially starting vehicles.

If templates are disabled, you must define the default starting money using a strict JSON string:

Config.DefaultMoneyQuery = '{"bank":50000,"money":500}'