Configuration

This page documents the main settings available in interactv.ini. Values shown are those in the shipped file; if a key is missing from your INI, the mod falls back to its own internal default (usually the same value).

Embedded data and overrides

Routes, spawn triggers, groups, behaviors, and scenarios ship embedded inside the mod. Local files under scripts/InteractV/ override or add to that embedded data: drop a file with the same name in the matching folder to replace it, or a new file to add to it.

Path	Purpose
config/interactv.ini	Main runtime settings
config/territory.ini	Territory, replacement, heat, and rivalry tuning (Gamer / Partner)
config/faction_profile.xml	Faction respect event effects
config/routes/*.xml	Route definitions
config/spawn_triggers/*.xml	World-event spawn triggers
groups/*.xml	Group/faction model and loadout definitions
behaviors/*.xml	AUTO_REACT behavior profiles
scenarios/*.xml	Scenario graphs and linked modules
audios/speeches.xml	Native GTA speech bank mapping
audios/mp3/**	Pre-recorded MP3/WAV voice lines

[General]

Key	Default	Meaning
MaxInteractions	1	Maximum simultaneous route interactions
PedScanRadius	60	Candidate ped scan radius around the player, in meters
PlayerGroupType	gang	How the engine treats the player in route matching: gang, law, civil, bum, or commercial
PlayerGroups	Family	Comma-separated gang affiliation(s) for the player when PlayerGroupType = gang
RequirePlayerLos	true	NPC-vs-NPC routes only start when the player has line of sight to at least one of the two peds
ShowInteractionBlips	true	Show a subtle blip on the interaction initiator
ShowGameplayBlips	true	Show phase-colored debug blips
EnableLogs	true	Write logs
Language	en	Language for every player-facing text: menus, on-screen tips, faction SMS. en or fr
NotifyEditionOnLoad	true	Post a short ticker at startup naming the loaded edition
MenuKey	F5	Key that opens the InteractV menu
DisableDuringMissions	true	Suspend mod activity during story missions
SuppressRandomEventsDuringActivity	true	Avoid starting random scenarios while you're busy

[Experimental]

Experimental content (and currently the police/arrest content) only runs when ExperimentalFeatures is enabled.

Key	Default	Meaning
ExperimentalFeatures	false	Master toggle for systems marked experimental (off by default)
EnableTerritory	true	Territory system (gang turf ownership, contested spots), Gamer / Partner only
EnableFactionEconomy	false	Experimental faction economy, Gamer / Partner only, off by default

[Gameplay]

Player-facing gameplay choices.

Key	Default	Meaning
PlayerInvolvement	true	Allows hostile NPCs to target and pull the player into an interaction (Gamer / Partner)
PlayerInvolvementDist	15	Max distance (meters) at which a gang NPC can pull the player into an interaction
PlayerInsultTension	1	Tension added each time the player throws an insult
PlayerInsultSpeeches	(empty)	Optional comma-separated speech events for player insults
PlayerInsultSpeechBank	PlayerInsult	Speech bank used when PlayerInsultSpeeches is empty
RobberyVendorActor	true	Use a vendor ped for shop robbery scenes

[Character.*]

Per-protagonist overrides for how the engine treats the player. Shipped block: Franklin (gang, Family), Michael (civil), Trevor (gang, Lost).

Key	Meaning
GroupType	How the engine treats this character in route matching
Groups	Gang affiliation(s) when GroupType = gang

[PlayerDown]

Key	Meaning
Enabled	Enable player-downed behavior

[ActionWheel]

Key	Meaning
Enabled	Enable the phone action-wheel (MenuKey, directional controls are bound in [General])

[Traffic]

Key	Meaning
ReduceDuringBeefs	Reduce ambient traffic while gang beefs are active
ReductionPercent	How much traffic is cut during a beef, in percent

[PhoneReinforcements]

Gamer / Partner phone contacts: call your faction for backup, request drive-by support, or get a Ride Along pickup car. Localized contact names use _en and _fr suffixes.

Key	Meaning
Enabled	Faction reinforcement contact
ContactName_en / ContactName_fr	Localized contact name
DriveByEnabled	Drive-by contact
DriveByContactName_en / DriveByContactName_fr	Localized contact name
DriveByPickupEnabled	Ride Along pickup contact
DriveByPickupContactName_en / DriveByPickupContactName_fr	Localized contact name
RideAlongPickupBlipEnabled	Blip on the Ride Along pickup
DriveByTargetBlipEnabled, DriveByTargetBlipFlashes	Target blip feedback for drive-by support

[Events]

Key	Meaning
MinDistFromPlayer	Minimum distance (meters) from the player at which an event may place its units
PlayerMaxDistFoot	Max player-to-target distance for an event to fire while the player is on foot
PlayerMaxDistVehicle	Max player-to-target distance for an event to fire while the player is in a vehicle

[FactionSms]

Key	Meaning
Enabled	Send faction SMS notifications
TerritoryBatchWindowMs	Groups several territory spot flips into one text instead of spamming one per spot
IntelAbortEnabled	Also send a follow-up text when a rival threat fizzles out

The SMS language follows [General] Language above.

[Audio]

Key	Meaning
Mp3Enabled	Play pre-recorded MP3/WAV voice lines when a scenario references one; set false to force native GTA speech everywhere

[PlayerCommand] (crew commands)

Key	Meaning
Enabled	Turns crew commands on
BlipsEnabled	Blips on your crew
DestinationBlipEnabled	Blip on the ordered destination
HudEnabled	On-screen feedback for crew orders
InteractIndicators	Show interact indicators on crew members
IdleScenarios	Scenarios idle crew members can play while waiting
RecruitControl	Input bound to recruiting a nearby crew member (default the phone-right button)

[ElevenLabs]

Optional TTS section, not shipped in the INI. Add it yourself if you use the ElevenLabs voice lines.

Key	Meaning
ApiKey	Your ElevenLabs API key (can also be set via the INTERACTV_ELEVENLABS_API_KEY environment variable)
ModelId	TTS model to use
DefaultVoiceId	Default voice
Stability	Voice stability, 0-1
SimilarityBoost	Voice similarity boost, 0-1

Avoid publishing real API keys. Use placeholders in examples.