Upgrading from Global Snow 2
beginner start hereGlobal Snow & Rain 3 · Start Here
Global Snow & Rain 3 is a major upgrade of Global Snow 2 for URP. A Global Snow 2 project can move to Global Snow & Rain 3 and keep most of its setup, but some components and settings changed. This page lists the steps to follow and what changes in your scenes and scripts.
Owners of Global Snow 2 can get Global Snow & Rain 3 at a reduced upgrade price on the Unity Asset Store. Sign in with the account you used to buy Global Snow 2 and open the Global Snow & Rain 3 page: the upgrade price is shown there.
Requirements
| Global Snow 2 | Global Snow & Rain 3 | |
|---|---|---|
| Unity | 2022.3 or later | 6000.0 or later |
| Render pipeline | URP | URP |
| Rendering path | Deferred | Deferred or Deferred+ |
| Render Graph | Not needed | Required |
Upgrade the project to Unity 6 before you install Global Snow & Rain 3. A project upgraded from Unity 2022.3 can keep the Render Graph turned off. If the Global Snow inspector shows an error about Compatibility Mode, turn off Compatibility Mode (Render Graph Disabled) in Project Settings > Graphics.
Install Global Snow & Rain 3
Both versions use the Assets/GlobalSnow folder. Do not import Global Snow & Rain 3 over Global Snow 2: old scripts stay in the folder, they do not compile with the new version, and the errors stop URP from working in the whole project.
- Back up the project.
- If you saved your own files inside
Assets/GlobalSnow, such as profiles, coverage masks or materials, move them to another folder in the Project window. When you move them in Unity, their references are kept. - Open an empty scene.
- Delete the
Assets/GlobalSnowfolder. - Import the Global Snow & Rain 3 package.
- Open your scenes and follow the checks below.
If you already imported the package over Global Snow 2 and the console shows errors, delete the Assets/GlobalSnow folder and import Global Snow & Rain 3 again. The result is the same as a clean install.
If your scenes show pink materials after the import, open Project Settings > Graphics and Project Settings > Quality and check that your URP asset is assigned. This can happen when the project used the URP asset of the Global Snow 2 demo.
What Carries Over
- The
Global Snowcomponent on the camera, your Global Snow profiles, the Global Snow Render Feature in your renderer and the materials that use Global Snow shaders keep their references. - Most settings of the component and of the profiles keep their values, for example Minimum Altitude, the Layer Mask, the coverage mask and the options of Footprints and Collision Marks.
- Global Snow Ignore Coverage components become
Global Snow Interactioncomponents. They keep Receive Snow, Block Snow/Rain, Use Fast Mask Shader and the cut off value. Interact is off on them, so these objects keep the snow as before and leave no marks.
Check After the Upgrade
| Item | What to do |
|---|---|
| Scatter | In Global Snow 2, Altitude Scatter was a distance in meters, 20 by default. Now Scatter is the share of the ground left bare in patches, from 0 to 1, so the old value leaves almost no snow on the ground. Set it to 0, or to the share you want, in the component and in each profile. |
| Footprints and marks | Global Snow 2 made footprints from the camera or from the Global Snow Footsteps component, and collision marks from the Global Snow Collision Detector on the ground. Now each object that marks the snow needs its own component. Add Global Snow First Person Interaction to a first person player, and Global Snow Interaction to characters, animals, vehicles and other moving objects. See Add Footprints and Deep Marks. |
| Missing scripts | Global Snow Footsteps, Global Snow Collision Detector, Global Snow Collider Extra Info and Global Snow Lerp no longer exist. Their components show as missing scripts in your scenes and prefabs, and you can remove them. To blend profiles, use TransitionTo() or GlobalSnowProfile.Lerp() from a script. See Gradual Changes and Seasons. |
| Profiles | Global Snow 2 profiles do not store the new settings. When such a profile is loaded, for example when you assign it, press Revert or set it from a script, Footprints and Collision Marks turn off and the other new settings take their default values. After you check the settings of the component, press Apply in the Profile row to save them into the profile. |
| Temperature and Intensity | These new settings at the top of the inspector do not change the scene until you move them. When you move them, they set the snowfall, snow dust, rain, frost and wind values for that weather. |
| Wind | The Wind value of the Global Snow 2 snowfall is not used. Set the wind in the new Wind settings, which start with a Speed of 0. |
| Look | The snow is drawn in a new way, so compare your scenes with the old version. Review Altitude Range, the Snowfall Intensity and Speed, Camera Frost Intensity, and Minimum and Maximum GI Ambient. The snow can look darker: a higher Maximum GI Ambient lets more ambient light reach it. |
| New effects | Rain, puddles, frost, lightning, Snow Accumulation and Deep Marks are off after the upgrade. Dirt Reveal and Impact FX are on, so marks that reach the ground show dirt and objects that mark the snow throw snow particles. You can turn them off in Footprints & Marks. |
Removed Settings
These Global Snow 2 settings have no equivalent: Occlusion and its Intensity, Preserve Global Illumination, Ground Coverage and Perimeter Randomization, Automatic Footprints, Character Controller, Max Ground Distance, FPS Marks and the double footprint Texture. Footprints now use a sole texture, set in Texture under Footprints.
Scripting Changes
The namespace is still GlobalSnowEffect, and most calls keep working, such as GlobalSnow.instance, FootprintAt(), FootPlantAt(), CollisionStay(), CollisionStop(), GetSnowAmountAt(), MaskPaint(), MaskClear(), RefreshExcludedObjects(), UpdateSnowCoverage() and GlobalSnowProfile.Lerp(). These members changed:
| Global Snow 2 | Global Snow & Rain 3 |
|---|---|
MarkSnowAt() | MarkAt() |
GlobalSnowIgnoreCoverage | GlobalSnowInteraction, also in IgnoreGameObject() and UseGameObject() |
GlobalSnowFootsteps, GlobalSnowColliderExtraInfo, GlobalSnowCollisionDetector | GlobalSnowInteraction on the object that marks the snow |
footprintsCharacter, groundCheck, GroundCheck, characterController, groundDistance, footprintsAutoFPS, terrainMarksAutoFPS | GlobalSnowInteraction or GlobalSnowFirstPersonInteraction on the object that marks the snow |
GlobalSnowLerp | TransitionTo() or GlobalSnowProfile.Lerp() |
footprintsTexture | footprintsSoleTexture |
snowfallWind | windSpeed and windDirection |
snowfallSystem | snowfallVolume |
snowdustSystem, preserveGI, occlusion, occlusionIntensity, billboardCoverage, groundCoverage, GetExclusionCommandBuffer() | No replacement |
If your code calls CollisionStay() from the ground, call it from the moving object instead, or add Global Snow Interaction to that object. The first call of GetSnowAmountAt() for a spot returns an estimate, and the exact amount arrives a few frames later. See Scripting Support for the full API.
Suggest an improvement
Help us improve this documentation page.