Description
This mod brings a GTA VI-inspired character switching experience to GTA V, allowing you to play as two configurable characters, including custom peds, while keeping the other character alive and active somewhere in the world.

Features
- Switch between two completely configurable character models using the character-switch menu.
- Configure both characters through the .ini file.
- Randomly start as either character.
- Hold X on keyboard to open the character selection menu, use Q to switch the selected character, and release X to perform the switch.
- Supports both nearby (fast, cinematic transition) and distant (dramatic sky transition) character switching.
- Inactive characters remain in the world and can walk, wander, drive, perform ambient activities, and become involved in police situations.
- Companion System: Characters can walk together, follow each other, ride in vehicles, and fight alongside each other when they encounter one another.
- Wanted & Police Behavior: Inactive characters engage hostile targets and drive aggressively during pursuits to feel like they are involved in the same situation.
- Companion map blip to track the location of the other character.
- Custom GTA VI-inspired character selection interface with portraits, input glyphs, and animations.
- Random character and world spawning, placing characters in different situations and locations.
- Custom death and respawn handling that restores configured characters after hospital respawn.

Configuration
The two playable characters are configured through CharacterSwap.ini. This allows you to use different GTA V peds instead of being restricted to the normal story characters.
Example:
PedModel1=afyepsilon01
PedModel1SpawnArea=City

PedModel2=umygabriel
PedModel2SpawnArea=City

Installation Instructions
Requirements:
ScriptHookV
ScriptHookV DotNet 3 (Used ScriptHookV Enhanced)

Refer to the readme file to see how to setup the peds.

Credits
Vorx4643