Groups

The group system allows players to form teams for cooperative house robberies, with configurable member limits, reward sharing, and mission requirements.

General Configuration

minMembersToStart = 1
minMembersToStartrequirednumber
1
Minimum number of members required to start a mission. Set to 1 for solo play or higher for mandatory team play.

Reward Configuration

The rewards section controls how coins and XP are distributed among group members:

rewards = {
    coinSplit = 'equal',

    xpSplit = 'equal',

    leaderBonusPercent = 20,
}
rewards.coinSplitrequiredstring
'equal'
How coins are divided when missions complete.
  • 'equal' - Coins are split equally among all members
  • 'leader_bonus' - Leader gets a bonus percentage on top of equal split
rewards.xpSplitrequiredstring
'equal'
How XP is divided when missions complete.
  • 'equal' - XP is shared equally among all members
  • 'leader_bonus' - Leader gets bonus XP percentage
rewards.leaderBonusPercentrequirednumber
20
Bonus percentage for the leader when using leader_bonus split mode. Other members rewards are slightly reduced to accommodate the leader's bonus.

Mission Configuration

The mission section controls group mission requirements:

mission = {
    requireSameArea = false,

    maxDistance = 100.0,
}
mission.requireSameArearequiredboolean
false
Whether all group members must be in the same vicinity before starting a mission. When enabled, checks distance between leader and members.
mission.maxDistancerequirednumber
100.0
Maximum distance (in meters) members can be from the leader when requireSameArea is enabled or for proximity checks during missions.

Complete Configuration Example

return {
    minMembersToStart = 1,
    
    rewards = {
        coinSplit = 'equal',
        
        xpSplit = 'equal',
        
        leaderBonusPercent = 20,
    },
    
    mission = {
        requireSameArea = false,
        
        maxDistance = 100.0,
    }
}