⭐ GTA5‑Mods Upload Description — Store Robbery Enhanced (v2.7.0.1 Latest Release)
(Fully polished, cinematic, feature‑rich, and ready for upload)

🏪 Store Robbery Enhanced — Bringing GTA Online’s Robbery Achievements to Single Player with some huge twists.
Store Robbery Enhanced is a complete re-imagining of the GTA Online store robbery loop — rebuilt from the ground up for GTA V Single Player Enhanced to bring a different engaging experience that upon completion, gives you a Mission Style completed feel, something that the GTAO never offered. It also offers a crazy twist with the option "Stalker System" that makes you feel during the Robbery Process if you will, feel like you are being watched and if you really got away clean or not... If it is enabled (default true), there are over 350+ preprogrammed messages and you can edit or add your own messages, change the name and character icon, to make it even more immersive and thrilling.

In GTA Online, robbing all convenience stores is a structured progression path:
 * Each store has its own state
 * Cooldowns prevent farming
 * Clerks react dynamically
 * Safes offer bonus payouts
 * Subtitles guide the player
 * Achievements track your progress
 * Stalker System intregrated and customizible
 * Safe Cracking Minigame
 * Clerk Reaction Styles for Different Style Robberies
 * Custom Text Notifications and Police responses
 * Shop Menu System
 
This mod brings that entire experience into Story Mode — and then pushes it further.

This isn’t a simple “point gun, get money” script.
It’s a full robbery ecosystem, designed to feel like Rockstar built it themselves.

🔥 FEATURES
🏪 Dynamic Store Robberies
20 fully supported stores (19 Online stores + Ace Liquor)
 * 26 Stores if DLC stores are added.

Each store has persistent state tracking:
 * Robbed / Not Robbed
 * Cooldown active
 * Safe cracked
 * Alarm triggered
 * Clerk killed (gun/melee)
 * Different style Robberies (Stealth, Melee, Point Gun & Sticks)
Store states save across sessions
Cooldowns prevent farming (configurable)
Register payouts scale per store
Optional safe cracking for bonus cash

🧠 Advanced Clerk AI
Fear, surrender, flee, and escalation logic
Clerk calls police after a delay
Silent alarm triggers automatically
Clerk reactions vary based on:
 * Player weapon
 * Player distance
 * Time spent aiming
 * Violence level

💰 Safe Cracking Minigame
Fully interactive safe cracking system
Difficulty scaling per store
Bonus payout on success
Optional pad shake feedback
Optional loading of “optional safes”
Configurable safe crack time and cooldown

🗺️ Minimap‑Only Blip System
Blips appear only on the minimap, not the world map
Dynamic color changes:
 * Available
 * Robbed
 * Cooldown
 * Safe cracked
 * Alarm triggered

🎬 Subtitle System (GTA Online Style)
Dynamic robbery subtitles:
 * Clerk fear lines
 * Robbery prompts
 * Safe cracking prompts
 * Escape warnings
Fully synchronized with robbery state

🔪 Stalker System — Psychological Threat Layer
The Stalker System is a fully dynamic psychological pressure mechanic that reacts to how the player performs robberies. It adds tension, personality, and a sense of being watched — even when no one is around.

🧠 Dynamic Behavioral Tracking
The system monitors:
 * How violently you rob stores
 * Whether you kill clerks (gun/melee)
 * Whether you knock them out
 * How fast you escape
 * Whether you answer or ignore calls
 * How sloppy or clean your robbery was
Every action influences the tone and type of messages you receive.

📱 Stalker Phone Calls
Randomized chance per robbery
Uses custom caller name and icon
Whisper-style, unsettling dialogue
Calls react to your behavior
Ignoring calls triggers different message sets
Answering calls unlocks deeper psychological lines

💬 450+ Dynamic Stalker Messages
Organized into categories:
 * Knockout — when you leave clerks alive but unconscious
 * MeleeKill — when you kill up close
 * GunKill — when you kill loudly
 * Robbery — during the robbery itself
 * Escape — when fleeing the scene
 * CallAnswered — when you pick up
 * CallIgnored — when you don’t
Each category contains 66 unique lines, totaling over 450 lines of reactive dialogue.

🎭 Personality‑Driven Reactions
The stalker:
 * Judges your performance
 * Comments on your precision or sloppiness
 * Reacts to your morality (or lack of it)
 * Tracks your patterns
 * “Follows” you psychologically
 * Builds a profile of your behavior over time
This system adds a thriller‑style narrative layer to every robbery.

⚙️ Fully Configurable (Stalker Section in INI)
Enable/disable stalker messages
Enable/disable stalker phone calls
Set call chance percentage
Customize caller name and icon
Set max messages per robbery
Set message cooldown

For a list and visual of for possible Stalker Icons for the Stalker System can be view and seen at this link below. Default Stalker Image used is "CHAR_ARTHUR"
👉 https://wiki.rage.mp/wiki/Notification_Pictures

You can edit the MainSettings.ini file and update the Icon and Name in these settings
[Stalker]
EnableStalkerMsg=true
EnableStalkerCall=true
StalkerCallChance=25
CallerImage=CHAR_ARTHUR <-- where you can change the icon
CallerName=NO CALLER ID	<-- where you can change the caller ID name if desired.
MaxMessagesPerRobbery=5
MessageCooldownSeconds=20

🔓 Safe Cracking Minigame — Interactive Bonus Payout System
The Safe Cracking Minigame is a fully interactive, skill‑based system that rewards players with high‑value payouts for cracking store safes.

🌀 Fully Interactive Dial Rotation
Rotate the dial left/right
Feel for the “sweet spot”
Controller vibration feedback (optional)
Visual UI indicators
Audio cues (optional depending on settings)

🎯 Difficulty Scaling
Each store can have:
 * Different safe difficulty
 * Different sweet spot tolerance
 * Different payout ranges
 * Different time limits
This makes some stores quick hits, while others become high‑risk, high‑reward heists.

💰 High‑Value Safe Payouts
Configurable in INI:
 * Minimum safe payout
 * Maximum safe payout
 * Global payout multiplier
 * Optional bonus multipliers

Safes can pay tens of thousands depending on your settings.

⏱️ Time‑Based Pressure
Configurable safe cracking timer
Failure resets the safe
Cooldown prevents immediate retries
Camera system may trigger alarms if you take too long

🎮 Controller Feedback
Optional pad shake during sweet spot detection
Adds tactile immersion
Can be disabled for keyboard users

📊 Safe Crack UI
Clean, minimalistic UI
Dial rotation indicator
Sweet spot feedback
Timer display
Success/failure banners

⚙️ Fully Configurable (Store Settings Section in INI)
SafeMinAmount / SafeMaxAmount
SafeCrackTimeSeconds
SafeCrackCooldownMs
SafeCrackPadShake
SafeCrackLoadOptionalSafes
PayoutMultiplier

🛒 Shop Menu System
A fully integrated in‑store shopping experience that activates when the player approaches a clerk inside any supported convenience store interior. Each shop automatically loads a themed LemonUI menu with the correct Rockstar banner (24/7, LTD, Rob’s Liquor, or Liquor Ace) and a matching subtitle. Items display with right‑aligned prices and detailed descriptions, mirroring GTA V’s native shop layout. Purchases trigger the Shop Consume System, which handles animations, props, cooldowns, and item effects for a seamless, lore‑friendly shopping flow.

🧪 FULL DEBUG SUITE (Developer‑Grade Tools)
If the Debug System is enabled in the MainSettings.ini, to active and use features you must Holddown Left CTRL + Hotkey(s) to activate. All HotKeys as well as ModifierKey (Left CTRL) can be changed via the DebugSettings.ini a full list of useable HotKeys can be found at the link below
👉 https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.keys?view=netframework-4.8.1

Debug Overlay
Shows real-time data:
Store ID
Store name
Robbery state
Clerk state
Cooldown timers
Safe status
Alarm state
Camera state
System flags

Camera Debug
Toggleable camera overlay
Real-time camera vectors
Interior validation
Store alignment tools

Profiler
Optional performance profiler
Auto-dump mode
Interval‑based dumps

Scenario Runner
Full robbery simulation
Quick loot simulation
Auto snapshot on scenario

Debug Actions (Hotkeys)
Start robbery
Trigger safe crack
Trigger mini safe crack
Trigger camera alarm
Trigger forced escape
Trigger payout
Trigger cooldown
Trigger stalker event
Trigger stalker call event
Toggle UI
Toggle banner
Toggle timer
Store diagnostics
Multi-position debug (shows players POS and Heading)
Misc actions (Profiler Dump Info)
Camera debug

⚙️ INI SETTINGS (FULL BREAKDOWN)
📄 DebugSettings.ini
[Debug]
Setting	Description
EnableDebug	Enables all debug systems
OverlayVisible	Shows the debug overlay on screen
DebugLevel	0–3 verbosity level
ModifierKey	Modifier key for debug actions
ToggleKey	Toggle debug overlay
Action_*	Hotkeys for every debug action
Scenario_FullRobbery	Runs full robbery simulation
Scenario_QuickLoot	Runs quick loot simulation
EnableProfiler	Enables performance profiler
Profiler_AutoDump	Auto‑dumps profiler data
Profiler_DumpInterval	Interval between dumps
EnableLogging	Enables debug logging
EnableFileManager	Enables debug file manager
EnableEvents	Enables debug events
AutoSnapshotOnScenario	Takes snapshot during scenarios

📄 StalkerMessages.ini
Contains 450+ dynamic stalker lines across categories:

Knockout
MeleeKill
GunKill
Robbery
Escape
CallAnswered
CallIgnored

These messages are delivered during robberies, escapes, and phone events to create a psychological thriller atmosphere.

📄 MainSettings.ini (Main Settings)
[Main Settings]
EnableMessages — toggles all robbery messages
EnablePolice — toggles police escalation
EnableBlips — toggles Map Blips system
CooldownMinutes — store cooldown duration
RobberyTimeLimit — max robbery time
EscapeDistance — distance required to escape

[Police]
SilentAlarmDelaySeconds — delay before silent alarm
ClerkCallDelaySeconds — delay before clerk calls police
TimeEscalationSeconds — escalation timer

[Stalker]
EnableStalkerMsg — enables stalker messages
EnableStalkerCall — enables stalker phone calls
StalkerCallChance — % chance of call
CallerImage — phone caller icon
CallerName — caller display name
MaxMessagesPerRobbery — message limit
MessageCooldownSeconds — cooldown between messages
MessageType — 1 chat box, 2 Email, 3 Add Friend Request or 0 None Right corner

[Store Settings]
RegisterMinAmount / MaxAmount — register payout range
SafeMinAmount / MaxAmount — safe payout range
EnableCameras — toggles store cameras
UseStoreNames — toggles store names in UI
CameraGraceSeconds — time before cameras trigger
SafeCrackTimeSeconds — safe cracking duration
PayoutMultiplier — global payout multiplier
SafeCrackCooldownMs — cooldown between safe cracks
SafeCrackPadShake — controller vibration toggle
SafeCrackLoadOptionalSafes — load optional safes

[TIMER_UI]
PositionX / PositionY — timer position
Scale — timer size
DropShadow — shadow toggle
Background — background toggle
BackgroundWidth / Height — background size
BackgroundOpacity — background transparency
BackgroundColorR/G/B — background color

📄 StoreState.ini
Tracks persistent store data:

IsRobbed
CooldownActive
SafeCracked
AlarmTriggered
ClerkDeathHandled
ClerkKilledWithGun
LastRobbedUtc

All 20 stores included and support for an addtion 6 Addon Stores listed below
 * https://www.gta5-mods.com/maps/mlo-vinewood-plaza-24-7-add-on-sp-fivem
 * https://www.gta5-mods.com/maps/mlo-vinewood-boulevard-24-7-add-on-sp-fivem
 * https://www.gta5-mods.com/maps/mlo-vespucci-little-seoul-24-7-add-on-sp-fivem-ver-1-0
 * https://www.gta5-mods.com/maps/mlo-elgin-hawick-24-7-add-on-sp-fivem
 * https://www.gta5-mods.com/maps/mlo-korean-plaza-24-7-add-on-sp-fivem
 * https://www.gta5-mods.com/maps/mlo-paleto-gas-station-fivem-sp-ready

📦 INSTALLATION
Requirements
 * ScriptHookV
 * FOR ENHANCED Version of game ScriptHookVDotNet 3.9.0 Enhanced
 * 👉 https://www.gta5-mods.com/tools/script-hook-v-net-enhanced
 * FOR LEGACY Version of game you need the SHVDN Nightly 3.7.0 min
 * 👉 https://github.com/scripthookvdotnet/scripthookvdotnet-nightly/releases/tag/v3.7.0-nightly.48
 * iFruitAddon2 - (Included)
 * .NET Framework 4.8
 * GTA V (Latest Version) LEGIT LEGAL COPY

Install Steps
1. Install ScriptHookV
2. Install ScriptHookVDotNet 3.9.0 Enhanced
3. Drag StoreRobberyEnhanced.dll  & Drag StoreRobberyEnhanced.pdb into:
Code
Grand Theft Auto V/scripts/
4. Launch the game and rob any convenience store.

🏁 VERSION
v2.6.8.1 — Initial Release
 * First public release
 * Full Phase 3 architecture
 * All 21 stores supported
 * Safe cracking system complete
 * Full debug suite included
 * Stalker system fully implemented

v2.6.8.2
 * Fixed issue with SafeCrack Minigame not exiting upon timer expire
 * Fixed issue of SafeCracking not saving to INI file for SafeCracked
 * Removed unused method blocks that are no longer needed
 * Removed checkt to remove Rockstar blips from system as it is not needed
 * Added Visual Improvements for locks for locked and unlocked states
 * Added Audio Sounds for unlocks and completion for SafeCrack Minigame

v2.6.8.5
 * Fixed minor issues
 * Utilizing LemonUI for Shop Menu
 * Added Store Clerk Shop Menu System pop to mimic the in-game clerks with more items

v2.6.9.0
 * Fixed issues with cooldown invisible blocker not being removed
 * Fixed issues with cooldowns not being applied properly
 * Fixed infinite Wanted Level loop
 * Fixed issue with Clerk Shop Menu UI that caused issues with the SafeCrack Minigame Timer
 * Fixed issues with HandleClerkDeath not triggering properly
 * Fixed minor issue with DebugForceCooldown resetting properly
 * Fixed issue with infinite wanted level on failed robbery by wasted or busted
 * Added Support for 6 DLC Addon Stores (list of supported DLC Store Addons above)
 * Upgraded to Overhaul Complete Success Banner UI Logic and UI Display upon completion

v2.6.9.7
 * Fixed issues with clerk animations as incorrect animation calls no longer available
 * Fixed issues with Flickering on timers
 * Fixed clerk animation timing
 * Added Speech Management System calls to Clerks
 * Added logic of FeelingFroggy to where clerk may fight back and shoot with a pistol or shotgun to chase player off 30% chance
 * Added Loot Trash Bag to be tossed in front of register that is collectible
 * Added Clerk Dialog notifications for robbery
 * Updated various logic improvements

v2.7.0.2
 * Added new config option for Stalker Messages Types = 1 chat box, 2 Email, 3 Add Friend Request or 0 None Right corner icons
 * Added additional new Stalker messages now each section has over 60 messages pre-programmed
 * Added config option to Enable/Disable Blips system for maps per request
 * Updated code logic to support new setting
 * Updated Mission Banner to stay on screen until you press the buttons on bottom right - Mission Pass will autoclose after 30 secs if buttons/keys are not pressed A/Enter B/Esc
 * Updated ini configs and logic
 * Fixed issues with Robbery Timer stopping after SafeCrack Minigame in some situations
 * Fixed Subtitle Issues not showing for all robbery styles
 * Adjusted SilientAlarm and CallPolice logics to be lower by chance.

v2.7.0.3
 * Fixed issues with abandoning the robbery didnt kill the robbery
 * Fixed issues with if you cancelled the safecracking minigame, player was stuck in place
 * Fixed issues with if safecracking minigame was cancelled robbery was stuck couldnt cracck safe again
 * Fixed issues with Silent robbery not triggering animations
 * Expanded Debugging logic and logging to be more detailed if enabled

v2.7.0.5
 * Added Shop purchase animations to clerk and player for items purchased and consumed.
 * Minor code changes clean up and optimizations.

v2.7.1.2
 * Fixed issues with moving during safe crack minigame.
 * Fixed issue on if player uses phone inside stores, would trigger a robbery scenario falsely
 * Improved animations for clerk store purchase and consuming animations and prop deletion
 * Added more food and drink items to clerk store system
 * Minor code changes and optimizations in several systems

⭐ CREDITS
Created by James Neeley (FastBurst)  
GTA V Mod Developer & Systems Architect

* Source code available on GitHub
👉 https://github.com/fastburst-dev/StoreRobberyEnhanced