Valheim Visual Enhanced

Valheim Visual Enhanced is a client-side graphics mod that enriches Valheim with carefully integrated visual effects while preserving the game's original style. THIS IS NOT RESHADE. Its effects respond to Valheim's lighting, water, weather, biome, and time-of-day systems instead of applying a generic screen filter.

Visual examples

1. Underwater caustic lighting

Optional animated caustics add moving sunlight patterns to shallow underwater terrain and objects. They respond to sunlight, wind, water depth, weather, and viewing distance, then pass through Valheim's own water refraction.

2. Meadows fireflies

Small yellow fireflies appear outdoors in the Meadows at night. They are subtle one-pixel particles, smoothly fade near shelter, and do not add lights, colliders, shadows, or gameplay behavior.

3. Enhanced Environment

Optional all-day color palettes refine sunlight and fog across dawn, day, dusk, and night. The feature is disabled by default, preserves Valheim's weather and biome behavior, and leaves the normal sun path intact unless its separate override is enabled.

4. Wind-driven cloud shadows

World-anchored clouds follow Valheim's wind and attenuate direct light before fog, while native shadow maps remain in control. The result is atmosphere that belongs to the world rather than a post-process overlay.

Features

• World-anchored cloud shadows that follow Valheim's wind.
• Direct-light attenuation integrated before fog, preserving atmospheric haze.
• Native Valheim shadow maps remain active.
• No directional-light cookie replacement, so the cookie slot remains available to Valheim and other mods.
• Optional animated underwater caustics on opaque terrain, rocks, structures, characters, and other depth-writing surfaces.
• Caustics respond to sunlight, weather, water depth, viewing distance, and wind.
• Flowing caustic motion bends layers independently and varies filament thickness without an additional texture or additional texture samples.
• Automatic fading at night and under roofs or inside caves.
• Optional full-day Enhanced Environment palettes: warm GoldenSaga, lush VerdantWilds, cool Frostbound, bold amber/crimson Emberfall, vivid teal/violet AuroraVeil, or configurable Custom; the separate sun-angle override is off by default and weather/biome behavior remains authored by Valheim.
• One narrowly scoped Harmony hook supplied by BepInEx; no Jotunn, network synchronization, or additional cameras.
• Subtle yellow Meadows fireflies at night: one particle renderer, a 1x1 white texture tinted yellow through Valheim's native Thistle particle material; no lights, colliders, shadows, or per-firefly GameObjects.

Underwater caustics are enabled by default and can be controlled independently through Water Caustic Lighting.Enabled in the configuration file or BepInEx ConfigurationManager.

Requirements and compatibility

• Valheim 1.0 / Deep North on Windows.
• BepInExPack for Valheim 5.4.2350 or newer.
• Unity Built-in Deferred Shading with directional shadows enabled.
• Direct3D 11. The included shader bundle is built for D3D11; Vulkan is not currently validated.

This build's AssetBundle was rebuilt with Unity 6000.0.75f1, matching the Valheim 1.0 Windows engine. Valheim Visual Enhanced is client-side. Servers and other players do not need to install it.

Installation

Thunderstore, r2modman, or Gale

Install Valheim Visual Enhanced with the mod manager. Its BepInEx dependency is declared in the package manifest.

Manual installation

1. Install BepInExPack for Valheim.
2. Copy the ValheimVisualEnhanced folder into Valheim/BepInEx/plugins/.
3. Start Valheim once to generate BepInEx/config/dev.local.valheimvisualenhanced.cfg.

Do not install the mod on a dedicated server unless you only want to keep a copy there; it has no server-side behavior.

Default configuration

Hotkeys are unassigned by default. BepInEx ConfigurationManager is optional. MigrateLegacyCloudCoverageOnce is only for a known old configuration that used inverse cloud-coverage semantics; it resets itself after one migration. FlowingMotion=false selects the classic 0.2.0 caustics timing and wind carrier for a direct visual comparison. Enhanced Environment uses RGB channels in the 0..255 range and is disabled by default. Enable it with its Enabled setting or Hotkeys.ToggleEnhancedEnvironment. Choose its Preset through ConfigurationManager; Custom enables the RGB controls. It preserves Valheim's sun position unless OverrideSunAngle is enabled. Emberfall adds a bold amber/crimson grade, while AuroraVeil adds a vivid teal/violet grade. Meadows Fireflies are enabled by default in the Meadows at night. Their 12..64 particle cap controls the effect's small GPU cost; the default is 36. Each particle fades in and out while staying mostly steady during its visible lifetime. AutoDisableMeadowsFirefliesUnderRoof=true softly fades them out under a roof or in an interior.

Existing configurations for Valheim Visual Enhanced retain their saved values when the mod is updated. The former CloudShadows package uses a different GUID; remove it before installing this renamed package.

Known limitations

• Cloud shadows affect opaque lighting only and require Deferred Shading.
• Caustics require a depth-writing receiving surface; depthless transparent objects cannot receive them.
• The caustic pattern is an efficient visual approximation and is not derived from Valheim's actual water normals or wave simulation.
• Stereo/VR cameras are disabled rather than using an incorrect mono projection.
• Vulkan and non-Windows graphics backends have not been validated.
• Another mod that patches EnvMan.SetEnv may need a compatibility check.

Troubleshooting

• If cloud shadows are absent, confirm that Valheim is using Deferred Shading and directional shadows are enabled.
• If another visual mod produces unexpected results, temporarily disable it to identify command-buffer or post-processing conflicts.
• The optional diagnostic hotkey writes debug_output.txt beside the plugin DLL. Assign it through the configuration file or ConfigurationManager first.

Plugin GUID: dev.local.valheimvisualenhanced
Version: 0.5.7