Immersive Character Background Selection System

Config = {}

-- Debug mode
Config.debug = true

-- Event Handlers
Config.triggerEvent = "vorp:initNewCharacter" -- For RSG: "rsg-spawn:client:newplayer"
Config.afterSelectClientEvent = false -- Set to false if no event should be triggered after selection

-- Background configurations with UI data
Config.Backgrounds = {
    hunter = {
        -- UI Settings
        label = "Hunter",
        description = "A skilled character, experienced in the art of hunting and survival in the wilderness.",
        image = "images/hunter.jpg",
        
        -- Gameplay Settings
        job = "hunter",
        perks = {
            { name = "hunting", amount = 5000 },
            { name = "gunslinger", amount = 2000 }
        },
        items = {
            { name = "WEAPON_BOW", isWeapon = true },
            { name = "ammoarrownormal", amount = 2 }
        },

        custom = function(source, charid, background)
            -- Custom code here to call custom events or do custom things (server side)
        end
    }
}

-- UI Settings
Config.UISettings = {
    -- Set to true to make the player invisible while the UI is open
    playerInvisible = true,
    
    -- UI Text (can be customized for different languages)
    text = {
        title = "Background Selection",
        description = "Select your background to define your character through his past and origin – a choice that significantly shapes your game start.",
        confirmationTitle = "Are you sure?",
        confirmationMessage = "This selection is final and cannot be changed.",
        confirmButton = "Confirm",
        cancelButton = "Cancel",
        selectButton = "Select"
    }
}

-- Example: Adding a new background
my_new_background = {
    -- UI Settings
    label = "My New Background",          -- Name shown in UI
    description = "Description here...",  -- Description shown in UI
    image = "images/my_image.png",        -- Image path relative to html folder
    
    -- Gameplay Settings
    job = "myjob",
    money = 100,  -- Optional: starting money (can be negative)
    
    -- Optional: starting perks (compatible with weapon progression systems)
    perks = {     
        { name = "some_perk", amount = 1000 }
    },
    
    -- Optional: starting items
    items = {     
        { name = "some_item", amount = 5 },
        { name = "WEAPON_SOMETHING", isWeapon = true }
    },
    
    -- Optional: custom code (server side)
    custom = function(source, charid, background)
        -- Custom code here to call custom events or do custom things (server side)
    end
}

-- Required UI settings for each background
label = "Background Name",           -- Display name in the UI
description = "Background description...", -- Detailed description
image = "images/background.jpg",     -- Image file path

-- Core gameplay settings
job = "jobname",                     -- Starting job assignment
money = 100,                        -- Starting money (can be negative)

-- Optional perk configuration
perks = {
    { name = "perk_name", amount = 5000 }  -- Perk name and starting amount
},

-- Optional item configuration
items = {
    { name = "item_name", amount = 5 },                    -- Regular item
    { name = "WEAPON_NAME", isWeapon = true },             -- Weapon item
    { name = "item_name", amount = 1, metadata = {...} }   -- Item with metadata
}

-- Optional custom server-side function
custom = function(source, charid, background)
    -- source: player source ID
    -- charid: character ID
    -- background: background configuration table
    
    -- Example: Trigger custom events
    TriggerEvent('my_custom_event', source, charid)
    
    -- Example: Call external functions
    exports['my_script']:doSomething(source, charid)
end

items = {
    { name = "bandage", amount = 5 },
    { name = "compass", amount = 1 }
}

items = {
    { name = "WEAPON_BOW", isWeapon = true },
    { name = "WEAPON_REVOLVER_NAVY", isWeapon = true }
}

items = {
    { 
        name = "horse_token", 
        amount = 1, 
        metadata = { 
            description = "American Paint Splashed White", 
            id = "A_C_Horse_AmericanPaint_SplashedWhite" 
        }
    }
}

-- Perk configuration example
perks = {
    { name = "hunting", amount = 5000 },      -- Hunting skill
    { name = "gunslinger", amount = 2000 },   -- Weapon proficiency
    { name = "herbalism", amount = 7600 },    -- Herbalism skill
    { name = "mining", amount = 5000 },       -- Mining skill
    { name = "farming", amount = 5000 },      -- Farming skill
    { name = "medic", amount = 5000 },        -- Medical skill
    { name = "fishing", amount = 5000 },      -- Fishing skill
    { name = "cooking", amount = 5000 },      -- Cooking skill
    { name = "blacksmithing", amount = 5000 }, -- Blacksmithing skill
    { name = "lumber", amount = 5000 }        -- Lumberjacking skill
}

Config.triggerEvent = "vorp:initNewCharacter"

Config.triggerEvent = "rsg-spawn:client:newplayer"

Config.triggerEvent = "your_custom_event"
Config.afterSelectClientEvent = "your_after_select_event"

blacksmith = {
    label = "Blacksmith",
    description = "A skilled craftsman who forges weapons, tools, and horseshoes, essential to frontier life.",
    image = "images/blacksmith.jpg",

    job = "blacksmith",
    perks = {
        { name = "blacksmithing", amount = 5000 }
    },
    items = {
        { name = "hammer", amount = 1 },
        { name = "anvil", amount = 1 },
        { name = "iron_ore", amount = 10 }
    }
}

outlaw = {
    label = "Outlaw",
    description = "A wanted criminal with a dark past, skilled in stealth and survival.",
    image = "images/outlaw.jpg",

    job = "outlaw",
    money = -50,  -- Negative starting money
    perks = {
        { name = "gunslinger", amount = 3000 },
        { name = "stealth", amount = 2000 }
    },
    items = {
        { name = "lockpick", amount = 10 },
        { name = "WEAPON_REVOLVER_NAVY", isWeapon = true },
        { name = "ammorevolvernormal", amount = 2 }
    },
    custom = function(source, charid, background)
        -- Set wanted level or trigger custom events
        TriggerEvent('outlaw:setWanted', source, 1)
    end
}