Engine State Manager
A ScriptHookVDotNet mod that gives players full control over vehicle engine behavior across all vehicle types.

[ FEATURES ]
– Manual engine start and shutdown control
– Persistent engine state handling for better consistency
– Prevents the engine from shutting off when exiting vehicles
– Passenger-seat exits no longer turn the engine off when it should keep running
– Improved engine persistence during seat shuffling
– Better handling of engine state when entering, exiting, and switching seats
– More reliable behavior across standard vehicles
– Improved support for planes and helicopters
– Reduced engine flicker and unwanted restart behavior
– Tracks engine state per vehicle entity
– Optional aircraft stall disable when flying too slowly
– Optional aircraft stall disable when the aircraft is damaged
– Keybind and controller support
– In-game notification when the mod loads
– Optional logging
– Fail-safe handling to help prevent crashes

[ CONFIGURATION OPTIONS ]
– All features are modular and configurable through EngineStateManager.ini

[ REQUIREMENTS ]
– Latest ScriptHookV
Enhanced:
– Latest ScriptHookVDotNet v3 Enhanced
Legacy:
– Latest ScriptHookVDotNet v3 Nightly

[ INSTALLATION ]
– Install ScriptHookV and ScriptHookVDotNet v3
– Place EngineStateManager.dll and EngineStateManager.ini into your GTA V/scripts/ folder
– Optionally edit EngineStateManager.ini to customize the behavior
– Enjoy

[ KNOWN ISSUES ]
– If you run into any issues, please let me know so they can be investigated

[ INCOMPATIBILITIES ]
– Scripts that manage engine state may conflict with this script. To avoid issues, disable the engine-state options in either this script or the conflicting script.

[ CHANGELOG ]
Patch v2.0.1
– Hardened the engine-toggle input path against long-session desync
– Prevented a stale UI-block state from permanently blocking the toggle
– Replaced some raw engine natives
– Hopefully fully fixes the engine-toggle input desync

Release v2.0.0
– Rewrote most scripts and functions
– Added a guard so aircraft remain persistent during a stall until the engine is actually dead
– Removed all animation functions after extended research and testing showed no progress
– Fully fixed the issue where exiting through the passenger seat with the engine running would shut the vehicle off
– Fully fixed engine-toggle mishaps
– Fixed buggy steering animations when shutting the engine off
– Fixed helicopter rotor dips when persistence is armed
– Reworked plane persistence
– Added several additional fixes
– Overall stability has been greatly improved
– Scripts are still built for SHVDN

Update v1.2.0
– Added controller support using GTA’s control mapping
– Expanded the keybinding system to include full Virtual-Key mapping, enabling support for all keyboard and mouse inputs
– Added per-vehicle animation detection to keep behavior immersive and avoid direction mistakes
– Added animation flip prevention to avoid incorrect animations
– Added a safeguard that blocks automatic motorcycle helmet equip until the engine startup animation has fully completed
– Reworked the engine override bus into a multi-owner arbitration bus instead of a single global “last writer wins” slot, improving compatibility with other scripts
– Attempted a fix for vehicles shutting down when exiting by shuffling through the passenger seat
– Exiting while shuffling with the engine running is inconsistent. I do not think this issue can be fully patched with SHVDN

Update v1.1.0
– Added options to properly enable and disable aircraft stalling
– Added proper vehicle tracking based on engine state
– Updated aircraft tracking and distance tracking behavior, with the ability to disable these options
– Attempted a patch for RPM drops and engine dips when entering or exiting an aircraft with engine persistence enabled
– The MaxDistanceToTrack ini option now applies to all vehicles instead of only aircraft
– Fixed conflicting toggle states with EngineToggleKeys
– Fixed the legacy assembly error “Unable to resolve API version 3.9.0” by switching ScriptHookVDotNet API versions
– Updated the in-game notification
– Added other quality-of-life improvements

Patch v1.0.1
– Added proper instant engine-toggle response
– Engine on/off now triggers on key press instead of key release
– Removes the noticeable delay when starting or shutting down vehicles
– Fixed a small safety guard that disarms entry enforcement if the target vehicle’s engine is actually on at enforcement time
– Added input debounce protection to prevent double toggles when both event and polling paths fire
– Fixed the rare “script loaded but not working” issue by adding a fallback polling system

Release v1.0
– Initial release

[ CREDITS & ACKNOWLEDGEMENTS ]
– Alexander Blade for ScriptHookV
– crosire for ScriptHookVDotNet
– Chiheb-Bacha for ScriptHookVDotNet Enhanced

Without these foundational tools, this mod would not be possible.

Additional thanks to:
– The GTA V modding community for documentation, shared research, and reverse-engineering efforts
– Everyone who reports bugs or shares feedback. Your input directly improves future updates