Shaun's Smoking Enhanced 2.1.0

Feel free to buy me a coffee!! 

https://cash.app/pay/link/4z3oc3x7
(if link does not work - $shaun10197)

Discord - https://discord.gg/d6uHBsRZp8

==============================================================================
  SMOKING ENHANCED  -  huge smoke exhales for Red Dead Redemption 2
==============================================================================

Whenever Arthur or John smokes, every drag ends in a big cloud of smoke blown
out of their mouth, and a haze is left hanging in the air afterwards.

- The smoke follows the head: if he turns his head to exhale, it comes out of
  his mouth in that direction.
- Cigarettes, cigars and pipes each have their own smoke. A cigar gives a
  bigger, thicker, slower cloud with more haze.

It works however you smoke:
- smoking from the item wheel or satchel
- quick smoking
- the Smoking Complete mod, including leaving a cigarette in your mouth
  (then a puff of smoke comes out every few seconds)

There's nothing to press. The mod watches the cigarette, cigar or pipe in
your hand: each time it goes up to your mouth and comes away again, out
comes the smoke.

This is similar to my other mod "Shaun's Gun Smoke" in that it adds in a customizable particle effect. This time, it's for smoking (cigarette, cigar)

REQUIREMENTS
------------
- Script Hook RDR2 (by Alexander Blade)
- Story mode only (Script Hook mods don't run in Red Dead Online)
- Optional: Smoking Complete, for more ways to smoke


INSTALL
-------
Copy SmokingEnhanced.asi into your Red Dead Redemption 2 game folder (the
folder with RDR2.exe in it). The first time you start the game, the mod
creates SmokingEnhanced.ini there with the default settings and an
explanation of each one. You can also copy the included SmokingEnhanced.ini.

Updating from an older version: replace your SmokingEnhanced.ini with the new
one (or delete it and let the mod write a fresh one). The mod never
overwrites an existing INI, so an old one keeps old settings. In particular,
an INI from before this version points the haze at an effect that fills the
whole screen.

UNINSTALL
---------
Delete SmokingEnhanced.asi, SmokingEnhanced.ini and SmokingEnhanced.log from
the game folder.


KEYS
----
Z    Test: blows smoke right away, without smoking. If you're holding a
    cigarette, cigar or pipe it uses that one's smoke. Otherwise each press
    steps through cigarette, cigar and pipe, with the name on screen, so you
    can compare them. The key can be changed in the INI (TestKey).


SETTINGS (SmokingEnhanced.ini)
------------------------------
Settings are re-read every time smoke comes out, so you can change a value,
save, and see it on the next drag (or press Z). No restart needed. Every
setting is explained inside the file.

The two main settings, under [General]:
  SizeMultiplier      How BIG all the smoke is.  0.5 = half, 2 = double
  DurationMultiplier  How LONG each exhale keeps puffing out.
                      0.5 = half, 2 = double. For smoke that hangs in the air
                      longer afterwards, see [Haze] and HazeScale.

Other things you can adjust:
  [General]  FollowHead=0 stops the smoke following the head mid-exhale
  [Cigarette] Size, length, thickness and haze for cigarettes
  [Cigar]    The same for cigars
  [Pipe]      The same for pipes
  [Haze]      The haze left hanging after each exhale (Enabled=0 to remove it)

To start over with the default settings, delete SmokingEnhanced.ini and the
mod writes a fresh one the next time the game starts.


TROUBLESHOOTING
---------------
No smoke at all:
  - Check that Script Hook RDR2 is installed and that SmokingEnhanced.asi is
    in the same folder as RDR2.exe.
  - Press Z. If smoke comes out, the mod works and the problem is detecting
    your smoking. If nothing comes out, the mod isn't loading. Look for
    SmokingEnhanced.log in the game folder.

Smoke comes out late, or only once:
  Some smoking mods use cigarette models Smoking Enhanced doesn't recognise.
  It then falls back to a single exhale a couple of seconds after smoking
  starts. Set DebugLog=1 in the INI, then press Z while smoking: the log
  lists what's near your character's head, which identifies the model.

The haze fills the whole screen, or doesn't show:
  Your SmokingEnhanced.ini is probably from an older version. Delete it and
  let the mod write a fresh one. To resize the haze, change HazeScale under
  [Cigarette], [Cigar] and [Pipe].

Smoke comes out of the wrong place or goes the wrong way:
  Set FollowHead=0. If that fixes it, set DebugLog=1, press Z a few times and
  check SmokingEnhanced.log (the "Head calibrated" and "Puff" lines).

Something else looks wrong:
  Set DebugLog=1, smoke for a bit, and check SmokingEnhanced.log. Set it back
  to 0 afterwards so the log stays small.


COMPATIBILITY
-------------
Smoking Enhanced only adds visual effects and doesn't change any game files.
It is made to work with Smoking Complete, and runs alongside Gun Smoke.

UPDATES
-------------
V2:
Smoke follows your head

Exhaled smoke now comes out where Arthur or John is actually facing. Turn your head to exhale and the smoke goes that way, instead of straight out from the chest.
Smoke still coming out stays at the mouth if you turn mid-exhale. Set FollowHead=0 to aim each puff once and leave it in the air.
Cigarettes, cigars and pipes each have their own smoke

Cigars: a bigger, thicker, slower cloud with more lingering smoke.
Pipes: in between.
Cigarettes: the classic quick exhale.
Each type has its own section in the INI ([Cigarette], [Cigar], [Pipe]) for size, length, thickness and haze.
Lingering haze

After each exhale, a puff of smoke forms in the air in front of the face and hangs there, fading slowly.
Set its size per type with HazeScale (0 turns it off for that type), or turn it off entirely under [Haze].
New overall controls

SizeMultiplier: makes all the smoke bigger or smaller.
DurationMultiplier: makes each exhale last longer or shorter.
Easier setup and testing

The mod now writes a fully commented INI on first launch, explaining every setting.
The test key (Z by default, now rebindable) steps through cigarette, cigar and pipe smoke when you're not holding anything, with the name on screen, so you can compare them without owning a cigar.
Debug logging is off by default, so the log file stays small. Turn it on with DebugLog=1 when troubleshooting.
Removed

The old "Cloud" option, which filled the screen, replaced by the new haze.
Nose exhales, which turned into a flat streak at large sizes.