Economy Configuration

Configure payments, multipliers, bonuses, and the dynamic economy system.

---

Payout Configuration

Base Payment

Set in each job configuration:

Config.Jobs.food_delivery = {
    basePayment = 50,  -- Base $ per mission
    xp = 100,          -- Base XP per mission
}

Payout Type

Where earnings are deposited:

Config.PayoutType = 'cash'  -- 'cash' or 'bank'

Value	Behavior
'cash'	Added to ATM balance (requires withdrawal)
'bank'	Added directly to bank account

---

Dynamic Economy System

The economy adjusts based on job popularity.

How It Works

1

High Demand

Jobs with few completions pay more.

2

Low Demand

Popular jobs pay less.

3

Updates

Multipliers recalculate every 5 minutes.

Demand Levels

Completions (last period)	Demand	Multiplier
10-30	Low	0.80x - 0.90x
3-10	Normal	1.00x
1-3	High	1.10x - 1.50x

Viewing Current Economy

Players see demand indicators in the job menu:

Food Delivery
Payment: $50 (High Demand +20%)

---

Distance Bonus System

Reward players for longer routes.

Enable/Disable

Config.EnableDistanceBonus = true

Base Values

Config.DistanceBonusPerKM = 5       -- $5 per kilometer
Config.DistanceXPBonusPerKM = 2     -- 2 XP per kilometer
Config.MaxDistanceMultiplier = 2.0  -- Cap at 2x bonus
Config.LongHaulThreshold = 3.0      -- 3km = "long haul"

Job-Specific Multipliers

Different jobs have different distance values:

Config.DistanceBonusMultipliers = {
    food_delivery = 1.0,           -- Standard
    parcel_delivery = 1.2,         -- 20% more
    medical_supply_delivery = 1.8, -- 80% more
    luxury_goods_delivery = 2.0,   -- Double
    construction_material_delivery = 1.5,
    mail_delivery = 1.0,
    alcohol_delivery = 1.3,
    pharmaceutical_delivery = 1.6,
    grocery_delivery = 1.1,
    auto_parts_delivery = 1.4,
    illegal_contraband = 3.0,      -- Illegal pays more
    illegal_weapons = 4.0,
    illegal_drugs = 3.5
}

Example Calculation

A 5km food delivery:

Distance: 5 km
Base: $5/km × 5 = $25
Multiplier: 1.0x (food delivery)
Total Bonus: $25

A 5km luxury goods delivery:

Distance: 5 km
Base: $5/km × 5 = $25
Multiplier: 2.0x (luxury)
Total Bonus: $50

---

Payout Multipliers

All Multipliers Applied

Factor	How It Works	Range
Rank	1 + (rank × 0.05)	1.05x - 1.50x
Mission Type	Timed/VIP pay more	1.0x - 1.6x
Prestige	Permanent bonus	1.0x - 1.5x
Faction Rep	Higher rep = more money	0% - 40%
Co-op	Group missions	1.3x
Weather	Bad weather pays more	0.7x - 1.0x
Time of Day	Night pays more	1.0x - 1.2x
Damage	Penalty for vehicle damage	0.25x - 1.0x
Economy	Supply/demand	0.8x - 1.5x
Bonus Objective	If completed	1.25x
Distance	Per kilometer driven	Variable

---

Damage Penalties

Vehicle damage reduces payout:

Damage Level	Health Lost	Payout
Perfect	0	100%
Minimal	1-100	95%
Light	101-300	85%
Moderate	301-600	70%
Heavy	601-900	50%
Severe	901+	25%

---

ATM Configuration

Enable Built-in ATM

Config.EnableBuiltInATM = true

ATM Location

Config.ATMLocation = vec4(120.07, -3078.27, 6.02, 98.44)
Config.ATMPedModel = 'a_m_m_business_01'

Withdrawal Settings

Config.ATMWithdrawalFee = 5      -- 5% fee
Config.ATMMinWithdrawal = 100    -- Minimum $100
Config.ATMMaxWithdrawal = 999999 -- Maximum per transaction

Fee Calculation

Requested: $1,000
Fee (5%): $50
Received: $950

---

Example: Complete Payout Calculation

Scenario:

• Job: Luxury Goods Delivery

• Base Payment: $150

• Distance: 8 km

• Player Rank: 5

• Prestige: 1 (Bronze Star)

• Faction Rep: Trusted (10% bonus)

• Mission Type: Timed (1.3x)

• Vehicle Damage: None

• Economy: High Demand (+15%)

Calculation:

Base Payment:      $150
× Rank (1.25):     $187.50
× Prestige (1.1):  $206.25
× Mission (1.3):   $268.13
× Economy (1.15):  $262.10
× Faction (+10%):  $288.31

Distance Bonus:
8 km × $5 × 2.0 = $80

Total: $368.31