LivingLSAIs v3.3 — The Ultimate AI World Overhaul | README by Zexiva

🤖 GTA V AI World Overhaul — By Zexiva

# LIVING LS AIs

VERSION 3.3 — DUST & GLORY Patch BUGS FIXED

Los Santos is no longer a backdrop. Every NPC thinks, speaks, remembers, and reacts — powered by real AI. Choose your words wisely.

✓ 100% Free ★ v3.3 Official ⚡ Gemini Live WebSocket 🎭 Auto NPC-to-NPC System 🧠 LLaMA 3.3 70B + Gemini 🗣️ Voice + STT

## ▶ What's New in v3.3 — Dust & Glory Update

⚡
Fully Automatic NPC-to-NPC Scenes v3.2
Linking NPCs manually via menus is history! When directed by the player (e.g. "go talk to that person"), the NPC locks target, physically walks to them via the `[STARTNPCTONPC]` tag, and auto-starts a cinematic face-to-face scene conversation natively.
📻
Autonomous Radio Tag Decoupling v3.2
Fixed the long-standing nesting bug! Radio controller tags (like `[RADIO_OFF]`, `[RADIO_LOS_SANTOS]`) have been completely decoupled from the physical animation `else if` chains, allowing them to execute independently and simultaneously while driving or talking.
🎹
"LLAI" Cheat Box Menu Recall v3.2
Type "LLAI" in the GTA cheat console to instantly open the LLAI menu on demand! When opened via cheat box without active NPC targeting, all chat/mic inputs are dynamically greyed out, letting you configure Settings or manage Saved NPCs anywhere in the world.
🚗
Passenger Radio HUD & Steering Hack v3.2
Bypass GTA's locked passenger limits! While riding along in a lift, hold the Radio Wheel button to force-override vehicle settings and cycle radio stations. Complete with an elegant help HUD overlay showing station names.
🌐
Dynamic Indian Mix Dialect Router v3.2
The new 'Indian Mix' language router dynamically analyzes the NPC's profile, model hash, and location to seamlessly switch their speech between Hinglish, Haryanvi, Bhojpuri, and Khari Boli in real-time.
🛡️
Scene Turn-Limit Safeguards v3.2
A hardcoded minimum of 3 exchanges is enforced before `[STOPARGUEMENT]` can execute. This prevents lazy AI models from terminating a scene prematurely on Turn 1 or 2, ensuring rich dialogue.
🩸
Physical Surrender Animations v3.2
Aukaat check physical surrender animations fully implemented. Beating an NPC triggers real physical animations! Staggering (chest clutch), hunched-over defeat, and hands-on-knees breathing are dynamically played to represent their beaten state.
🎮
FPP Passenger Camera Fix Guide v3.2
Step-by-step guidance on resolving Rockstar's driver-only FPP cockpit rendering using specialized camera mods (like Alternate First Person V2.0 or ViewpointV).
🙈
Immersive Chatbox Hide Mode v3.1
New toggle option in the LLAI menu: Hide Chatbox. Fully hides the conversation UI — no subtitles, no chat panel, no HUD overlay. Just you, the NPC, and their voice. Pure immersion mode for roleplayers.
👤
Saved Memory NPCs — Spawn & Remember v3.1
Save NPCs you've built a relationship with as a named profile. Spawn them back anytime from the LLAI menu — same model, same personality, and full access to all their saved memories.

#### 🗑️ Removed / Changed from v3.1 → v3.2

- Nesting Radio Bug: Removed the nested `else if` chain of radio controller tags. Radio tags are now evaluated independently and execute instantly on active vehicle objects.
- Manual Scene Linking: The clunky manual "Select NPC A" and "Select NPC B" step has been replaced with the automatic `[STARTNPCTONPC]` tag workflow.
- Trainer-Spawned Theft Warnings: Refined vehicle theft algorithms to bypass mod/trainer-spawned vehicles so NPCs don't falsely label you as a carjacker.
- Cerebras Removed: Dropped entirely in v3.0. Groq + Gemini cover all use cases faster and more reliably.
- Nested scripts/scripts/ Folder: Replaced with clean `LLAI SERVER/` folder inside `scripts/`.

01 // Release Status & Download
★ v3.2 Official Release
This is the v3.2 Official Release — the Dust & Glory Update. Completely automates the NPC-to-NPC Scene System, decouples the vehicle radio tags from nested limits, adds "LLAI" Cheat Box Menu Recall, implements the Passenger Radio HUD, and deploys physical surrender animations alongside the Dynamic Indian Mix language router.
✓ Official Download
Download from official mod platforms:
• GTA5-Mods.com (Primary)
• Nexus Mods (Mirror)
Random file sharers often ship outdated or tampered builds. Always verify the version number matches v3.2!
💬 Discord: discord.gg/g7d8uAKya — support, updates, and bug reports.
02 // What Is This Mod?

You've been playing GTA V for over a decade. The same three lines, the same scripted reactions, the same dead city. NPCs existed only as obstacles between missions.

LivingLSAIs permanently changes that.

Every NPC in Los Santos now has a real AI brain powered by Groq (LLaMA 3.3 70B) or Google Gemini Live, a real voice, persistent local memory, and dynamic behaviors. They remember conversations, react to your crimes in real-time, know where they are and what they're doing, judge your car, hear your radio, and beg for their lives if you beat them hard enough.

v3.2 goes even further: for the first time, two NPCs can now have an AI conversation with each other completely automatically — triggered organically during standard chat via prompt tags, with a built-in 3-turn safeguard to prevent lazy AI shutdowns.

This isn't a mod. It's a social experiment. Good luck.

03 // Core Features
⚡
Gemini Live WebSocket
A persistent WebSocket bridge between GTA and Google's Gemini Live API. Ultra-fast responses, real-time audio streaming, and zero per-message HTTP overhead. The fastest NPC responses you've ever seen in a mod.
🎭
Auto NPC-to-NPC Scenes v3.2
Automatic targeting and cinematic setup! NPCs can now physically walk over to nearest bystanders using the `[STARTNPCTONPC]` tag and auto-trigger face-to-face scene conversations with a hard 3-turn minimum safeguard.
😤
Gangster Aggression System
Gang member NPCs (Ballas, Vagos, etc.) now instinctively respond to disrespect with [CALLGANG], [FIGHT], or [SHOOT] — never compliance. Gangsters don't comply.
🚗
Vehicle Window Chat
Talk to NPCs who are seated in their own parked vehicles. They stay seated while chatting through the window. The vehicle is frozen in place. They can [DRIVEAWAY] to escape or [OUTOFVEHICLE] to step out.
📡
Live Activity Awareness
NPCs know exactly what they're doing right now — jogging, sitting at a bench, eating, talking on the phone, or parked at a red light. Their responses naturally reference their current activity.
🧠
LLaMA 3.3 70B Brain
NPCs run on LLaMA 3.3 70B via Groq for fast, smart responses. Auto-rotates up to 5 keys to bypass rate limits. Truly contextual, not scripted.
🩸
Aukaat Check Surrender v3.2
Beat an NPC to low health and their ego shatters. They stagger physically (using chest clutch or hunched-over animations), drop the tough-guy act, and beg for mercy using [KNEEL] or [HANDSUP].
🤝
Homie & Accomplice System
Earn trust with [BECOMEHOMIE] — NPC gets AK-47, 10x health, follows and protects you. [ACCOMPLICE] makes them a silent crime partner. [BROKEHOMIE] breaks the bond.
👁️
100m Witness System
NPCs witness crimes in a 100m radius. Shoot, punch, carjack, blow things up, or leave dead bodies — they remember, react live, and their story changes for the whole conversation.
📍
Waypoint Lift System
Set a GPS Waypoint on your map, ask any driver NPC for a ride, and they drive you there using native GTA pathfinding. [PAUSELIFT] to pull over, [ENDLIFT] on arrival.
📻
Vehicle & Radio Awareness
NPCs know your car brand, color, dirt level, and body damage. They also hear your radio station and roast your music taste based on their neighborhood and character.
🏠
Interior Awareness
NPCs know exactly where they are — Strip Club, Ammu-Nation, Barbershop, Liquor Store. Dialog and attitude adapts to the environment dynamically.
🔫
Gunpoint Detection
Aim a weapon at an NPC while talking and they realize they're a hostage. Forces compliance with [HANDSUP], [KNEEL], or [GIVEMONEY].
🧬
Persistent Memory v2
NPCs remember your past interactions with a local JSON profile. Tracks relationship score, up to 8 key historical events, and holds grudges or builds trust across sessions.
🗣️
Expanded Language Support v3.2
English, Spanish, Portuguese, Japanese, French, Italian, Chinese, and the new Indian Mix context-dialect router (Hinglish, Bhojpuri, Haryanvi, and Khari Boli). Cycle instantly in-game!
🐕
Animal Personalities
Animals bypass TTS. They use unique instinct-driven thought blocks paired with native GTA animal sounds. No fake animal voices — pure lore-accurate behavior.
04 // All Action Tags — Complete Dictionary

These are the commands the AI injects at the end of replies to trigger real in-game actions. The AI uses them based on context — you don't type them manually, you provoke them through conversation. Tags marked v3.2 are brand new or upgraded.

Tag | Description & Example
--- | ---
🩸 Combat & Surrender (Aukaat System)
[FIGHT] | NPC charges you with fists/melee."You want a piece of me? Let's go! [FIGHT]"
[SHOOT] | NPC draws a weapon and opens fire. Lethal."Wrong day, wrong guy. [SHOOT]"
[AIMWITHGUN] v3.2 | 50% of NPCs warning-aim a handgun at you before deciding to fire."Back off, or I'll put a bullet in you! [AIMWITHGUN]"
[STOPFIGHT] v3.2 | Forces NPC to stop attacking and stand down. Pre-programmed as a failsafe on low-health surrender."Okay okay, you win! [STOPFIGHT]"
[FLEE] | NPC panics and sprints away in terror."You're insane! I'm gone! [FLEE]"
[HANDSUP] | Raises hands in surrender. Auto-forced at gunpoint."Don't shoot! I give up! [HANDSUP]"
[KNEEL] | Drops to one knee in defeat. Triggered by Aukaat Check or gunpoint."Please, I have a family! [KNEEL]"
[HANDSDOWN] v3.2 | Lowers hands from surrender state and stands normally."Alright, I'm putting them down now. [HANDSDOWN]"
[STOPSHOOTING] v3.2 | Stops active weapon discharge and holsters the firearm."I'm putting the gun away. [STOPSHOOTING]"
[STOPAIMING] v3.2 | Lowers weapon from free-aiming state."Lowering the weapon, we're cool. [STOPAIMING]"
[STANDUP] v3.2 | Stands back up from kneeling stance."Let me stand back up. [STANDUP]"
🤝 Social & Allies
[BECOMEHOMIE] v3.2 | NPC becomes permanent bodyguard (AK-47, 10x health boost, auto-follow)."You earned it. I got your back for life. [BECOMEHOMIE]"
[ACCOMPLICE] v3.2 | NPC becomes a silent crime partner — won't force-follow but shoots with you."I see you. I got you. [ACCOMPLICE]"
[STOPACCOMPLICE] v3.2 | Cancels the accomplice role — NPC returns to neutral."We're done here. Go your own way. [STOPACCOMPLICE]"
[BROKEHOMIE] v3.2 | Breaks the Homie bond, resetting health and taking back weapons."You crossed the line. We're done. [BROKEHOMIE]"
[ROBPLAYER] v3.2 | NPC suddenly pulls a weapon and steals your cash!"You thought I was easy? Wallet. Now. [ROBPLAYER]"
[TAKEPLAYERWEAPON] v3.2 | Lethal/opportunistic thief NPC steals player's current weapon with all attachments."Nice gun. I think I'll take it. [TAKEPLAYERWEAPON]"
[GIVEMONEY@AMOUNT] v3.2 | Hands over a specific cash amount to the player (e.g. [GIVEMONEY@250])."Here, take some cash! Just leave me! [GIVEMONEY@100]"
[CUTMONEY] v3.2 | Deducts cash from player wallet. Used during robbery or paid services."Pleasure doing business. [CUTMONEY]"
[PLUSPOINTSFRIENDS] v3.2 | Friendship meter increments (+1 trust block). Max 5 blocks total."That actually means a lot, thanks. [PLUSPOINTSFRIENDS]"
[FOLLOW] | NPC agrees to follow you around as a companion."Alright, I'll come with you. [FOLLOW]"
[STOPFOLLOWING] | Cancels the follow — NPC stays in place."I'll wait here. Stay safe. [STOPFOLLOWING]"
🚓 Emergency Services
[CALLCOPS] | NPC calls police. Raises your wanted level."I'm calling the cops right now! [CALLCOPS]"
[CALLCOPS2] v3.2 | Dispatches a police cruiser patrol WITHOUT adding a wanted level."There's a suspicious person around here, officer. [CALLCOPS2]"
[CALLGANG] | Calls armed gang backup — thugs spawn and attack you. Used heavily by gangster peds."Ballas! Get over here, we got a problem! [CALLGANG]"
[CALLFIRE] v3.2 | Dispatches a fire engine to your location."It's on fire! I'm calling 911! [CALLFIRE]"
[CALLAMBULANCE] v3.2 | Dispatches an ambulance to your location."He's bleeding out! I need a medic! [CALLAMBULANCE]"
🚗 Vehicles & Lift System
[LIFT] | NPC agrees to drive you to your active Map Waypoint."Set your GPS and hop in. [LIFT]"
[PAUSELIFT] v3.2 | NPC pulls the car over. Press F to resume the ride."Pulling over real quick. [PAUSELIFT]"
[ENDLIFT] v3.2 | NPC stops and ends the ride (used when destination is reached)."Here's your stop. Stay safe out there. [ENDLIFT]"
[HONK] v3.2 | NPC honks the car horn — usable during rides."MOVE! We're in a hurry! [HONK]"
[DRIVEAWAY] v3.2 | NPC drives away in their own vehicle, ending the conversation. Only valid when NPC is seated in their own car."I'm not dealing with this. Bye. [DRIVEAWAY]"
[OUTOFVEHICLE] v3.2 | NPC steps out of their own vehicle to continue the conversation on foot."Alright, let me get out so we can talk properly. [OUTOFVEHICLE]"
🎭 NPC-to-NPC Scene System
[STARTNPCTONPC] v3.2 | Automatically locks onto the nearest bystander, walking to them and launching a face-to-face scene."Wait here, let me go ask him. [STARTNPCTONPC]"
[STOPARGUEMENT] v3.2 | Used by NPCs in a Scene to naturally end their autonomous conversation. Locked out on Turn 1 & 2 via compiler safeguards."Alright man, catch you later. [STOPARGUEMENT]"
🎭 Animations & Expressions
[DANCE] | NPC starts a continuous dance loop."Okay okay, watch these moves! [DANCE]"
[STOPDANCE] | Stops the dance animation."Alright, that's enough dancing. [STOPDANCE]"
[PUSHUP] v3.2 | NPC drops and does push-ups."Light weight, baby! Watch this. [PUSHUP]"
[SITDOWN] v3.2 | NPC sits down on the ground."My feet are killing me. [SITDOWN]"
[CLAP] v3.2 | NPC claps — admiration or sarcasm."Wow. Just... wow. Truly pathetic. [CLAP]"
[SMOKE] v3.2 | NPC lights a cigarette."This city stresses me out. I need a hit. [SMOKE]"
[RADIO_*] v3.2 | Decoupled! NPC changes your car's radio station (e.g. `[RADIO_LOS_SANTOS]`, `[RADIO_REBEL]`, `[RADIO_OFF]`) independently of animation blocks."This music's trash, let me fix that. [RADIO_LOS_SANTOS]"

05 // Requirements

Skip this section and you deserve every crash you get.

Component | Requirement | Status
--- | --- | ---
GTA V | PC version (non-Epic works too) | Required
ScriptHookV | Latest version — alexander blade | Required
ScriptHookVDotNet Nightly | v3.7.0+ — NIGHTLY BUILD specifically | Required
LemonUI | LemonUI for SHVDN3 | Required
Node.js | v18+ — Required for Gemini Live Bridge | Required for Gemini
NAudio.dll | Included in zip | Included
Newtonsoft.Json.dll | Included in zip | Included
.NET Framework | 8.0 or newer | Required
Groq API Key | Free at console.groq.com — AI brain | Required
Gemini API Key | Free at aistudio.google.com — TTS + Live Bridge | Strongly Recommended
UnrealSpeech Key | Free at unrealspeech.com — Alternative TTS | Optional

⚠ Critical — SHVDN Nightly Required
You MUST use the latest SHVDN Nightly build (v3.7.0+). The standard release build is outdated and will throw a `MissingMethodException` and refuse to load the mod. Download from: github.com/scripthookvdotnet-nightly
06 // What is Node.js? (The Bridge Explained)
⚡ 100% Plug-and-Play — Zero System Installation Required!
Good news: You do NOT need to download or install Node.js on your computer! The required Node portable runtime (`node.exe`) is already pre-packaged inside the zip file under the `LLAI SERVER/LLAIBridge/` folder. Just copy everything over, and the bridge will work automatically out-of-the-box!

#### 🤔 What is Node.js?

Node.js is a lightweight runtime environment that allows JavaScript code to execute locally. To keep your setup clean and simple, a compact, portable version of Node (`node.exe`) is included directly inside the mod directory.

#### ⚡ Why does the mod need it?

Google's Gemini Live API requires a persistent, real-time WebSocket connection to stream audio instantly without stuttering. C# GTA mods can't maintain this connection natively without lag, so this portable Node backend quietly handles the WebSocket traffic in the background.

The seamless connection flow:

# How the real-time Gemini Live communication flows:
You speak → GTA Mod (C#) → localhost WebSocket → Pre-packaged Node.js Bridge (server.js) → Google Gemini Live API
NPC voice + text ← GTA Mod (C#) ← localhost WebSocket ← Pre-packaged Node.js Bridge ← Google Gemini
# The pre-packaged bridge auto-launches in the background when the mod loads. Zero manual configuration needed!
07 // Installation Guide
1
Install ScriptHookV + SHVDN Nightly
Download ScriptHookV from dev-c.com and place `ScriptHookV.dll` + `dinput8.dll` in your GTA V root folder. Then download the SHVDN Nightly build from GitHub and place `ScriptHookVDotNet3.dll` + `ScriptHookVDotNet.asi` in your GTA V root folder.
2
Install LemonUI
Download LemonUI for SHVDN3. Copy `LemonUI.SHVDN3.dll` into your `GTA V/scripts/` folder. Create the `scripts` folder if it doesn't exist.
3
Delete Old LivingLSAIs Files
Remove any previous `LivingLSAIs.dll`, `LivingLSAIs.cs`, or `LivingLSAIs.ini` from your `scripts/` folder. Also delete any old `npc_memory/` or `scripts/scripts/` folders. Deleting these prevents compatibility crashes.
4
Copy Mod Files (Drag & Drop)
Extract the downloaded mod zip. Copy `LivingLSAIs.dll` and `LivingLSAIs.ini` into `GTA V/scripts/`. Copy the LLAI SERVER folder (with LLAIBridge inside) into your `GTA V/scripts/` folder.
5
Add Your API Keys
Open `scripts/LivingLSAIs.ini` in Notepad and paste your API keys. Save the file, launch the game, and you are ready to play!
📂 Auto-Generated Files
On first load, the mod automatically creates `LLAI SERVER/npc_memory/` for NPC memories, `LLAI SERVER/LLAIsession.log` for debugging, and `LLAI SERVER/LLAIcrashreport.log` for crash info. Do not create these manually.
08 // Folder Structure — v3.2 Clean Layout

The LLAI SERVER folder lives directly next to your GTA V root folder where `GTA5.exe` runs. A highly optimized, reliable file setup.

GTA V/ ← Your GTA V root folder (where GTA5.exe is)
├── GTA5.exe
├── ScriptHookV.dll
├── ScriptHookVDotNet.asi
├── ScriptHookVDotNet3.dll
│
├── scripts/ ← ScriptHookVDotNet folder
│ ├── LivingLSAIs.dll ← Compiled mod (you copy this)
│ ├── LivingLSAIs.ini ← Your API keys & settings (edit this!)
│ ├── LemonUI.SHVDN3.dll
│ ├── NAudio.dll
│ └── Newtonsoft.Json.dll
│
└── LLAI SERVER/ ← Place this next to GTA5.exe!
├── LLAIBridge/ ← Gemini Live WebSocket bridge
│ ├── server.js ← The bridge server
│ └── node.exe ← Pre-packaged Node.js runtime
│
├── npc_memory/ ← Auto-created: NPC memory JSON files
├── llai_reply_current.wav ← Auto: TTS audio buffer
├── LLAIsession.log ← Auto: Debug log
└── LLAIcrashreport.log ← Auto: Crash report
✓ What YOU Create Manually

- Create `LLAI SERVER/` folder in GTA V root (next to GTA5.exe)
- Create `LLAI SERVER/LLAIBridge/` folder and drop in `server.js` + `node.exe`
- Everything else (`npc_memory/`, logs, .wav files) — the mod creates automatically on first run

09 // API Key Setup — Groq & Gemini

The mod talks to real AI servers. It needs API keys. Both Groq and Gemini are completely free. No credit card needed for basic usage.

Required — AI Brain
🧠 Groq
Powers the NPC's intelligence using LLaMA 3.3 70B. The fastest free LLM available. Required for all conversations.

- Go to console.groq.com
- Sign up (free, no card needed)
- Go to API Keys → Create API Key
- Copy the key (starts with `gsk_`)
- Paste into `LivingLSAIs.ini`

→ console.groq.com
Strongly Recommended — Voice + Live Bridge
✨ Google Gemini
Powers two things: (1) Gemini Live WebSocket for ultra-fast NPC responses, and (2) Google TTS for expressive NPC voices with emotional audio tags like `[laughs]`, `[whispers]`.

- Go to aistudio.google.com/apikey
- Sign in with your Google account
- Click Create API Key
- Copy the key (starts with `AIza`)
- Paste into `LivingLSAIs.ini`

→ aistudio.google.com
Optional — Alternative Voice
🎙️ UnrealSpeech
Alternative TTS engine. Good natural voices if you prefer not to use Gemini TTS. Can be used alongside Gemini as a fallback.

- Go to unrealspeech.com
- Sign up (free tier available)
- Copy your key from the dashboard
- Paste into `LivingLSAIs.ini`

→ unrealspeech.com

Open `scripts/LivingLSAIs.ini` in Notepad and fill in your keys:

# ─── LivingLSAIs v3.2 — Configuration File ───
# PRO TIP: Add up to 5 keys per service for auto-rotation on rate limits!
# ── GROQ (Required — AI Brain) ──
GroqKey1=gsk_YourFirstGroqKeyHere
GroqKey2=gsk_OptionalSecondKeyForRotation
# ── GEMINI (Strongly Recommended — TTS + Live Bridge) ──
GeminiKey1=AIzaYourGeminiKeyHere
GeminiTTSKey1=AIzaSameKeyOrDifferentOne
# ── UNREALSPEECH (Optional — Alternative Voice) ──
UnrealSpeechKey1=YourUnrealSpeechKeyHere
# ── TTS ENGINE: "gemini" for Google voices, "unrealspeech" for Unreal ──
TtsEngine=gemini
# ── LLM PROVIDER: "groq" or "gemini" ──
LlmProvider=groq
# ── LANGUAGE: "english", "hinglish", "haryanvi", "bhojpuri", "khari boli", "indian mix", "spanish", "portuguese", "japanese", "french", "italian", "chinese" ──
LanguageMode=english
# ── SWEARING: true/false ──
EnableAbusingWords=true
💡 Pro Tip — Key Rotation
Add up to 5 Groq keys (`GroqKey1` through `GroqKey5`) and up to 5 Gemini keys. The mod auto-rotates between them when one hits a rate limit — so conversations never pause. Free tier limits are generous but rotation makes it bulletproof.
10 // How to Play — Controls

The mod runs entirely on keyboard inputs. No mouse needed for menus.

E Proximity Toggle: Walk near an NPC → press E to lock focus → press E again within 4s to open chat.
LLAI (cheat) Menu Recall: Type LLAI as a cheat code on foot or in vehicles to recall settings or respawn NPCs instantly.
T Type Message: Opens text input. Type your message, press Enter to send.
Y (hold) Voice Input: Hold Y to record your voice. Release Y to send and process speech.
↑ ↓ ← → Menu Navigation: Arrow keys move through menu options. Camera stays free while navigating.
ENTER Select: Confirm menu item or trigger an action from the menu.
ESC Minimize Menu: Hides the menu without ending the conversation. Press E to reopen.
BACKSPACE End Conversation: Fully closes the session and releases the NPC.
F (during Lift) Resume Ride: After NPC pulls over with [PAUSELIFT], press F to continue the ride.
Q (during Lift) Passenger Radio Wheel: Hold Q as passenger during a lift to activate custom radio HUD overlays.
🎭 How to Use the NPC-to-NPC Scene System
Watch two NPCs have an autonomous AI conversation! Simply talk to NPC A, ask them to talk to another nearby bystander (e.g., "Ask that guy where the closest bar is"), and NPC A will lock onto the bystander, physically walk to them, and trigger a natural face-to-face scene conversation automatically. The scene has a hard 3-turn minimum safeguard and ends organically after a natural conclusion.
11 // Troubleshooting
Game crashes on startup / MissingMethodException
You're using the standard SHVDN release, not the Nightly. Download the latest Nightly build from GitHub. Replace `ScriptHookVDotNet3.dll` and `ScriptHookVDotNet.asi` in your GTA V root.
NPCs are completely mute / no voice at all
Check: (1) Did you add a Gemini key or UnrealSpeech key? Voice requires at least one TTS key. (2) Is your `TtsEngine` in the ini set to `gemini` or `unrealspeech`? (3) Is `LLAI SERVER/` writable? Check `LLAI SERVER/LLAIsession.log` for TTS errors.
Why does the camera point at the vehicle hood/bumper during FPP passenger seats?
By default, Rockstar Games never modeled internal passenger cockpit view-planes for standard civilian vehicles. Even when using camera plugins (like Dynamic First Person Camera by ikt), the plugin disables itself on passenger seats, letting the vanilla game engine default back to hood-mounted projections. To bypass this, install Alternate First Person V2.0 or ViewpointV from GTA5-Mods.com. These ASI plugins hook into coordinates directly at the player head bone, granting real passenger cabin views.
Gemini Live Bridge not connecting / "Bridge files missing" notification
Ensure that the `LLAI SERVER` folder is placed inside your GTA V/scripts/ folder, NOT next to `GTA5.exe`. It must contain `LLAIBridge/server.js` and the pre-packaged `node.exe`. Also, make sure you have added a valid `GeminiKey1` in your `LivingLSAIs.ini` file.
Getting 429 Too Many Requests error
You're hitting Groq or Gemini rate limits. Fix: Add more keys! Use `GroqKey2`, `GroqKey3`... up to 5 keys each. The mod auto-rotates. Free tier is generous — 3+ keys is usually enough for heavy use.
NPC exits their vehicle when I try to talk to them through the window
Make sure you're running v3.2. Earlier builds (including v3.0) had a bug where `CLEAR_PED_TASKS_IMMEDIATELY` was accidentally called on seated NPCs, causing GTA to force them out of the vehicle and freeze the car in place. v3.1 and v3.2 fully prevent this — NPCs now stay seated and chat naturally through the window.
NPC Scene ends after only 2-3 messages
This was a v2.2 bug — the AI prompt said "4-8 exchanges" and the AI treated 4 as the minimum. v3.2 enforces a hard coded minimum of 3 exchanges, and ignores `[STOPARGUEMENT]` tags on Turn 1 & 2, ensuring rich conversation before ending.
NPC headshot photo is wrong / shows previous NPC's photo
Fixed in v3.0 with a dual-slot headshot system. Both NPC A and NPC B headshots are pre-registered at scene start. When the speaker switches, the pre-cached TXD swaps instantly — no more blank or wrong photo.
📋 Always Include Logs When Reporting Issues
When asking for help, always attach:
• `LLAI SERVER/LLAIsession.log` — LLAI runtime log (in GTA V root)
• `ScriptHookVDotNet.log` from your GTA V root — SHVDN loader errors
How do I hide the chatbox for a fully immersive experience?
Open the LLAI in-game menu → Settings → Hide Chatbox and toggle it ON. This completely removes the subtitle panel and chat HUD — only the NPC's voice plays. Toggle it back OFF from the same menu whenever you want the UI back. Works with both Groq and Gemini Live modes.
How does the Saved Memory NPCs system work?
After building a relationship with any NPC, open the LLAI menu → Saved Memory NPCs → Save Current NPC. Give them a name and their model, personality notes, and full conversation memory are saved to a local profile. To respawn them later, go to Saved Memory NPCs → Spawn NPC, pick their name from the list, and they'll spawn near you — same ped model, and fully aware of your shared history from past sessions. Their memory JSON is stored in `LLAI SERVER/npc_memory/saved/`.
Will using my own API keys get my accounts banned?
No. Standard single-player gameplay usage is completely safe. Never share your personal API keys with anyone. The mod processes roleplay content client-side, meaning your keys are highly unlikely to be flagged for casual in-game conversations.
Does this work in GTA Online?
NO. Single player only. If you try it in GTA Online, Rockstar will ban you and you'll deserve it. Script mods + Online = permanent ban. No exceptions.
Can I use Google Gemini voices instead of UnrealSpeech?
Yes — and it's the recommended option in v3.0! Set `TtsEngine=gemini` in your ini and add a `GeminiTTSKey1`. Gemini TTS supports expressive audio cues like `[laughs]`, `[whispers]`, `[sighs]`, `[exhales]` — NPCs actually sound emotional, not robotic.
What's the difference between Groq and Gemini Live for the AI brain?
Groq (LLaMA 3.3 70B): REST API — fast, reliable. Best for text-heavy conversations. Gemini Live: WebSocket bridge — ultra-fast real-time responses with built-in audio. Best for immersive real-time roleplay. Both are pre-packaged and ready to use. Set `LlmProvider=gemini` in the config to switch. Both require their respective API keys.
How do I change NPC language?
Open the LLAI in-game menu → Settings → Language Mode → Choose your language. Or set `LanguageMode=english|hinglish|haryanvi|bhojpuri|khari boli|indian mix|spanish|portuguese|japanese|french|italian|chinese` in the ini. Supported languages:
English: Standard American English.
Hinglish: Authentic Hindi-English street slang mix.
Indian Mix: Dynamic dialect router based on NPC identity.
Spanish: Spanish with local street slang.
Portuguese: Brazilian Portuguese (Mano, Cara, Parça).
Japanese: Japanese (Anata, Omaera, Kimi).
French: French (Mon ami, Mec, Putain). Males use English voice.
Italian: Italian (Ciao, Fratello, Amico).
Chinese: Mandarin Chinese.
NPCs will immediately switch to the selected language on the next conversation.
Do NPCs actually remember me between game sessions?
Yes! Each NPC has a local JSON profile saved in `LLAI SERVER/npc_memory/` (in GTA V root). It stores their relationship score with you, up to 8 key events from past conversations, personality notes, and more. These persist across sessions — NPCs hold grudges, build trust, and reference your past interactions.

13 // What's New In v3.2
💵
Exact Money Giving System v3.2
NPCs can now give precise cash amounts using tags such as `[GIVEMONEY@50]`, `[GIVEMONEY@500]`, and `[GIVEMONEY@25000]`. Physical cash pickups spawn in the world for greater immersion.
👥
Advanced NPC Awareness v3.2
NPCs understand who is nearest to them, recognize nearby people, reference strangers naturally, and know exactly who the player is talking about. They can detect nearest NPCs, understand context, mention strangers, recognize familiar faces, react to crowds, and use nearby NPCs in scenes.
🎭
Expanded Behaviour System v3.2
LivingLSAIs now supports 20 behaviour modes: Default, Angry, Ultra Roaster, Savage, Polite, Psychopath, Introvert, Kind, Selfish, Dumb, Conspiracy, Flirty, Depressed, Gangster, Philosopher, Comedian, Drunk, High IQ, Disciplined, and Chapri. These influence speech, reactions, social interactions, aggression, humour, and decision-making for ultra-realistic roleplay.
📖
Dynamic Backstory System v3.2
Anything written between asterisks (*) becomes the NPC's personal history.
Examples:
`*Raised by gangsters in Davis*`
`*Former military sniper*`
`*Ex-stunt driver trying to change his life*`
No presets — unlimited roleplay possibilities!
🌍
Expanded Language Support v3.2
NPCs can naturally communicate using:
• English
• Hindi
• Bhojpuri (e.g. "Ka haal ba bhai?")
• Haryanvi (e.g. "Ke haal se?")
• Khari Boli (e.g. "Kya baat hai?")
• Indian Mixed Hinglish (e.g. "Bro scene thoda risky hai.")
🧠
Smarter Social Intelligence v3.2
NPCs understand social context, recognize familiar faces, react to crowds, and use nearby NPCs during conversations and scene generation for more believable interactions.
🎬
Enhanced NPC-to-NPC Scenes v3.2
Scene generation now dynamically uses nearby NPCs, relationships, personality, context, environment awareness, and social intelligence. No two scenes are exactly the same.
✨ LivingLSAIs v3.2
NPCs no longer simply answer questions. They observe. They improvise. They react. They remember context. Los Santos feels more alive than ever before.
🎭 Real NPC Task Example
Player: "Go ask that man where the nearest petrol pump is."
NPC A: "Alright, I'll ask."
(NPC A walks to NPC B)
NPC A: "Hey, do you know where the nearest petrol pump is?"
NPC B: "Yeah, there's one two blocks down near the highway."
NPC A: "Thanks."
(NPC A returns to the player)
NPC A: "He said there's a petrol pump two blocks away near the highway."
NPCs can now gather information from other NPCs and naturally report back — full immersion unlocked!
14 // Credits & Legal

Mod Author: Zexiva — creator and lead developer of LivingLSAIs.

Special Thanks: AbirTheLegend — for contributions, ideas, support, testing, and helping shape LivingLSAIs into what it is today.

AI Backends: Groq (LLaMA 3.3 70B), Google Gemini Live, UnrealSpeech, OpenAI Whisper (STT)

Foundation: crosire (ScriptHookVDotNet), alexander blade (ScriptHookV), justalemon (LemonUI)

📜 Strict Distribution Policy
This mod is 100% FREE and is the intellectual property of Zexiva.
RE-UPLOADING IS STRICTLY FORBIDDEN. Under no circumstances are other individuals authorized to re-upload, host, repackage, or distribute these mod files on any platform, mirror, or Discord server. Always link to the official Nexus Mods page.
Use at your own risk. The author is not responsible if your PC, game, save file, or ego explodes. This is a fan-made mod with no affiliation to Rockstar Games.