Group System

Team up with other players for group missions.

Overview

The co-op system allows 2-4 players to complete delivery missions together, earning bonus rewards for teamwork.

Key Features

Feature	Value
Min Players	2
Max Players	4
Reward Bonus	1.3x (30%)
Proximity Radius	50 meters
Invite Timeout	30 seconds
Max Distance	100 meters

Creating a Group

1

Start Group

• Go to the job hub

• Select "Group Options"

• Choose "Create Group"

2

Invite Players

• Select "Invite Nearby"

• Players within 10m shown

• Select player to invite

• Wait for acceptance

3

Start Mission

• All members ready

• Leader selects job

• Mission starts for all

• Everyone gets objectives

Joining a Group

Receiving Invite

1

• Be near group leader (10m)

• Receive invitation notification

• Accept within 30 seconds

• Join the group

Requirements

• Not on an active mission

• Within proximity range

• Same server

Group Missions

How It Works

1

All members share objectives.

2

Any member can complete objectives (shared progress).

3

Each player gets full payout + bonus (individual rewards).

4

Coordinate and work together for efficiency.

Example Flow

Group Flow

Group: Player A (Leader), Player B

1. Leader starts Parcel Delivery (3 stops)
2. Both players spawn vehicles
3. Player A takes stops 1 & 2
4. Player B takes stop 3
5. Mission completes faster
6. Both receive full rewards + 30% bonus

Reward Distribution

Base Calculation

Each member receives:

Individual Reward Formula

Individual Reward = Full Mission Payout × 1.3

Example

Mission Base Payout: $500

Player	Base	Co-op Bonus	Total
Player A	$500	+$150	$650
Player B	$500	+$150	$650
Total	$1,000	+$300	$1,300

Co-op is not "shared rewards" - everyone gets full pay plus bonus!

Team Player Skill

The Team Player skill increases co-op rewards:

Level	Bonus	Total
0	1.3x	30%
1	1.4x	40%
2	1.5x	50%
3	1.65x	65%

Skill Application

The highest Team Player level in the group applies to all members.

Example: If one player has Level 3 Team Player, everyone gets 65% bonus.

Group Management

Leaving a Group

1

• Open Group Menu

• Select "Leave Group"

• Confirm

Leaving mid-mission cancels YOUR progress. Others continue.

Kicking Members (Leader Only)

1

• Open Group Menu

• Select member

• Choose "Remove from Group"

Disbanding (Leader Only)

1

• Open Group Menu

• Select "Disband Group"

• All members removed

Proximity Requirements

Staying Together

• Max Distance: 100 meters from leader

• Warning: At 80+ meters

• Kick: At 100+ meters (after warning)

During Deliveries

Members can spread out to different delivery locations but must reunite periodically.

Best Practices

Divide and Conquer — Split delivery stops between members for faster completion.

One Vehicle Each — Each member should spawn their own vehicle.

Communicate — Use voice chat or Discord for coordination.

Invest in Team Player — The skill bonus applies to everyone in your group.

Co-op Achievements

Work toward these achievements:

Achievement	Requirement	Reward
Team Player	20 co-op deliveries	2,500 XP, $1,500

Technical Details

Group Data Structure

Group Data Structure (Lua)

{
    id = 1,
    leader_citizenid = "ABC123",
    members = {
        "ABC123",
        "DEF456"
    },
    mission_id = "MISSION_789",
    created_at = timestamp,
    expires_at = timestamp + 3600
}

Group Expiration

Groups automatically expire after 1 hour of inactivity.

Troubleshooting

Can't Create Group

• Check you're not on a mission

• Verify at job hub location

• Database must be connected

Can't Invite Players

• Must be within 10 meters

• Target must not be on a mission

• Target must not be in another group

Rewards Not Received

• Ensure mission completed

• Check all members present

• Verify group wasn't disbanded

Configuration

Server admins can adjust co-op settings:

Config.CoopSettings (Lua)

Config.CoopSettings = {
    MIN_PLAYERS = 2,
    MAX_PLAYERS = 4,
    PROXIMITY_RADIUS = 50.0,
    REWARD_MULTIPLIER = 1.3,
    INVITE_TIMEOUT = 30,
    MAX_DISTANCE = 100.0
}