≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
 Prerequisites & recommendations
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡

This mod without other mods applied works with the original gameconfig.xml and without any heap adjustment.
However, if you are using multiple mods it might be the case that at some point you need to adapt the gameconfig.xml and/or the heap (that is a general statement and is not specific to this mod).
If you are unsure just give it a try without changing the gameconfig.xml and the heap. In case you then experience crashes please install these add-ons as well:
• https://github.com/pnwparksfan/gameconfig/
• https://www.gta5-mods.com/tools/heapadjuster


≡≡≡≡≡≡≡≡≡
 Credits
≡≡≡≡≡≡≡≡≡

Despite my own tools/scripts (https://github.com/Larcius/gta5-modding-utils) the following tools were involved:
• OpenIV (https://openiv.com): importing files from openformats to binary code
• CodeWalker (https://www.gta5-mods.com/tools/codewalker-gtav-interactive-3d-map): exporting and importing shader
• HLSLDecompiler (https://github.com/etnlGD/HLSLDecompiler): decompiling shader (from DXBC byte code to HLSL source code)
• FXC (https://learn.microsoft.com/en-us/windows/win32/direct3dtools/fxc): compiling shader (from HLSL source code to DXBC byte code)


≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
 Installation via OIV
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡

Simply extract the file "Vegetation reflection (San Andreas) v*.oiv" and/or "Vegetation reflection (Cayo Perico) v*.oiv" anywhere you want
and use OpenIV -> Tools -> Package Installer to install the mod.
By doing so the reflection models and maps as well as an adapted shader are installed.

If you are using Liberty City V Remix please
• open directory "Compatibility Liberty City V Remix"
• extract the file "Compatibility Liberty City V Remix for Vegetation reflection (San Andreas).oiv" and/or "Compatibility Liberty City V Remix for Vegetation reflection (Cayo Perico).oiv" anywhere you want
• and use OpenIV -> Tools -> Package Installer to install the patch.


≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
 Uninstallation via OIV
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡

Simply extract the file "Uninstaller vegetation reflection (San Andreas).oiv" and/or "Uninstaller vegetation reflection (Cayo Perico).oiv" anywhere you want
and use OpenIV -> Tools -> Package Installer to uninstall the mod.
Please be sure to select the same location (mods or game folder) you did on installation.
By doing so the reflection models and maps but not the adapted shader are uninstalled.
It is not necessary to reset the adapted shader. If you want to uninstall it anyway please see section Manual uninstallation -> Shader.

It is not necessary to uninstall the Liberty City V Remix compatibility patch if you uninstall Vegetation reflection entirely.
The uninstaller is only needed if you had installed the patch but then no longer use Liberty City V Remix.
• open directory "Compatibility Liberty City V Remix"
• extract the file "Uninstaller Compatibility Liberty City V Remix for Vegetation reflection (San Andreas).oiv" and/or "Uninstaller Compatibility Liberty City V Remix for Vegetation reflection (Cayo Perico).oiv" anywhere you want
• and use OpenIV -> Tools -> Package Installer to uninstall the patch.


≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
 Manual installation
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡

----------------------------
 Reflection models and maps
----------------------------

Described for "San Andreas"; use "vegetation_reflection_cayo" instead of "vegetation_reflection" to install it for Cayo Perico.

• Create new folder "vegetation_reflection" in Grand Theft Auto V\mods\update\x64\dlcpacks
• Extract the file "Vegetation reflection (San Andreas) v*.oiv" and open it with a ZIP program (like 7zip, WinZIP, WinRAR, ...)
• Extract content\dlc\vegetation_reflection\dlc.rpf to Grand Theft Auto V\mods\update\x64\dlcpacks\vegetation_reflection
  (so finally there must be Grand Theft Auto V\mods\update\x64\dlcpacks\vegetation_reflection\dlc.rpf)
• Use OpenIV to edit Grand Theft Auto V\mods\update\update.rpf\common\data\dlclist.xml
• Insert new line
  <Item>dlcpacks:/vegetation_reflection/</Item>
  before line
  </Paths>

--------
 Shader
--------

To properly render the dedicated reflection models an adapted shader is required.

• Extract the file "Vegetation reflection v*.oiv" and open it with a ZIP program (like 7zip, WinZIP, WinRAR, ...)
• Extract the file default.fxc under content\shader and copy it (using OpenIV) to Grand Theft Auto V\mods\update\update.rpf\common\shaders\win32_40_final
  (you may need to create the folder win32_40_final).

------------------------------------
 Compatibility Liberty City V Remix
------------------------------------

Described for "San Andreas"; use "vegetation_reflection_cayo" instead of "vegetation_reflection" to install the patch for Cayo Perico.

• Use OpenIV to edit Grand Theft Auto V\mods\update\x64\dlcpacks\vegetation_reflection\dlc.rpf\content.xml
• Replace line
  <genericConditions>$level=MO_JIM_L11</genericConditions>
  by
  <genericConditions>$level=MO_JIM_L00</genericConditions>


≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
 Manual uninstallation
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡

----------------------------
 Reflection models and maps
----------------------------

Described for "San Andreas"; use "vegetation_reflection_cayo" instead of "vegetation_reflection" to uninstall it for Cayo Perico.

• Use OpenIV to edit Grand Theft Auto V\mods\update\update.rpf\common\data\dlclist.xml
• Remove any line like
  <Item>dlcpacks:/vegetation_reflection/</Item>
• Go to Grand Theft Auto V\mods\update\x64\dlcpacks and remove the folder vegetation_reflection

--------
 Shader
--------

If you are using one of my other mods you need to keep the adapted default.fxc shader.
Otherwise do the following to uninstall the adapted shader:
• Use OpenIV and go to Grand Theft Auto V\mods\update\update.rpf\common\shaders\win32_40_final
• Remove the file default.fxc

------------------------------------
 Compatibility Liberty City V Remix
------------------------------------

It is not necessary to uninstall the Liberty City V Remix compatibility patch if you uninstall Vegetation reflection entirely.
This is only needed if you had installed the patch but then no longer use Liberty City V Remix.
Described for "San Andreas"; use "vegetation_reflection_cayo" instead of "vegetation_reflection" to uninstall the patch for Cayo Perico.

• Use OpenIV to edit Grand Theft Auto V\mods\update\x64\dlcpacks\vegetation_reflection\dlc.rpf\content.xml
• Replace line
  <genericConditions>$level=MO_JIM_L00</genericConditions>
  by
  <genericConditions>$level=MO_JIM_L11</genericConditions>