Samurai’s Scripts (SSV2) is a feature-rich, open-source Lua script package for YimMenu — the popular GTA V mod menu. Built by SAMURAI (xesdoog) and contributors, version 1.9.4 delivers a massive collection of vehicle mods, self features, online tools, world interactions, and completely unique gameplay systems that go far beyond what a standard mod menu offers out of the box.
What is Samurai’s Scripts?
Samurai’s Scripts does not represent an independent mod menu — instead, this is a collection of Lua scripts created to be used within YimMenu, adding over 50 new features to YimMenu that were never originally provided by Rockstar. Created using Lua and with a very well organized object-oriented design, SSV2 provides functionality for a wide array of applications such as modifying vehicle physics, enhancing combat, automating businesses, and creating custom roleplay tools.
What sets this apart from other Lua scripts is the level of depth provided by each individual feature. Each feature was written as a proper class which has all three of the standard lifecycle methods: initialize(), loop(), and cleanup(). This allows each feature to be activated and deactivated without leaving behind any lingering effects, nor will they cause your game to crash. The project is open source under the GPL-3.0 license — it encourages community contributions, but requires you to provide attribution and preserve the licensing.
Script Package Structure
The SSV2 package is organized under a single SSV2/ folder with a clean module hierarchy. The entry point is samurais_scripts.lua, which bootstraps the entire system — loading all required packages, translating strings for the GUI, booting up the thread manager, and loading each of the feature modules.
All gameplay features organized into subfolders: self/, vehicle/, world/, online/, and extra/. Each feature is a standalone Lua class with its own lifecycle.
Low-level GTA V game object wrappers including CVehicle, CPed, CWheel, CHandlingData, CWeaponInfo, and more — used by features to read and write game memory directly.
Massive data tables covering all vehicles, all peds, all weapons, animations, scenarios, globals, locals, custom paints, and full enum definitions for every game flag type.
Core framework modules including Game, Ped, Color, and Accessor — shared utilities used across all features.
📸 In-Game Screenshots
🎬 Video Guide
Self Features
This is where all of the self-character modifications are located — combat, movement, and survival options for modifying your character’s abilities while in-game.
Katana
Attaches a prop version of an actual katana to your character (id: 0xE2BA016F), allowing it to be used as a full held katana and creating a real in-game object. The katana is fully controllable via code, including automatic cleanup when disabled.Laser Sights
Using dynamic visual laser sights, enhances your aiming experience by adding custom beam effects onto your held weapon.Magic Bullet
Modify projectiles to have different behaviors — such as homing to a target after being fired, exploding upon impact with another object, or having their trajectory modified based on user input per bullet fired.Auto Heal
Restores your health at defined time intervals when your HP falls under a specified amount, allowing you to survive extended periods without having to manually restore your health — especially useful during long battles or missions.Ragdoll Control
Provides fine-grained control over your character’s ragdoll behavior — allows toggling individual ragdoll blocking flags, prevents ragdolling due to explosion or impact forces, and defines exactly when your character will ragdoll.Miscellaneous Self Options
Phone animation controls, crouch toggle flag, hands-up animation flag, phone anim management for multiplayer peds, and other ped config flag overrides.Vehicle Features
The vehicle features category is perhaps one of the most advanced and technical aspects of Samurai’s Scripts. It encompasses physical and realistic vehicle modification at the memory level, visual enhancements, and completely new driving mechanics.
NOS (Nitrous Oxide System)
A functional NOS system added to your vehicle with particle effects (veh_xs_vehicle_mods) fired from exhaust bones. Activated based on how much engine stress you have via the Danger Ratio, and provides visual purge effects on both left and right exhausts when boost is applied.Drift Mode
Physically modifies wheel response at the CWheel memory level for a true drift experience. Overrides tire grip values, fires smoke particles from rear suspension bones, and only activates when your engine is on and you are driving a land vehicle.Stancer
A complete wheel stance editor that modifies track width, camber angle, suspension compression, wheel width, and wheel size in real time. Uses direct CWheel memory writes to position each wheel individually — one of the deepest vehicle customization tools ever created for any GTA mod.Drift Minigame
A fully playable drift scoring system integrated into the game world. Tracks your drift angle, speed, and chain multiplier in real time and awards points for sustained drifts.Launch Control
Simulates actual launch control behavior — holds RPM at optimal levels while stationary and then releases for maximum acceleration on takeoff, complete with visual and audio effects.Cobra Maneuver
Based on Pugachev’s Cobra aircraft stunt — applies a quick upward thrust to your vehicle to allow for tight aerial or ground maneuvers at high speeds.Vehicle Mines
Drops proximity mines from your vehicle while driving. Can configure mine type, trigger distance, and explosion delay.RGB Lights
Cycles through a continuous RGB color spectrum on your vehicle’s neon underglow — configurable speed and color range.High Beams
Toggles constant high-beam headlight use — overrides the game’s automatic light management system.IV Style Exit
Recreates the GTA IV vehicle exit animation — your character exits and the vehicle slowly rolls forward as opposed to stopping instantly when you get out.Flatbed & Flappy Doors
Physically adjust flatbed tilt and toggle any door on the vehicle independently — any door can be opened or closed while stationary or moving.Car Crash & Braking Force Display
Improved realistic vehicle collision physics and a real-time HUD display of your braking force percentage — useful for precision driving.World Features
Carpool
A fleet of NPC vehicles spawns and follows you through Los Santos in a configurable convoy. Each car is spawned as an individual NPC with proper cleanup when disabled.Public Enemy
Wanted level set to maximum, and the entire city is directed to come after you. Both civilians and police will be hunting you down.Enemies Flee
The default behavior of hostile NPCs is reversed. Instead of attacking you, they will flee from you — allowing you to clear areas without having to fight.Kill All Enemies
With this feature activated, all hostile NPCs in your immediate surroundings are killed instantly — a reliable tool for clearing out difficult situations quickly.Hide & Seek
A fully built Hide and Seek minigame. The seeker searches for hidden players while others can hide in car trunks, trash cans, or parked cars — each with their own animations. Hiding in a car trunk uses a cockpit animation; a trash bin uses a crouch; a parked car uses a sleeping animation. The system tracks context state and handles reveal mechanics automatically.Miscellaneous World
Additional features that toggle miscellaneous world aspects such as NPC density, traffic modifications, and ambient events.Online Features
Casino Pacino
A completely working casino manipulation system. You can rig the Lucky Wheel to land on a specific prize type — Vehicle, Mystery Box, Cash, Chips, RP, Discount, or Clothing. Also includes blackjack table optimization with card-to-string mapping. Uses Rockstar’s SGSL (Script Global/Local) system for seamless integration.Mastermind
A completely working heist management system that covers all major GTA Online heists — Doomsday, Cayo Perico, The Contract, Hangar, and Submarine. Keeps track of stats, cooldowns, secondary targets (money, weed, coke, gold, art), and property locations for Agency, Facility, Hangar, and Submarine. Helps manage setup and finalization for optimal heist performance.YimResupplier V3 — Business Manager
YimResupplier V3 is probably one of the most complicated systems within the SSV2 package. It is a fully automatic GTA Online business manager that takes care of resupplying, selling, and managing all major businesses within GTA Online.
Manages CEO Office operations, including acquiring special cargo, exporting goods, and employee management.
Takes care of all MC business types — Document Forgery, Counterfeit Cash, Weed Farm, Meth Lab, Cocaine Lockup — with automatic resupply and sell coordination.
Manages special cargo warehouses, automates source missions, and determines optimal sell timing based on stock levels.
Automates Import/Export operations — acquires vehicles, stores them in the warehouse, and coordinates export missions for maximum efficiency.
Manages the Salvage Yard business — handles vehicle robbery missions and tracks profit.
Monitors Nightclub popularity, manages technician assignments, and automatically coordinates sell missions when stock reaches optimal levels.
Automates the Acid Lab cash safe collection and Car Wash passive income cycles — keeping money flowing with minimal manual input.
Coordinates MC Clubhouse contracts and Business Hub operations, handling setup and completion automatically.
Billionaire Services V2
Billionaire Services V2 is a luxury NPC entourage system that spawns and manages a fully functional personal crew around your character. Each service type uses its own AI task system with role-based assignments.
| Service | Type | Description |
|---|---|---|
| Bodyguard Service | Type 0 | Spawns armed NPCs that follow you on foot, enter vehicles with you, engage threats, stand guard, or wander nearby. Supports 10+ task modes including parachute and rappel. |
| Escort Service | Type 1 | A convoy of escort vehicles follows your car — drivers and passengers with separate role assignments maintain formation around you. |
| Limo Service | Type 2 | A luxury limo picks you up at your location and chauffeurs you to a destination. |
| Helicopter Service | Type 3 | A luxury helicopter with pilot and optional guards hovers nearby, lands on command, takes off, or holds position. Supports taxi, takeoff, land, and hover-in-place tasks. |
| Private Jet Service | Type 4 | Spawns a private jet with a full crew — the pilot handles takeoff, flight, and landing sequences automatically. |
Entity Forge
Entity Forge is a flexible in-world entity creation and modification tool. In addition to creating objects, it enables building composite entities based on parent/child relationships between objects, vehicles, and peds.
YimActions V3
YimActions V3 is a powerful animation and synchronized scene playback engine integrated into SSV2. It offers a robust actions system for executing animations, playing back scenarios, triggering movement clips, and coordinating multi-ped scene playback.
Animation Library
Provides easy access to a large library of pre-curated GTA V animations (animations.lua) categorized by type. Users can browse, search, and execute any animation using customizable flags.Scenarios
Execute hundreds of different in-game scenario tasks such as sitting, sleeping, working, and more — including proper start/stop functionality.Movement Clipsets
Switch between the different movement clipsets available for your character — whether it be drunk walking, injured limping, sexy strutting, or hundreds more.Synchronized Scene Playback
Create and play out complex animated scenes (synchronized_scenes.lua) which include multiple entities executing their animations synchronously — replicating cutscene-quality moments while roaming free.FX Manager & Prop Manager
Enable attaching particle effects and prop objects to your character while they animate. Props can be placed in reference to the user’s ped during animations to add realism to action sequences.Command Registration
Each feature in YimActions has been registered as a typed command using the CommandExecutor. Users can call any animation or scenario by name using YimMenu’s command input system.How to Install
Default Keybinds
Technical Architecture
There are several architectural differences between SSV2 and other simple Lua scripts that make it stand so far apart. All components inherit from a single base class called FeatureBase that defines how each component will behave. Each FeatureBase implements a standard interface of methods: init(), ShouldRun(), updateframe(), and Cleanup(). This ensures that problems commonly associated with Lua scripting — such as particles remaining visible after turning off an effect or vehicle properties persisting across game sessions — do not occur.
SSV2 includes full Lua wrappers for GTA V’s internal C++ classes — CVehicle (12KB), CWheel (9KB), CPed, CHandlingData, CFlyingHandlingData, CBikeHandlingData, CWeaponInfo, and more. These provide direct structured access to game memory instead of requiring raw manual memory reads and writes.
In order to ensure memory safety when accessing GTA V’s internal memory classes, SSV2 uses accessors which encapsulate memory reads and writes through a struct — rather than requiring users to manually enter memory address offsets.
All SSV2 features are managed by the ThreadManager, which handles all coroutine scheduling. Features never block because they always yield() before waiting for the PatternScanner to finish scanning memory patterns for their required offsets.
The data/ folder contains what is likely among the largest sets of GTA V data available within any public Lua project — approximately 580KB of object data alone, plus full vehicle hashmaps, ped hashmaps, weapon definitions, global/local references, and complete enum definitions for every game flag type.
SSV2 includes a Translator module that loads localization data upon initialization. All labels and text displayed in menus and features can be easily translated into various languages without changing any code.
Credits to #Yimura, Mr.X, SourceModzz & MaybeGreat48 & the team behind it
Download Links:
