WispReach

Adjust wisplight mist clearance, or hide all Mistlands mist without a wisplight, using BepInEx Configuration Manager.

WispReach smoothly fades the game's native mist clouds. Their material, textures, lighting and shader are retained. No paid assets or shader bundle are required. Install on the client.

Settings

The global checkbox restores the native renderer when switched off, returning to the configured wisplight fade if applicable. Ordinary weather fog in other biomes is unchanged.

Both radius sliders range from 0 to 100 meters in whole-meter steps, with no decimal places. Existing fractional values round to the nearest meter (half meters round up) when the updated mod loads. The 100 m endpoint remains a finite radius. R2 cannot be lower than R1. Raising R1 above R2 raises R2; lowering R2 below R1 clamps it to R1.

With the global checkbox off, the default 15/15 preserves the game's original wisplight behavior. To add a gradual transition, try R1=15 and R2=25. Between the radii, each cloud's opacity changes smoothly according to its center distance. Large clouds fade as a whole rather than being cut at the radius boundary.

Changes apply without restarting the game. Existing saved settings are preserved on update; use Configuration Manager's reset controls to apply new defaults. With global hiding off, removing the wisplight restores original particle opacity. Disabling the mod restores both original opacity and rendering in either mode. The wisp's light range, stationary torches and other players' wisps retain their original settings.

Install a local package

1. Select Valheim and your profile in Thunderstore Mod Manager.
2. Open Settings → Profile → Import local mod.
3. Select Slikfoul-WispReach-1.0.0.zip. Confirm author Slikfoul, name WispReach, version 1.0.0, then import.
4. Start the game using Start modded and open WispReach in Configuration Manager. Equip a wisplight for radius control, or enable General / Remove all Mistlands mist without one.

If a DLL was previously installed by hand in BepInEx/plugins/WispReach, back up and remove that old manual copy before importing into the same profile. Keep BepInEx/config/Slikfoul.WispReach.cfg to preserve settings. Load one WispReach DLL per profile.

The dependencies are BepInExPack_Valheim and shudnal's ConfigurationManager. This ZIP does not include either dependency, game assemblies or user configuration. Ensure the declared dependencies are installed when using an offline import.

Validation

The release is checked against the installed Valheim assemblies. Local checks cover integer radius constraints, legacy fractional config migration, both switches, persistence and particle alpha restoration. Earlier Unity integration checks covered global hiding without a wisplight, distant/new clouds, renderer restoration and unchanged weather/material state. In-game visual confirmation remains separate from these checks.

Changes in 1.0.0

• First release of WispReach.
• Two whole-meter sliders control the clear radius and gradual mist transition.
• A separate checkbox hides all Mistlands particle mist, even without a wisplight.
• Saved settings are retained; older fractional radii migrate to whole meters.

See CHANGELOG.md for the development version history.

Changes in 0.1.3

• Both radius sliders now use whole meters and display without decimal places.
• Existing fractional radius values migrate to integers while preserving saved switches and radius constraints.

Changes in 0.1.2

• Added a separate checkbox to hide all Mistlands particle mist without a wisplight.
• Restores native rendering when global hiding or the mod is disabled.
• Kept both finite radius sliders, the Enabled checkbox and native 15/15 defaults.

Changelog

1.1.0

• Added a whole-percent mist density slider, including control without a wisplight.
• Added optional linking of wisplight radii to preserve the transition width.
• Added separate clear and transition radii for stationary wisp torches, with smooth restoration and overlapping zones.
• Set default torch radii to 24/24 m to match the native clearance radius.
• Added half-second fades when switching modes and changing settings.

1.0.3

• Removed ConfigurationManager from required dependencies.

1.0.2

• Shortened the mod description in README.

1.0.1

• Removed release history from README; changes are listed only in CHANGELOG.
• Documentation-only update; mod behavior is unchanged.

1.0.0

• First release of WispReach.
• Added two whole-meter sliders for wisplight clear radius and gradual mist transition.
• Added a separate checkbox to hide all Mistlands particle mist without a wisplight.
• Preserved native mist materials, weather fog, stationary torches and other players' wisplights.
• Retained saved settings and migration of fractional radii to whole meters.