==========================================================
                    README Installation Guide
==========================================================

Requirements
----------------------------------------------------------
- Script Hook V
- Community Script Hook V .NET (Latest nightly version required)
- LemonUI (SHVDN3 version only)

Optional Recommendations
----------------------------------------------------------
- Resource Adjuster  
  [Download Link](https://www.gta5-mods.com/tools/resource-adjuster)  
- HeapAdjuster  
  [Download Link](https://www.gta5-mods.com/tools/heapadjuster)  
- World of Variety  
  [Download Link](https://www.gta5-mods.com/misc/world-of-variety)  
  [Patreon for WoV updates](https://www.patreon.com/casss)  
- Gangs of Los Santos  
  [Download Link](https://www.gta5-mods.com/misc/gangs-of-los-santos-oiv)

Installation
----------------------------------------------------------
1. **Place Scripts**:  
   Drop the script files into your `scripts` folder.  
   **Important**: Delete old files, especially save files, if you're updating.

2. **Install Turfs**:  
   Open the `turfs` folder and choose the desired option. Follow the installation instructions in the selected folder.

3. **Optional Enhancements**:  
   - Install optional mods for improved stability and performance:  
     - **Resource Adjuster**: Helps adjust memory limits.  
     - **HeapAdjuster**: Ensures smooth operation with extended mod limits.  
   - Install **World of Variety** or **Gangs of Los Santos** to enhance gameplay:  
     - For Gangs of Los Santos: Only install the **turfs part** if you're using 5Real or already have a modded popcycle.  
   - **Important**: Before installing WoV or GOLS, make a **backup** of your `gameconfig.xml` file located in `mods/update/update.rpf/common/data`.  
   - After installation, replace `gameconfig.xml` with a compatible version. Skipping this step may result in your game failing to start. Use one of the following links to download a working gameconfig:  
     - [Kryst4lClr’s Gameconfig (Updated Regularly)](https://www.gta5-mods.com/misc/kryst4lclr-s-gameconfig-updated-regularly)  
     - [Gameconfig for 300+ Cars](https://www.gta5-mods.com/misc/gta-5-gameconfig-300-cars)

Troubleshooting
----------------------------------------------------------
If you encounter any issues during the installation process, please ensure the following:

- **LemonUI**: Ensure LemonUI is installed correctly and only the SHVDN3 version is placed in the `scripts` folder.
- **ScriptHookVDotNet**: Use the latest nightly version.
- **Turfs Installation**: Double-check that you’ve followed the instructions for the turfs installation.

If your game doesn’t start after installing World of Variety or Gangs of Los Santos:  
- Confirm that you’ve backed up and replaced `gameconfig.xml` as described above.  
- Use one of the recommended gameconfig files.  
