≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
 Prerequisites
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡

If you use GTA V Remastered as well please be sure that you have installed version 4.0 or newer of that mod.
Otherwise you will have many colliding and duplicated props in some areas and fewer props in other areas.


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

This map is based on the map "Forests of San Andreas" in version 2.2 (RRC edition) by JRod.
I want to thank him very much for that great map and his permission to publish this mod.

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): editing entities and scenarios, 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 "Forests of San Andreas (North) Revised v*.oiv" and/or "Forests of San Andreas (South) Revised v*.oiv" anywhere you want
and use OpenIV -> Tools -> Package Installer to install the mod.
By doing so the maps as well as the scenarios, an adapted shader (to properly render reflections)
and a script (for entering and exiting a shelter at coordinates -491.34, 2235.70, 150.87) are installed.


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

Simply extract the file "Uninstaller Forests of San Andreas (North).oiv" and/or "Uninstaller Forests of San Andreas (South).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 maps as well as the scenarios and the script (for entering and exiting a shelter) 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.


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

If you had installed a previous version (<= 3.2) please uninstall it first since the dlcpack name has changed (see section "Manual uninstallation").

------
 Maps
------

Described for "North"; use "forest_s" instead of "forest_n" to install the southern part.

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

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

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

• Extract the file "Forests of San Andreas (North) Revised 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).

-----------
 Scenarios
-----------

Described for "North"; use "Forests of San Andreas (South) Revised v*.oiv" to install the southern part.

• Extract the file "Forests of San Andreas (North) Revised v*.oiv" and open it with a ZIP program (like 7zip, WinZIP, WinRAR, ...)
• Extract all files under content\scenario and copy them (using OpenIV) to Grand Theft Auto V\mods\update\update.rpf\x64\levels\gta5\scenario

--------
 Script
--------

Only for the southern part. Enables a portal to get into the shelter (at coordinates -491.34, 2235.70, 150.87)

• Extract the file "Forests of San Andreas (South) Revised v*.oiv" and open it with a ZIP program (like 7zip, WinZIP, WinRAR, ...)
• Extract the file ForestShelter.cs at content\scripts and copy it to Grand Theft Auto V\scripts


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

------
 Maps
------

Described for "North"; use "forest_s" instead of "forest_n" to uninstall the southern part. If you had installed a version prior to 3.3 use "forest" instead of "forest_n"

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

--------
 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

-----------
 Scenarios
-----------

Use OpenIV to go to Grand Theft Auto V\mods\update\update.rpf\x64\levels\gta5\scenario:

To uninstall the northern part remove the following files:
• alamo_sea.ymt
• altruist_camp.ymt
• countryside_ne.ymt
• countryside_nw.ymt
• northcountrysidebeach.ymt

To uninstall the southern part remove the following files:
• countryside_se.ymt
• countryside_sw.ymt
• harmony.ymt
• marlowe_valley.ymt

--------
 Script
--------

The script is meant to be used with the southern part. So only remove it if you want to uninstall the southern part.

• Go to Grand Theft Auto V\scripts and remove the file ForestShelter.cs



≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
-------------------------
 Overview of added props
-------------------------
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡

≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
 northern part
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡

trees:			4998
bushes:			  23
others:			 517
--------------------
total north:	5538


≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
 southern part
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡

bushes:			 678
cacti:			 129
joshua trees:	 306
palms:			  11
trees:			6814
rocks:			  85
others:			 205
--------------------
total south:	8228


≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
 summary
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡

north:			 5538
south:			 8228
---------------------
total:			13766

