Yet Another Winter Mod v2.2 (Anomaly 1.5.1) addon

--==============================================================================================
--Yet Another Winter Mod
--==============================================================================================

I wasn't happy with any of the other winter mods for Anomaly so I decided to take matters into
my own hands and create Yet Another Winter Mod (YAWM for short).

YAWM "winterizes" the vast majority of environment textures in Anomaly as well as changing the
footstep sounds to sound like the player is walking on snow. In addition YAWM replaces rain with
snowfall using a script to spawn snow particles around the player. Rain is removed by making the
texture invisible and the sound silent. Since the snowfall works by spawning a large number of
particles around the player, it may cause performance problems on some PCs. As of the
Version 2.0 update there is now a choice of heavy, medium, light or no snowfall.

--==============================================================================================
--Changelog
--==============================================================================================

Version 2.2----2021-02-12:
--Updated YAWM to Anomaly 1.5.1.
--Updated tweaked "hmodel.h" shader to the one used in Anomaly 1.5.1.
--Added "particles.xr" compatibility patch for CinemaVFX 1.2.1
--Added "particles.xr" compatibility patch for HollywoodFX 2.0
--Added "particles.xr" compatibility patch for MinimalFX 2.0
--Added "particles.xr" compatibility patch for RealisticFX 2.0
--Increased fog distance in snowy weather.

Version 2.1----2020-10-05:
--Updated YAWM to Anomaly 1.5 RCs.
--Improved mipmaps of textures with transparency (notably tree branches and grass).
--Slightly tweaked medium and light snow particle behavior as they seemed to behave slightly
differently on Anomaly 1.5.
--Removed "img_corrections.h" shader as it is now included in Anomaly by default.
--Tweaked fog density of snowy weather.
--Known Issue: Textures on DX8 may appear overly bright in some weather conditions. There is
no fix at this time.

Version 2.0----2020-06-17:
--Installation has changed slightly so please read the new instructions. In addition if you
have installed YAWM before it is recommended to uninstall old versions of the mod before
installing Version 2.0.
--Changed the ground textures. Both the diffuse and normal maps/bump maps have been replaced.
I personally think they look better but let me know what you think.
--Fixed the issue with snow textures looking shiny under certain conditions by slightly
modifying the shader file "hmodel.h".
--Fixed overbright snow textures when using the default setting "r2_tonemap_middlegray 1.5"
by including a fixed version of "img_corrections.h" shader. This is the same shader file
posted on the S.T.A.L.K.E.R. Anomaly discord as well as ModDB to fix the overbright sky.
I included it in YAWM so users wouldn't have to track down a separate fix just for the
textures (and sky) to appear correctly. This also means that if you previously changed
"r2_tonemap_middlegray" to "1" you should set it back to "1.5".
--Fixed overbright snow textures on DirectX 8 by modifying the "terrain_LEVEL_lm.dds"
textures.
--Gave snowfall its own weather presets instead of having it snow during the rain presets.
It still snows during rain weather CYCLES but the snow has its own weather files that
change things like fog and sky color etc.
--Modified snowfall script. The most notable change is to the way it detects the current
weather. Now it should be more accurate and using the weather editor to change the weather
will start or stop the snow when appropriate. Do note that when loading a save that was
experiencing snowfall it may no longer be snowing. This is normal and due to the new way
the script detects weather.
--Tweaked snow particles. Snowfall should hopefully have somewhat better performance while
at the same time appear thicker.
--Changed how you choose the heaviness of snowfall. Instead of installing a
different script depending on which version you wanted, now everything is handled
with one script and you choose which version by using different versions of
"gamedata\configs\environment\dynamic_weather_graphs.ltx"
--There are now four options for snowfall - heavy, medium, light and none. Each choice
also has the lighter variants included in it. For example the heavy choice also includes
the chance for the medium and light variants to fall, the medium includes the light,
light only includes light and none (obviously) disables snowfall altogether.
--Updated particles.xr compatibility patches to include HollywoodFX 1.1, RealisticFX 1.1
and MinimalFX 1.1.

2020-02-03:
--Installation has changed slightly. You will now need to choose the version of the snowfall
script you want and copy it to your scripts folder. By default there is no script in the
main mod folder.
--Added light version of snowfall. If you were having performance problems try the light
version and see if it helps.
--Fixed pixelation on snow textures. The ground should look significantly better now.
--Fixed a few rock textures that looked wrong.
--Winterized a handful of new textures that I had missed initially.
--Replaced sound files of birds and insects with silent versions as one usually doesn't hear
either in the winter.

2020-02-01:
--Added compatibility patches for HollywoodFX, RealisticFX and Particles Remade. Remember to
install the patches LAST.
--Added a check in yawm_snowfall.script to see if the player is indoors and if so stop the
snowfall. Snowfall will resume when the player is detected to be outside again. One downside
to this is that you will not be able to see snowfall outside when looking outside through a
window. Also indoors with regard to the script is considered anywhere that is safe from an
emission. If you find a building where it still snows inside there is very little I can do
to prevent it.
--Modified the snow effects. It should fall slightly slower now.

--==============================================================================================
--Installation
--==============================================================================================

NOTE: It is recommended to install YAWM with a mod manager such as JSGME (or even better,
Mod Organizer) so that you can easily uninstall YAWM if you so choose.

NOTE 2: The folder structure for ground textures changed significantly from Anomaly Update 4 to
Anomaly 1.5 RC. Because of this versions 2.0 and below will not work correctly on Anomaly 1.5 RC
and version 2.1 will not work on Anomaly Update 4.

1. Extract the gamedata and db folders from the main files folder to your root anomaly folder.

2. Choose which version of snowfall you want (including none) from the snowfall choices folder
and copy the corresponding "dynamic_weather_graphs.ltx" file to your "gamedata\configs\environment"
folder.

2b. (Optional)
If you use HollywoodFX, RealisticFX, MinimalFX or Particles Remade, copy the "particles.xr" file from it's
respective folder in the compatibility patches folder to your gamedata folder and overwrite when
asked. Make sure you have installed one of those 4 mods first.

2c. (For DX8 users)
If you play on DirectX 8 copy the files in the DX8 fog fix folder to your
"gamedata\configs\environment\weathers" folder and overwrite. This will make
it so that the fog during snowy weather does not appear too bright on DX8.

Known Issue: Textures on DX8 may appear overly bright in some weather conditions. There is
no fix at this time.

3. When launching the game for the first time after installing (or uninstalling) YAWM be sure to
delete your shader cache by checking the appropriate checkbox in the Anomaly launcher.

3b. If you have installed previous versions of YAWM and changed the "r2_tonemap_middlegray" setting,
open the console when in game and enter "r2_tonemap_middlegray 1.5" (hint: you can copy and paste).

3c. In the advanced graphics options uncheck the option "wet surfaces" or things will appear waaay
too shiny.

--==============================================================================================
--Images
--==============================================================================================

Preview of 2.0+: Streamable.com

--==============================================================================================
--Mod Conflicts
--==============================================================================================

YAWM has a file conflict with Soundscape Overhaul by Solarint, specifically the file
"dynamic_weather_graphs.ltx", however you can safely overwrite it with the one from YAWM.
Soundscape Overhaul only modifies the file to change the thunder sounds, however when using
YAWM you will not hear any thunder, so the file can be safely overwritten. If you uninstall
YAWM but keep using Soundscape Overhaul, be sure to put back Soundscape Overhaul's version
of the file. Alternatively you could merge the files but in this specific case it isn't
necessary.

--==============================================================================================
--Uninstallation
--==============================================================================================

If you have used a mod manager to install the mod then you should be able to simply disable it
like any other mod.

If you installed the mod manually then you will have to delete all the files the mod came with
from your gamedata directory (compare them with the files from the download to know which files
to delete).

--==============================================================================================
--Credits
--==============================================================================================

Editing textures, creating particles, shader editing and scripting:
Daedalus-Prime

Editing textures:
Cobra Commander

Fixed "img_corrections.h" shader: --No longer included in version 2.1
Meatchunk

Snow textures:
Public Domain Textures ( Publicdomaintextures.com ) --Used since version 2.0
CC0 Textures ( Cc0textures.com ) --No longer used in version 2.0

Sounds:
BazinGarrey's Better snow footstep sounds ( Moddb.com )

Snowflake brushes used for particle textures:
Communicanimation.com