Skills

The skills configuration defines experience progression, leveling mechanics, rate limiting, and group bonuses for the house robbery skill system.

Basic Progression Settings

The core progression settings control how players gain levels and experience:

baseExperience = 500,

multiplier = 1.0,

maxLevel = 100
baseExperiencerequirednumber
The base amount of experience required for the first level progression. This value is used as a foundation for calculating all level requirements.
multiplierrequirednumber
The progression multiplier that affects how experience requirements scale with levels. Higher values make progression more difficult.
maxLevelrequirednumber
The maximum level that players can achieve in the house robbery skill system.

Progression Type

The progressionType setting determines how experience requirements scale between levels:

progressionType = 'exponential'
progressionTyperequiredstring
The type of progression curve used for leveling. Options are 'linear' for consistent increases, or 'exponential' for scaling difficulty.

Progression Types Explained

  • Linear: Each level requires a consistent increase in experience (baseExperience + baseExperience * multiplier * level)
  • Exponential: Each level requires exponentially more experience (baseExperience * multiplier ^ level)

Experience Rate Limiting

The rate limiting system prevents experience farming and abuse, with support for level-based scaling:

maxExperiencePerHour = {
    base = 3000,

    levelMultiplier = 1.05
}
maxExperiencePerHourrequiredtable|number
The maximum experience per hour configuration. Can be a simple number for flat limits, or a table for level-based scaling.
maxExperiencePerHour.baserequirednumber
The base experience limit for level 1 players when using level-based scaling.
maxExperiencePerHour.levelMultiplierrequirednumber
The multiplier applied per level. Each level increases the limit by this factor (1.05 = 5% more per level).

Rate Limiting Examples

With the default configuration (base = 3000, levelMultiplier = 1.05):

  • Level 1: 3000 XP/hour limit
  • Level 10: ~4,634 XP/hour limit
  • Level 25: ~10,066 XP/hour limit
  • Level 50: ~34,371 XP/hour limit

You can also use a simple number for flat rate limiting:

maxExperiencePerHour = 5000

Group Experience Bonuses

The group bonus system rewards players for working together in teams:

groupExperienceBonus = {
    enabled = true,
    
    groupSize = {
        [2] = 1.25,
        [3] = 1.5,
        [4] = 1.75,
    }
}
groupExperienceBonus.enabledrequiredboolean
Whether group experience bonuses are enabled. Set to false to disable all group bonuses.
groupExperienceBonus.groupSizerequiredtable
A table mapping group sizes to experience multipliers. Each entry defines how much bonus experience players receive based on their group size.
groupExperienceBonus.groupSize[2]number
Experience multiplier for groups of 2 players (1.25 = 25% bonus).
groupExperienceBonus.groupSize[3]number
Experience multiplier for groups of 3 players (1.5 = 50% bonus).
groupExperienceBonus.groupSize[4]number
Experience multiplier for groups of 4 players (1.75 = 75% bonus).

Complete Configuration Example

return {
    baseExperience = 500,

    multiplier = 1.0,
    
    maxLevel = 100,
    
    progressionType = 'exponential',
    
    maxExperiencePerHour = {
        base = 3000,
        
        levelMultiplier = 1.05
    },
    
    groupExperienceBonus = {
        enabled = true,

        groupSize = {
            [2] = 1.25,
            [3] = 1.5,
            [4] = 1.75,
        },
    }
}
Edit this page
Properties
Property locations, coordinates, and vehicle spawn points for different difficulty tiers in the house robbery system.
Tiers
The tiers configuration defines difficulty levels, security systems, rewards, and requirements for house robbery contracts across four progressive tiers.