Skip to main content

Groups

Street Riders organises motorcycle gangs into groups. Each group is tied to specific GTA V zones, active hours, bike models, and behaviour settings.


Group Configuration

Groups are defined in [Group_XXX] sections in the INI. The XXX suffix must be listed in the Groups setting under [General].

[General]
Groups = Families, Ballas, Vagos, Salva, Default

Example: The Families

[Group_Families]
Enabled = true
Chance = 12
PedModels = g_m_y_famca_01, g_m_y_famdnf_01, g_m_y_famfor_01
BikeModels = BF400, SANCHEZ2
MixedVehicles = true
BikeColors = 0, 2, 38
DoWheelie = true
Zones = CHAMH, STRAW
ActiveHourStart = 18
ActiveHourEnd = 4
CanFollowPlayer = true
BlipColor = 2
BlipName = Families

Required Settings

SettingDescription
EnabledMust be true for the group to spawn
ChanceRelative spawn weight (higher values increase spawn probability)
PedModelsOne or more ped model names; each rider picks randomly from this list
BikeModelsOne or more bike spawn names
ZonesGTA V zone codes; leave empty to spawn everywhere
ActiveHourStart / ActiveHourEndTime window when the group is active (24h format, wraps at midnight)

Optional Settings

SettingDefaultDescription
MixedVehiclestrueRound-robin bikes so each rider gets a different model
BikeColors(random)Comma-separated GTA V paint color IDs
DoWheelietrueEnable wheelies for this group
CruiseModeInherits from DefaultCruiseModeOverride cruise behaviour; see Zones
TerritoryChance50Territory chance when CruiseMode is Mixed
TerritoryRadius150.0Max cruise distance from spawn
Weapons(none)Optional weapons; see Known Issues
CanFollowPlayertrueAllow this group to follow the player
BlipSprite226Override blip icon
BlipColor3Override blip colour
BlipScale0.7Override blip size
BlipName(none)Blip label text

Bike Models

Choose from vanilla GTA V motorcycles. Addon bikes work if installed correctly via OpenIV; use the addon's spawn name.

Sport / Street: BATI, BATI2, AKUMA, CARBONRS, DOUBLE, HAKUCHOU, NEMESIS, PCJ, RUFFIAN, LECTRO, DIABLOUS

Off-Road / Dirt: SANCHEZ, SANCHEZ2, BF400, MANCHEZ, ENDURO, CLIFFHANGER, GARGOYLE

Cruiser / Chopper: DAEMON, HEXER, INNOVATION, WOLFSBANE, ZOMBIEA, ZOMBIEB, RATBIKE, CHIMERA

Full list: Motorcycle models

MixedVehicles

When MixedVehicles = true, each rider in the group gets a different bike from the list (round-robin). When false, all riders share one randomly-picked model.

BikeColors

GTA V paint color IDs applied to spawned bikes. Leave empty for game default random colours. Common values:

IDColourIDColour
0Black88Yellow
12Red120Purple
27Blue135White
38Green145Chrome

Full list: Vehicle Colors


Active Hours

Groups only spawn during their configured time window. Hours are in 24-hour format and wrap around midnight: a group active from 18 to 4 is active from 6 PM to 4 AM.

ActiveHourStart = 18
ActiveHourEnd = 4

The global defaults apply if a group doesn't set its own:

DefaultActiveHourStart = 0
DefaultActiveHourEnd = 23

Blip Configuration

Each group can override blip appearance on the minimap. Falls back to [General] defaults if not set.

[Group_Ballas]
BlipColor = 27 ; Purple
BlipName = Ballas

Blip sprites: 226 = motorcycle, 1 = circle, 280 = player; see Blip reference.


Weapons (Optional)

Equip groups with weapons using the Weapons setting:

; Weapons = WEAPON_PISTOL, WEAPON_MICROSMG

Important: Armed riders can enter combat with other NPCs, which may interrupt their riding behaviour. This feature is being improved. If riders stop riding unexpectedly, remove the Weapons setting from the group.