Seasonal Weather

Create realistic, chance-based weather patterns that change with the seasons. Snow in winter, thunderstorms in summer afternoons, fog in the early morning.

Overview

Climatime offers two scheduling modes:

Mode	Best for
Hourly	Simple weather rotation — cycle through presets every X minutes
Seasonal	Realistic weather — random selection based on chances, seasons, and time of day

Only one mode can be active at a time. Enabling one stops the other.

How Seasonal Works

Profiles

A profile represents a season with a name and a month range.

“Winter” — December to February
“Summer” — June to August
“Monsoon” — July to September

Month ranges can wrap around the year (Dec-Feb works correctly).

Weather Entries

Each profile contains weather entries that define what weather can occur:

Field	Description
Weather Type	The GTA weather (Rain, Snow, Clear, etc.)
Chance	Weight for random selection (1-100). Higher = more likely
Duration	Min and max hours the weather lasts before re-rolling
Active Hours	Optional — boosts the chance 3x during these hours

How Weather is Selected

Every 60 seconds the server:

Finds the profile matching the current real-world month
Collects all weather entries from that profile
If an entry has active hours set and the current hour is in range, its chance is tripled
Picks a random weather type weighted by effective chances
Picks a random duration between the entry’s min and max
Applies the weather with a smooth transition

When the duration expires, the process repeats.

Example Setup


Winter (Dec - Feb):
  Snow        35%   12-72 hours    any time
  Blizzard    10%   8-48 hours     any time
  Foggy       15%   1-3 hours      boost 04:00-09:00
  Clear       25%   24-96 hours    any time
  Rain        15%   12-48 hours    any time

Summer (Jun - Aug):
  Extra Sunny 40%   4-8 hours      any time
  Clear       30%   3-6 hours      any time
  Thunder     20%   1-3 hours      boost 14:00-22:00
  Rain        10%   2-4 hours      any time

In this setup:

January at 6 AM: Fog has a 35% real probability (chance tripled from 15% to 45%, total pool is 130)
January at 2 PM: Fog drops to 15% (no boost, total pool is 100)
July at 3 PM: Thunder has a 46% real probability (boosted from 20% to 60%, total pool is 130)

Overlapping Profiles

If two profiles cover the same month, the most specific one wins (smallest month span).

Profile	Months	Span
Winter	Dec - Feb	3 months
Cold Season	Nov - Mar	5 months

In December: Winter is used (3 < 5). In November: Cold Season is used (only match).

Entries from the losing profile are completely ignored — they do not mix with the winning profile’s entries.

Active Hours

Active hours do not restrict when weather can occur. They boost the chance 3x during those hours.

Example: Fog set to 04:00-09:00 with 15% chance:

At 6 AM → effective chance is 45% (15% x 3)
At 2 PM → effective chance is 15% (base)

Fog can still happen at 2 PM — it’s just 3x less likely than during morning hours.

Want fog in both morning AND evening? Add two entries: one for FOGGY 04:00-09:00 and another for FOGGY 18:00-21:00.

Manual Override

When an admin manually changes weather from the Weather page while a schedule is running:

Config Setting	Behavior
`Config.ScheduleOverrideBehavior = 'stop'`	Schedule stops. Admin must re-enable it. (default)
`Config.ScheduleOverrideBehavior = 'temporary'`	Schedule stays active. Next cycle tick picks new weather.

Persistence

Seasonal schedules survive resource restarts. The current weather, remaining duration, and schedule type are saved to KVP storage.

Using with Hourly Mode

Both modes use the same toggle switch in the Schedule tab. The tab shows Hourly or Seasonal buttons at the top.

Existing hourly presets are preserved when switching to seasonal
Seasonal profiles are preserved when switching back to hourly
Only one mode runs at a time