===============================================
 Smoking Mod - by AntonioMontanaGTA
===============================================

DESCRIPTION
-----------
Lets your character light up and smoke a cigarette on command - press a
single hotkey to toggle it on and off. Unlike GTA V's own ambient
"WORLD_HUMAN_SMOKING" scenario, which locks a ped in place for its whole
duration, this mod keeps the cigarette in your character's hand while
you walk, run, or drive.

FEATURES
--------
- Toggle smoking on/off with a single hotkey (L by default)
- Cigarette prop stays visibly in hand the entire time smoking is on,
  no matter what your character is doing
- Animated puffing motion (cigarette raised to the mouth) plays while
  standing still or walking
- Puffing animation automatically pauses while running, sprinting, or
  riding/driving any vehicle, so it never fights the game's own running
  arm-pump or procedural hands-on-wheel animation - the cigarette just
  stays in hand without the raised motion in those situations
- Self-healing: automatically re-attaches the cigarette and resumes the
  animation if anything (drawing a weapon, entering/exiting a vehicle,
  ragdolling) would otherwise interrupt it

REQUIREMENTS
------------
- GTA V, LEGACY version only (Steam/Rockstar/Epic build). Not tested/
  built for the "Enhanced" re-release.
- ScriptHookV by Alexander Blade (required by all ASI mods)
  https://www.dev-c.com/gtav/scripthookv/

INSTALLATION
------------
1. Install ScriptHookV first if you haven't already (ScriptHookV.dll and
   dinput8.dll go in your main GTA V folder, next to GTA5.exe).
2. Copy SmokingMod.asi into your main GTA V folder (same folder as
   GTA5.exe and ScriptHookV.dll).
3. Launch the game normally.

CONTROLS
--------
L - toggle smoking on/off (edit TOGGLE_KEY in the source and rebuild to
    change this)

UNINSTALLATION
--------------
Delete SmokingMod.asi from your GTA V folder.

KNOWN LIMITATIONS
------------------
The animated puffing motion only plays while standing still or walking -
while running, sprinting, or in any vehicle, the cigarette stays in hand
but the raised-to-mouth motion is paused. This is deliberate: overriding
the upper body during a full sprint or while driving fights the game's
own arm-pump/steering-wheel animation and looks worse than pausing it.

CHANGELOG
---------
v1.0 - Initial release

CREDITS
-------
- Alexander Blade for ScriptHookV and the native SDK
- AntonioMontanaGTA - mod author

LICENSE / TERMS OF USE
-----------------------
Feel free to include this mod in mod packs as long as credit is given.
Do not reupload this mod to other sites without permission.
