Leveling system

XP, levels, multipliers, and cosmetic rewards.

Leveling provides progression. Higher levels unlock higher-paying jobs.

Core config

Config.leveling = {
    defaultLevelForJobs = 1,
    defaultXPPerJob = 100,

    notification = {
        theme = 'emerald',
        xpDuration = 2500,
        levelUpDuration = 6000,
        xpToLevelDelay = 300,
        animationDelay = 80,
        soundEnabled = true,
    },

    levels = {
        -- Level configuration here
    }
}

Key settings

• defaultLevelForJobs: starting level for all players.

• defaultXPPerJob: XP awarded per completed job.

Notification settings

• theme: color scheme.

• xpDuration: XP popup time (ms).

• levelUpDuration: level-up popup time (ms).

• xpToLevelDelay: delay between XP and level-up (ms).

• animationDelay: delay between perk animations (ms).

• soundEnabled: toggle sounds.

Themes

• emerald: nature/eco jobs (default)

• blue: professional/corporate

• violet: creative/luxury

• amber: utility/warning

• rose: service/hospitality

Example:

notification = {
    theme = 'blue',
}

Levels configuration

Structure

levels = {
    {
        level = 1,
        multiplier = 1.0,
        xpRequired = 0,
        UnlockedRewards = {
            {text = "Access to Basic Job Sites", icon = "fa-solid fa-briefcase"},
            {text = "Standard Work Van", icon = "fa-solid fa-truck"}
        }
    },
    {
        level = 2,
        multiplier = 1.25,
        xpRequired = 100
    },
    {
        level = 3,
        multiplier = 1.35,
        xpRequired = 1500
    }
}

Fields

• level (required): sequential starting at 1.

• multiplier (required): payout multiplier.

• xpRequired (required): total cumulative XP to reach the level.

• UnlockedRewards (optional): cosmetic reward list shown on level-up.

XP requirements

• xpRequired is cumulative.

• No level cap.

Example:

levels = {
    {level = 1, xpRequired = 0},
    {level = 2, xpRequired = 500},
    {level = 3, xpRequired = 1500},
    {level = 4, xpRequired = 3000},
}

Payout multipliers

Final payout:

Final Pay = basePay × difficultyMultiplier × playerLevelMultiplier

Example:

-- Job site: basePay = 1000, difficulty = "hard"
-- Player: Level 3 (multiplier = 1.35)

-- Step 1: 1000 × 2.0 (hard) = 2000
-- Step 2: 2000 × 1.35 (level 3) = 2700

Recommended scaling:

{level = 1, multiplier = 1.0},
{level = 2, multiplier = 1.15},
{level = 3, multiplier = 1.30},
{level = 4, multiplier = 1.50},
{level = 5, multiplier = 1.75},
{level = 6, multiplier = 2.0},

Keep early multipliers modest (1.1–1.3). Reserve 1.8+ for late game.

Unlocked rewards (visual)

Rewards are cosmetic. They only show in the level-up UI.

UnlockedRewards = {
    {text = "Reward description", icon = "fontawesome-class"}
}

Icon format: fa-solid fa-icon-name or fa-regular fa-icon-name.

Common icon ideas:

• fa-solid fa-briefcase (job access)

• fa-solid fa-truck (vehicles)

• fa-solid fa-bolt (electrical perks)

• fa-solid fa-wrench (tools)

• fa-solid fa-hard-hat (safety gear)

• fa-solid fa-map-marked-alt (location access)

• fa-solid fa-dollar-sign (pay increases)

• fa-solid fa-star (rank/prestige)

• fa-solid fa-trophy (achievements)

• fa-solid fa-certificate (certifications)

Gallery: FontAwesome Icon Gallery

Example:

{
    level = 2,
    multiplier = 1.25,
    xpRequired = 500,
    UnlockedRewards = {
        {text = "15% Pay Increase", icon = "fa-solid fa-dollar-sign"},
        {text = "Upgraded Toolset", icon = "fa-solid fa-wrench"}
    }
}