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

🏪 Store Robbery Enhanced — Bringing GTA Online’s Robbery Achievements to Single Player
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 Sytle 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 charater icon, to make it even more emmersive 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

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)

Each store has persistent state tracking:
 * Robbed / Not Robbed
 * Cooldown active
 * Safe cracked
 * Alarm triggered
 * Clerk killed (gun/melee)
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

💬 350+ 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 35 unique lines, totaling over 350 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 StoreRobberyTracker.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


🧪 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 350+ 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
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

[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.

📦 INSTALLATION
Requirements
 * ScriptHookV
 * ScriptHookVDotNet 3.9.0 Enhanced  
 * 👉 https://www.gta5-mods.com/tools/script-hook-v-net-enhanced
 * iFruitAddon2 - (Included)
 * .NET Framework 4.8
 * GTA V (Latest Version)

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

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

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