Weather

From Vintage Story Wiki
Rainfall over a lake.
“It not only looks pretty, it also affects gameplay.” —Survival Handbook

Weather is a mechanic that causes localized precipitation, clouds, and wind.

Climate

Weather changes constantly throughout the world, and different biomes can be found in areas with different long-term precipitation and temperatures . Jungles experience more frequent rain and have vibrant green foliage, while deserts experience less frequent rain and have pale yellow foliage. When temperatures are low during the colder months, snow replaces rain and piles on the ground.

Mechanics

Weather simulation uses climatic temperature and rainfall values determined by a noise map created during world generation . Every map region, which encompasses a 512x512-block section of the world, runs an individual simulation to determine which weather patterns to include and their mathematical weight. The weather at a specific position is then linearly interpolated from 4 nearby regions. Beyond checking for suitable conditions, some weather patterns also have a weight function that scales their occurrence rate with climatic temperature and rainfall. TestRainTemp increases weight as conditions scale further above a minimum or below a maximum threshold. AvoidHotAndDry decreases weight as rainfall decreases or the temperature range widens.[1]

Weather stats can be viewed using the following commands:

  • .weather - Lists the top-right (“tl”), top-left (“tl”), bottom-left (“bl”), and bottom-right (“br”) regions and the player’s position along the linear interpolation. Stats include the current weather pattern, wind pattern, wind speed, and weather event.[2]
  • /wgen pos climate - Lists the current temperature, climatic temperature, and climatic rainfall.[3]

Weather features

Clouds

There are 8 basic weather patterns, each with additional variants.[4]

Type Weather pattern Allows precipitation Weight
Altocumulus Altocumulus clouds ✔️ 1.5
Cirrocumulus Cirrocumulus clouds ✔️ 1.5
Cirrocumulus clouds with mist ✔️ 0.33
Clear sky Clear sky ❌ 2
Clear sky extra chance in dry areas ❌ 8
Clear sky with light sealevel mist ❌ 0.5
Cumulonimbus Cumulonimbus clouds ✔️ 1.5
Cumulonimbus clouds with rain ✔️ 1
Cumulonimbus clouds with rain and ceiling fog ✔️ 0.33
Cumulus Cumulus clouds and clear sky ✔️ 2
Small cumulus clouds and clear sky ✔️ 0.5
Haze Rare strong haze ❌ 0.1
Medium haze everywhere ❌ 0.2
Medium haze extra chance for wet climates ❌ 1
Overcast Overcast everywhere ❌ 0.75
Overcast with undulating clouds everywhere ❌ 1
Overcast extra chance in wet places ❌ 1.5
Stratus Light stratus clouds ❌ 1

The current weather pattern can be changed with the following commands:

  • /weather setir [pattern] - Instantly sets the weather to a pattern, only in the player’s region.
  • /weather setirandom - Instantly sets the weather to a random weather pattern.
  • /weather lp - Lists all loaded weather patterns.
  • /weather acp [0|1] - Toggles auto-changing weather patterns.
  • /weather t - Transitions to a random weather pattern.
  • /weather c - Quickly transitions to a random weather pattern.
  • /cloudypos [level] - Changes the elevation of clouds in increments of the world’s height. The effect is visual only.
    • [level] is a decimal. Default is 1.

Precipitation

Weather patterns can cause precipitation in the form of rain or snow. When precipitation occurs, clouds form across the sky and obscure the sun, growing thicker and darker as it intensifies. During rain, fog will also set in. Precipitation irrigates farmland , extinguishes firepits , torches , and forges exposed to the sky, and cools work items on an anvil . The player will become wet when exposed to the sky. Notably, snow causes the player to become wet 20 times more slowly than rain.[5]

Rain is replaced by snow when the temperature is below 4°C.[6] When the temperature is below 0°C (or between 0°C and 1.5°C with ongoing snow), layers of snow will begin to gradually accumulate on the ground,[7] up to a maximum of 3 layers (3/8th of a block).

The player inventory can be accessed by pressing C, and displays the current temperature and climatic rainfall. Each description corresponds to an internal value that does not directly measure the frequency of rainfall.[8]

  • Very Rare: 0 - 0.15 rainfall
  • Rarely: 0.16 - 0.30 rainfall
  • Uncommon: 0.31 - 0.45 rainfall
  • Common: 0.46 - 0.70 rainfall
  • Very Common: 0.71 - 0.90 rainfall
  • Almost all the time: 0.91+ rainfall

The current precipitation can be changed using the following commands:

  • /weather setprecip [-1..1] - Overrides precipitation intensity and rain clouds. -1 removes all rain clouds, 0 stops rain but keeps some rain clouds, and 1 causes the heaviest rain clouds. The server will remain indefinitely in that rain state until reset using /weather setprecipa. If no argument is included, returns the current override setting.
  • /weather setprecipa - Resets the override caused by /weather setprecip - Precipitation will be handled automatically.
  • /whenwillitstopraining - Tells when the rain should stop.
  • /weather stoprain - Stops any current rain by forwarding the simulation to a time in the future where there is no rain.

Events

See also: Lightning

An event is an adverse weather condition involving lightning or hail. It occurs at the same time as a weather pattern.

Weather event Minimum temperature (°C) Minimum rainfall Weight
No event N/A N/A 5
Light thunder 12 0.2 1
Heavy thunder 12 0.3 1
Small hail N/A N/A 0.2
Large hail 18 0.3 0.2

An event can occur if the area meets the climate requirements for temperature and rainfall,[9] and the probability increases with higher temperature and rainfall. Events can potentially be detrimental for the player: lightning strikes deal 6 damage to creatures within a radius of 8 blocks, and hail deals a continuous small amount of damage while the player is exposed to the sky.

The current weather event can be changed using the following commands:

  • /weather setev [noevent|lightthunder|heavythunder|smallhail|largehail] - Sets a given weather event globally.
  • /weather setevr [noevent|lightthunder|heavythunder|smallhail|largehail] - Sets a given weather event only in the player’s region.

Wind

Wind is a weather condition that occurs independently of climatic temperature or rainfall.[10]

Wind pattern Base strength Duration (hours) Chance
Minimum Maximum Minimum Maximum
Still 0 0.05 0 18 22.7%
Light breeze 0.10 0.20 0 54 22.7%
Medium breeze 0.25 0.35 0 30 22.7%
Strong breeze 0.45 0.75 0 42 22.7%
Storm 0.90 1.10 0 10 9.1%
The average wind speed at different Y-levels. From top to bottom: storm, strong breeze, medium breeze, and light breeze.

For the duration of a wind pattern, a base strength is initially selected, and then a fluctuating amount between 0 and 1.0 is added.[11] Wind speed is wind strength with an elevation modifier applied, based on one’s position relative to sea level . In a world with default height settings, sea level is at Y-level 110.

  • Starting from 10 blocks above sea level, wind speed receives a multiplicative bonus of 1% per block above sea level. The maximum wind speed is 1.5, or “150% wind speed.”
  • For every block below sea level, wind speed falls drastically. At 4 blocks, speed is reduced by 50%. At 16 blocks, speed is reduced by 80%. The maximum wind speed reduction is 96.5%.[12]
  • If the current wind strength is 0, wind speed will be 0, regardless of elevation modifiers.

Wind speed is used by windmills , player-built structures that transform wind into mechanical power . A windmill rotor’s Block info HUD displays wind speed expressed as a percentage (e.g., “Wind speed: 85%” or 0.85).[13]

If the player is not inside an enclosed room , heavy winds will lower their body temperature .[14] In desert or snow environments, heavy winds generate sandstorms and snowstorms that reduce the player’s visibility and cause them to automatically cover their face with their right hand if empty. This action does not occur if the player has equipped clothes in their face slot with the “eye protection” property, such as snow goggles.[15]

The current wind pattern can be changed using the following command:

  • /weather setw [still|lightbreeze|mediumbreeze|strongbreeze|storm] - Sets the current wind pattern to the given wind pattern.

History

Version Description
1.6.0 rc.1 The weather system was implemented, producing cloud and fog patterns that change over time. Prior to this, clouds were generated with randomized heights.
Weather patterns were rebalanced to change slightly less often. The probabilities of fog and high fog density were reduced.
1.6.2 Fog and mist patterns were adjusted to be less common, less dense, and blend better with the clouds and sky.
1.8.4 The color, contrast, and brightness of fog, sky, and clouds were adjusted.
1.11.0 pre.1 Windmills were introduced, utilizing a simple localized wind system.
1.11.2 The frequency and scope of wind were increased.
1.12.0 pre.1 The weather system was overhauled to produce patterns bound to individual locations, with varying intensities of wind, rain, snow, thunder, and hail. New cloud patterns and visual effects were added. Varying wind interactions for plant blocks and particle blocks (e.g., torches) were added. Rain interactions for forges and firepits were added. Volumetric clouds were added, with classic clouds rendering available through Settings.
Clouds are now colored during sunsets and conform to local weather conditions.
1.13.0 pre.1 Snow accumulation was implemented. The /weather setprecip and /snowaccum commands were added. Precipitation was reworked into a function of time that is overlaid onto cloud patterns.
rc.1 A snow-covered overlay for soil was added. Movement speed is now reduced in deep snow.
1.13.4 A setting for weather sound level was added.
1.14.0 pre.1 The /weather stoprain and /whenwillitstopraining commands were added. Rain and snow now make the player wet. Thrown items are now affected by wind.
rc.4 Creative worlds now have snow accumulation and ice melting disabled by default.
1.14.3 rc.1 A rain droplet effect on water surfaces was added. Snow can now accumulate on chiseled blocks and path blocks.
1.14.6 rc.1 Grass must now be cleared of snow before it can be cut or scythed. Lake ice now thaws faster in spring, and is accelerated by rain.
1.16.0 rc.8 Snow-covered grass can no longer ignite.
1.18.0 pre.1 Clouds were adjusted to appear fluffier.
1.19.0 rc.1 Ambient noise for glass blocks exposed to rain was added.
1.17.0 pre.1 Hares can no longer jump over fences in snowy conditions.
1.20.0 pre.1 Medium and strong rainfall now causes clay molds to shatter. Ambient rain noise was improved.


Notes

  • In real life, the formation of hail favors warm surface temperatures because they promote strong updrafts and retain liquid water within clouds. These conditions are necessary for water droplets to accumulate ice and form hailstones.
  • Snow accumulation and the freezing of water into ice blocks can be toggled through the world configuration “Snow and ice,” or by using the command /worldconfig snowAccum [true|false]. Snow accumulation is enabled by default in all preset playstyles except for Creative . However, it does not currently appear to function as intended in other world types.

See also

References

  1. ↑ Lines 28 to 66 of ConditionalPatternConfig.cs
  2. ↑ Line 837 of WeatherCommands.cs
  3. ↑ Lines 1379 to 1399 of Standard/WgenCommands.cs
  4. ↑ assets/game/config/weatherpatterns
  5. ↑ Line 240 of BehaviorBodyTemperature.cs
  6. ↑ Line 24 of WeatherDataSnapshot.cs
  7. ↑ Line 258 of WeatherSimulationRegion.cs
  8. ↑ Lines 124 to 157 of CharacterExtraDialogs.cs
  9. ↑ Line 559 of WeatherSimulationRegion.cs
  10. ↑ assets/game/config/windpatterns
  11. ↑ Line 56 of WindPattern.cs
  12. ↑ Lines 247 to 446 of WeatherSimulationRegion.cs
  13. ↑ Line 350 of BEBehaviorWindmillRotor.cs
  14. ↑ Line 274 of BehaviorBodyTemperature.cs
  15. ↑ Lines 948 to 973 in EntityPlayer.cs


Wiki Navigation
Vintage Story Guides[[::Category:Guides| ]] • Frequently Asked Questions • Soundtrack • Versions • Controls
Game systems Crafting • Knapping • Clay forming • Smithing • Cooking • Temperature • Hunger • Mining • Temporal stability • Mechanical power • Trading • Farming • Animal husbandry
World World generation • Biomes • Weather • Temporal storms
Items Tools • Weapons • Armor • Clothing • Bags • Materials • Food
Blocks Terrain • Plants • Decorative • Lighting • Functional • Ore
Entities Hostile entities • Animals • NPCs • Players
Miscellaneous List of client commands • List of server commands • Creative Starter Guide • Bot System • WorldEdit • Cinematic Camera • Adjustable FPS Video Recording • ServerBlockTicking • Adding Mods • Troubleshooting Mods