REALISTIC FOG EVENTS - FS25
Version 0.2.0.3 - Remappable Fog Control action made easier to find

PURPOSE
Realistic Fog Events creates temporary, naturally scheduled fog rather than
leaving one manually selected fog value active all the time.

CURRENT BEHAVIOR
- Rolls once per in-game morning between 03:30 and 10:30.
- Spring and autumn have the highest base chance.
- Wet ground, rain, cool temperatures, and calm wind increase the chance.
- Strong wind and hot weather reduce the chance.
- Chooses light, moderate, or dense fog.
- Fog fades in around 04:30-05:45 and normally burns off by 09:00-10:30.
- Releases all fog control back to the map after the event.
- Adds a normal in-game menu for Automatic, Clear Fog, Light, Moderate, and
  Dense control modes.
- Disables itself if a mod name containing FogControl or RealisticWeather is
  active. The separate Moisture System is not treated as a conflict.

INSTALLATION
Place FS25_RealisticFogEvents.zip directly in your Farming Simulator 25 mods
folder and select it when loading a single-player save.

IN-GAME FOG CONTROL
Press RIGHT ALT + 4 while playing to open Fog Control. This shortcut is listed
as "Realistic Fog Events: Open Fog Control" in FS25's normal Controls screen
and can be remapped to any preferred key or button.
The mod also watches the physical RIGHT ALT + 4 combination directly as a
fallback if FS25 fails to deliver the custom action callback.

After loading a save, the mod displays a one-time reminder explaining the
default shortcut and where to change it. The action is also visible in FS25's
F1 help panel using the player's current assignment.

Use the mouse, or use the existing menu controls:

  UP / DOWN       Select a mode
  SPACE / ENTER   Apply the selected mode
  ESC             Close without changing anything

The menu choices are:

  Automatic      Use the mod's natural morning scheduling.
  Clear Fog      End this mod's fog and suppress another event for today.
  Light Fog      Force light fog for two in-game hours, then fade it out.
  Moderate Fog   Force moderate fog for two in-game hours, then fade it out.
  Dense Fog      Force dense fog for two in-game hours, then fade it out.

The status panel shows whether the current fog is automatic or forced, its
profile, current strength, and scheduled end time.

DEVELOPER CONSOLE FALLBACK
The console commands remain available for troubleshooting:

  rfeForceFog light
  rfeForceFog moderate
  rfeForceFog dense

The forced profile appears immediately, holds for two in-game hours, and then
fades out over thirty in-game minutes.

Other test commands:

  rfeFogStatus
  rfeClearFog

FIRST TEST CHECKLIST
1. Load a save with Fog Control and Realistic Weather mods deselected.
2. Confirm the log contains:
   [RealisticFogEvents] Loaded version 0.2.0.3
3. Press RIGHT ALT + 4 and select Moderate Fog.
4. Walk or drive for about 30 seconds while the fog remains active.
5. Reopen the menu, select Clear Fog, and confirm the map returns to its native
   view without flickering.
6. Reopen it once more, select Automatic, and confirm the status changes.
7. Confirm the shortcut works both on foot and while sitting in a vehicle.
8. If that run is clean, try Light and Dense so we can compare strengths.
9. Send the game log only if the menu fails or another red Lua error appears.

KNOWN TEST-BUILD LIMITATIONS
- Multiplayer is deliberately disabled until the visual controller is proven.
- Manual Light, Moderate, and Dense choices are temporary events rather than
  permanent saved settings.
- Fog events are global, matching FS25's global fog renderer; local valley-only
  patches are outside the scope of this first build.
- Version 0.2.0.2 requires only ground-fog density. Maximum-height controls are
  used when the current FS25 build exposes them to Lua and skipped otherwise.
- While an event is active, its renderer value is held every frame to prevent
  the map's native fog interpolation from producing a visible flicker.
