====================================================================
 clipoy v1.0 - Advanced Seasonal Climate & Weather HUD (GTA V)
 Script Hook V / ScriptHookVDotNet3 (SHVDN3)
====================================================================

PACKAGE CONTENTS
----------------
1. clipoy_v1.0.oiv
     OpenIV installer package (easiest way to install).
2. Manual_Install\scripts\
     Same content, in case you want to copy it manually without OpenIV.
3. Uninstall_clipoy.bat
     Removes this mod at any time.

REQUIREMENTS
------------
- Script Hook V (by Alexander Blade) must already be installed.
- ScriptHookVDotNet3 (SHVDN3) must already be installed.
(This package does NOT include Script Hook V / SHVDN3 themselves --
they must already be present in your GTA V install.)

HOW TO INSTALL (pick one)
--------------------------
A) Via OpenIV (recommended):
   1. Open OpenIV, switch to "Edit mode".
   2. Right-click clipoy_v1.0.oiv > "Install".
   3. Follow the wizard until it finishes.

B) Manual (without OpenIV):
   1. Open your GTA V install folder (the one containing GTA5.exe).
   2. Copy the "scripts" folder from inside "Manual_Install\" into that
      GTA V folder (merge it, don't overwrite your whole scripts folder
      if you already have other mods there).
   3. Make sure you end up with:
        GTA V\scripts\WeatherHUD.cs
        GTA V\scripts\WeatherHUDIcons\sun.png (and the other icons)
        GTA V\scripts\WeatherHUDRegions\Downtown.json (and the other region files)

REAL FEATURES
-------------
1. Day-of-Year Interpolation: gradual temperature transitions between
   months. No sudden jumps on the 1st of March or June!
2. 5 Custom Biomes: Urban, Desert (scorching up to 51C), Mountain
   (freezing down to -15C), Forest (humidity +15%, native GTA zone
   detection), and Industrial (daytime heat pollution bonus).
3. Active seasonal weather control: the mod doesn't just display the
   weather, it actively drives it (rain/snow/blizzard/sandstorm
   frequency all tuned per season and per biome, sandstorm locked to
   desert areas only).
4. Seeded daily temperature noise: naturally curved, non-flat lines in
   the 7-day forecast graph, consistent within a day but different day
   to day.
5. "Weather Forecast" page: press F6 in-game to open/close a 7-day
   forecast styled like a weather website, including a REGION STATUS
   block (LOCATION / WEATHER / TEMPERATURE / HUMIDITY / WIND / BIOME)
   for wherever you're currently standing.
6. Error-resistant: every per-frame block is wrapped in try/catch, so
   an unexpected error only skips a single frame instead of getting
   the script flagged "broken" by Script Hook V .NET.

UNINSTALLING / IF SOMETHING GOES WRONG
----------------------------------------
Run "Uninstall_clipoy.bat" (double-click), then follow the prompts.
It will try to find your GTA V folder automatically (or you can type
the path manually), then remove:
   scripts\WeatherHUD.cs
   scripts\WeatherHUDIcons\
Your original game files are never touched by this mod or by the
uninstaller.

CHECKING LOGS IF SOMETHING'S WRONG
------------------------------------
If the HUD doesn't show up at all, check:
   GTA V\ScriptHookVDotNet.log
to see whether SHVDN successfully loaded WeatherHUD.cs.

Created by a 13-year-old developer from Indonesia.
