Skip to main content

Troubleshooting

No interactions start​

  • Check EnableLogs=true in scripts/InteractV/config/interactv.ini and look at the mod's console/log output.
  • Check the edition: some content exists only in the paid editions (Gamer or Partner, see Editions). A Basic install won't show it no matter the settings.
  • Experimental content is only registered when [Experimental] ExperimentalFeatures is enabled in interactv.ini; it is off by default.
  • Check RequirePlayerLos: with it enabled (the default), the player needs to see at least one of the two peds for an NPC-vs-NPC interaction to start.
  • Nearby law enforcement, a recent corpse, active gunfire, or another ped too close can all cancel or block an interaction from starting.

Police routes don't start​

Arrests and police response are part of the paid Gamer and Partner editions; on Basic they simply aren't installed (see Editions). With a paid edition installed, make sure:

  • [Experimental] ExperimentalFeatures is on if you expect a behavior that is still considered experimental.

There is no [Premium] section and no license key: if police content is missing, reinstall the archive for your paid tier rather than editing the INI.

  • The edition is fixed at build time, not by a setting. If you expected paid content and don't have it, you are running a Basic archive; re-download the Gamer or Partner archive from Patreon (see Editions).
  • There is no [Premium] LicenseKey key in interactv.ini anymore: nothing to paste, and no activation step.

Audio silent​

  • Check [Audio] Mp3Enabled is true if you expect the pre-recorded voice lines (scripts/InteractV/audios/mp3/).
  • Native GTA speech banks are configured in scripts/InteractV/audios/speeches.xml.
  • For AI text-to-speech, [ElevenLabs] ApiKey (or the INTERACTV_ELEVENLABS_API_KEY environment variable) needs to be configured; TTS won't work without a key or already-cached audio. This section isn't shipped in the INI by default; add it yourself if you use TTS.

A state/action doesn't seem to work​

Stick to action names that already exist in the built-in content, or ones added by your own plugin; see Customizing. An unknown action logs a warning and falls back to IDLE.