Follow Player System

The Follow Player system lets motorcycle gangs escort you through Los Santos. When enabled, riders from CanFollowPlayer = true groups will follow your vehicle, forming a convoy behind you.

---

How It Works

When a rider group is active and within range, the system checks whether the group should follow the player. If the trigger conditions are met, the group switches from its normal cruise behaviour to following your vehicle in formation.

The system is globally toggled with F7 (configurable) and can be limited by PlayerVehicleType.

---

Trigger Modes

Proximity

Follow triggers when any rider in the group is within FollowRadius of the player. Simple distance check.

Mode = Proximity
FollowRadius = 60.0
LoseRadius = 200.0

• Trigger: Any rider enters FollowRadius
• Cancel: All riders exit LoseRadius

Dynamic (Default)

Follow triggers based on player speed and proximity. You take the lead by accelerating past the group.

Mode = Dynamic
FollowRadius = 60.0
LoseRadius = 200.0
DynamicMinSpeed = 12.0
DynamicTriggerMs = 2000

Condition	Behaviour
Player speed > DynamicMinSpeed + any rider within FollowRadius	Player takes lead: riders follow
Player speed < DynamicMinSpeed	Riders take back the lead (they pass you)
All riders beyond LoseRadius	Group stops following

The DynamicTriggerMs delay prevents brief acceleration from triggering follow mode. The player must sustain speed above the threshold for that duration.

---

Player Vehicle Types

Control which vehicles trigger follow behaviour:

Value	Behaviour
Any	Follow triggers in any vehicle
BikeOnly	Only triggers on motorcycles
TwoWheeler	Triggers on motorcycles and bicycles

---

Dismount Behaviours

When you get off your vehicle while riders are following, they react based on DismountBehavior:

Wait

Riders dismount, walk to you, and play idle scenarios (smoking, standing) at a distance. They stay nearby until you remount.

DismountBehavior = Wait
IdleScenarios = WORLD_HUMAN_SMOKING, WORLD_HUMAN_STAND_MOBILE
IdleDelayMs = 8000

• Riders dismount after IdleDelayMs
• They walk to within IdleMinStayDistance metres of you
• At IdleScenarioDistance they start playing random scenarios
• If you walk beyond IdleFollowDistance, they follow on foot
• After you remount and ResumeDelayMs passes, they resume following on their bikes

Continue

A random rider becomes the new leader, and the group keeps cruising together. You're no longer part of the convoy.

Freestyle

Riders stay on their bikes and ride in loops around you, doing wheelies and performing stunts while you're on foot.

---

Idle Scenario Reference

Scenarios are played when riders wait near the player. Common values:

Scenario	Behaviour
WORLD_HUMAN_SMOKING	Character smokes a cigarette
WORLD_HUMAN_STAND_MOBILE	Character stands on phone

More scenario IDs: GTA Forums reference

---

Bodyguard System (WIP, do not enable)

The INI contains a bodyguard system:

BodyguardEnabled = false
BodyguardRadius = 30.0
BodyguardDurationMs = 15000

Do not enable this. The bodyguard system is still under development. Enabling it may cause riders to attack each other or the player. It will be properly released in a future update.

---

Configuration Reference

Setting	Default	Description
Enabled	true	Enable follow player system
ToggleKey	F7	Manual toggle key
Mode	Dynamic	Proximity or Dynamic
FollowRadius	60.0	Trigger distance (m)
LoseRadius	200.0	Cancel distance (m)
DynamicMinSpeed	12.0	Minimum speed for Dynamic mode (m/s)
DynamicTriggerMs	2000	Sustained speed duration before Dynamic trigger (ms)
PlayerVehicleType	Any	Any, BikeOnly, or TwoWheeler
DismountBehavior	Wait	Wait, Continue, or Freestyle
IdleScenarios	WORLD_HUMAN_SMOKING, WORLD_HUMAN_STAND_MOBILE	Idle scenarios for waiting riders
IdleDelayMs	8000	Delay before dismounting for idle (ms)
ResumeDelayMs	3000	Delay after remount before resuming follow (ms)
IdleScenarioDistance	8.0	Distance to start idle scenarios (m)
IdleFollowDistance	15.0	Distance to follow on foot (m)
IdleMinStayDistance	6.0	Minimum distance riders stay near player (m)
IdleScenarioWaitMs	4000	Wait before starting a scenario (ms)
FollowMinDistance	15	Minimum follow distance for escort (m)