LivingLSAIs v4.0 — The Next Generation of Open-World AI

📋 Table of Contents

01 Release & Download 02 What Is This Mod? 03 Core Features 04 Legacy Feature Archive 05 All Action Tags 06 Requirements 07 What is Node.js? 08 Installation Guide 09 Folder Structure 10 API Key Setup 11 How to Play 12 Troubleshooting 13 FAQ & Safety 14 Legacy Release Notes 15 Credits & Legal

01 // Release Status & Download

★ v4.0 Major Release

This is the **v4.0 Official Release** — our most massive upgrade yet. It introduces active real-time Multimodal Vision, the Menuless Direct-Talk System, the brand-new Clothing, Convenience, and Ammu-Nation Shopping Routine Systems, and several legendary action commands like stealth assassinations and tactical freezing.

✓ Official Download

Download from official mod platforms:
• GTA5-Mods.com (Primary)
• Nexus Mods (Mirror)

The mod is 100% FREE on GTA5-Mods.com. Always verify that your downloaded version matches the official releases.

💬 Discord: discord.gg/LLAI — support, community updates, and bug reporting.

02 // What Is This Mod?

Living LS AIs is a complete, ground-up overhaul of Grand Theft Auto V's pedestrian world. It replaces static, repetitive NPC voice lines with dynamic, real-time AI brains powered by the fastest engines on the market.

With v4.0, we are introducing a new era of open-world AI. NPCs can now actually **see** your game world in real-time, react to your customized cars, comments, and clothing dynamically, and follow complex autonomous lifestyles. You can speak to them instantly without opening a single menu, or watch them walk into shops, buy weapons, browse clothes, and interact with cashiers face-to-face.

No paywalls, no Patreon locks, and no subscriptions. This is our gift back to the community.

03 // Core Features

👁️

Multimodal AI Vision v4.0

The AI gets real eyes! A real-time capture stream captures your POV on every single turn, letting NPCs react directly to your clothing, your vehicle model and color, nearby police, and dead bodies.

🎙️

Menuless Direct-Talk v4.0

Bypass menus completely! Walk up to any NPC in the world and press Y (Mic) or T (Text) to instantly initialize and hold a seamless conversation without any interrupting GUI overlays.

🛍️

Clothing Store Routines v4.0

NPCs dynamically visit Binco (budget street style), Sub Urban (skater casuals), or Ponsonby's. At Ponsonby's, transaction bills scale up to $15,000, triggering loud price-shocks from NPCs before they buy!

🛒

Convenience Store Routines v4.0

Watch NPCs walk into local gas stations (24/7, LTD, Rob's), select food or drink items from shelves, and carry them to registers to complete automated checkout transactions.

🔫

Ammu-Nation Purchases v4.0

NPCs autonomously walk up to gun counters, negotiate weapons deals face-to-face with clerks, buy firearms, physically inspect the weapon, and walk out fully armed.

🗡️

Stealth Assassinations v4.0

Order your companion or homie to execute targets with [KILLNPC]. In linked scenes, if your NPC holds a melee weapon, they will execute a high-fidelity stealth throat-slit.

🧊

Tactical Freezing v4.0

Use the new [WAIT] tag to freeze NPCs in place, locking them in their pose. Give them the green light with [STOPWAITING] to unfreeze and walk again.

🤝

Loadout Mirroring v4.0

Hand a weapon to an NPC or tell them to mirror you. The NPC will perfectly duplicate your equipped weapon setup, complete with exact attachments, tints, and ammo with [TAKEWEAPON].

04 // Legacy Feature Archive — v3.3 / v3.2

ARCHIVE NOTE

These systems are still part of the full README, but they are documented here as normal details. The headline spotlight stays on v4.0, while the v3.3 / v3.2 systems live here for reference.

⚡

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.

05 // 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]"
🆕 v4.0 Tactical Control & Contracts
[KILLNPC] v4.0	Orders your bodyguard or homie to eliminate a target. In linked scenes, if the NPC has a melee weapon, they perform a cinematic stealth takedown and nearby NPCs react in panic."Handle that quietly. [KILLNPC]"
[WAIT] v4.0	Freezes the NPC in place and locks them into their current pose until released."Stay right there. [WAIT]"
[STOPWAITING] v4.0	Releases an NPC that was frozen with `[WAIT]`, restoring normal movement and AI behavior."Alright, move again. [STOPWAITING]"
[TAKEWEAPON] v4.0	Mirrors your equipped weapon setup onto the NPC, including attachments, tint, and ammo."Copy my setup. [TAKEWEAPON]"
[DROPWEAPON] v4.0 [COWER]	`[DROPWEAPON]` forces the NPC to drop their current weapon. `[COWER]` makes them freeze, huddle down, and panic under threat."Drop it. Now. [DROPWEAPON] / [COWER]"

06 // 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

07 // 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!

08 // Installation Guide

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.

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.

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.

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.

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.

09 // 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

10 // 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.

11 // How to Play — Controls

NEW v4.0 DIRECT-TALK

Walk near any NPC and press Y for mic chat or T for text chat to start instantly without menus. This is the main v4.0 control upgrade.

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.

12 // 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

13 // FAQ & Safety

Common questions, compatibility notes, and quick answers. Keep everything in single-player use, and read the answers before blaming the mod for your own chaos.

Does this work with LSPDFR?

Yes — no bugs are expected. Keep it in single-player and test it with your current LSPDFR setup like any other modded GTA V build.

Does this work with cracked?

Yes, but you need an updated SHVDN nightly. If your ScriptHookVDotNet files are old, update them first or the mod may crash on launch.

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.

14 // Legacy Release Notes — v3.3 / v3.2

ARCHIVE NOTE

These are the earlier release notes now kept as reference detail, not the top feature spotlight.

💵

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!

15 // 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.

LIVING LS AIs

▶ What's New in v4.0 — The Multimodal Sight Update

🤔 What is Node.js?

⚡ Why does the mod need it?