You are viewing a potentially older version of this package. View all versions.
Ivvty-ValheimVisuals-1.4.2 icon

ValheimVisuals

Valheim Visuals: a set of graphics settings I like, made into a mod — water tessellation, reflections, normal maps and AO turned up within the game's own declared ranges.

By Ivvty
Date uploaded 3 weeks ago
Version 1.4.2
Download link Ivvty-ValheimVisuals-1.4.2.zip
Downloads 395
Dependency string Ivvty-ValheimVisuals-1.4.2

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2351 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2351

README

ValheimVisuals

A set of graphics settings I like, made into a mod.

Valheim's own shaders support more than the game uses: its water supports tessellation and refraction but is set to 4 of a possible 32 and 0.01, building normal maps are applied at intensity 1.0, and snow and rain are lit as flat sprites. This mod tunes those existing effects. Optional bicubic upscaling and the opt-in screen-space lighting use small bundled shaders; the game's world and material shaders are not replaced.

What it changes

Vanilla Default here
Shadow distance 150 m 300 m
Shadow resolution High Very High, cascades weighted towards the player
Anisotropic filtering level unset 16×
Ambient occlusion G-buffer only, 10 samples Medium with downsampling, from depth so grass and leaves are occluded too; intensity 0.1
Screen space reflections off off (switch available: High resolution, 128 ray steps, intensity ×2)
Depth of field game's switch only blur size, focus, aperture and quality controls
Reflection probe cubemaps ~128 px 512 px
Reflection refresh every 3 s, each new one sweeping in from the player every 1 s, each new one fading in (Reflections.SmoothRefresh)
Water tessellation 4 of 32 16
Water refraction 0.01 0.2
Water metallic 0 0.8
Water detail distance 120 m 350 m, the game's far sea moved to the same distance
Antialiasing TAA the game's TAA; optional contrast-adaptive sharpening (AMD FidelityFX CAS, PostFx.CasSharpen, off), which leaves grass and foliage alone
Normal map intensity ×1 ×1.4 on the game's materials that have one
Particle lighting by facing 0 0.5: snow and rain catch firelight
Grass radius 140 m 200 m

On by default: contact shadows, GTAO ambient occlusion and caustics (the waves' light on the shallow sea bottom, section Caustics); optional, off by default: screen-space indirect light — effects the game does not have, drawn by the mod's own shaders (see below) — and cloud shadows (see "World effects"). The fireflies are WeatherOverhaul's now. A new water surface is a separate mod, ValheimWater; this one stands its water settings down while ValheimWater draws the sea.

Colour grading, exposure, fog and world loading distance are left as the game ships them. LOD overrides are optional and off by default. Nothing that affects gameplay is touched (torch shadows, which the stealth system reads, stay as they are).

Requirements and install

  • BepInEx for Valheim. Configuration Manager is optional but recommended.
  • Install with a mod manager, or put ValheimVisuals.dll into BepInEx/plugins. Client-side: the server neither needs nor notices it.

Settings

Every value applies live. The config is grouped by module (Shadows, Surfaces, PostFx, DoF, Vegetation, Reflections, Materials, Water, Particles, Rendering), each with an Enabled switch; a switch turned off hands the value back to the game rather than writing a remembered one. General.Enabled switches the whole mod off; the Compare key (Right Arrow by default) restores everything the mod changed for this session only, for a before-and-after comparison.

Additional controls

All of these overrides start disabled or set to Vanilla, so upgrading does not change the existing look.

Setting What it does
PostFx.UseTaaSpread, TaaSpread TAA jitter diameter, 0.1–1.0 pixels. Requires Antialiasing = Taa. Lower is sharper but may shimmer more.
PostFx.Vignette Vanilla, explicit Off, or On, with intensity, smoothness and roundness controls.
PostFx.DisableSsr Explicitly disables screen-space reflections, including those in the original profile. Takes precedence over SsrEnabled.
Reflections.DisableEnvironmentReflections Suppresses reflection probes and the sky reflection fallback; pauses the game's periodic probe refreshes. Direct-light highlights remain.
Rendering.UseRenderScale, RenderScale Custom 25–100% internal 3D resolution, with UI at screen resolution. Follows window resolution changes. 75% means 75% of each dimension, not 75% of pixel count.
Rendering.Filter Vanilla, Bilinear, Pixelated, or Bicubic (Catmull–Rom). Works with either the game's scale or the custom percentage; only affects rendering below native resolution.
Rendering.UseLodBias, LodBias Overrides the game's global LOD bias, 0.25–5. Higher values retain detailed models farther away.
Rendering.UseTreeLod, TreeLodMultiplier Multiplies LOD distances for loaded TreeBase trees, 0.25–4, in addition to global bias. Does not alter rocks, buildings, world loading distance or distant vegetation managed by other mods.

Screen-space lighting (opt-in)

Three passes of the mod's own on the game's deferred camera, each with its own Enabled (off by default). Every opaque shader of the game writes the G-buffer they read — grass and leaves included — so they apply to everything solid on screen. Screen space means they only know what is on screen: what is off screen or hidden behind something does not cast, occlude or bounce.

Section What it does Settings
ContactShadows Short sun shadows the shadow map is too coarse for: stones on the ground, plank edges, the foot of a post, grass at its roots. Written into the game's own sun shadows, so only direct sunlight is darkened. Needs the game's shadows on. Length 0.35 m, Distance 80 m, Strength 0.2, Thickness 0.1 m
Gtao Ambient occlusion that darkens only the sky light and reflections, not the sun or torches: room corners, eaves, roots, the foot of a wall. Thin things (grass, posts) hide only what lies within Thickness behind them, so there are no dark halos. Replaces the post-processing occlusion: PostFx.AmbientOcclusion and the game's SSAO setting are overridden off while it is on, and come back when it is off. Radius 1.5 m, Strength 1, Thickness 0.5 m, Quality 2
IndirectLight One bounce of light between surfaces: sunlit sand lighting the shaded side of a wall, firelight off walls onto the floor, colour from grass on the trunks beside it. The game otherwise lights everything with direct light plus one flat sky colour. Intensity 1, Radius 4 m, Thickness 0.5 m, Quality 2

World effects

Section What it does Settings
CloudShadows The game's own clouds shade the land where they are on the sky, moving with them, through the sun's light (everything it lights, the water too; caustics dim under them). They fade out in rain, when the game's sky is one grey deck. Stands down while WeatherOverhaul draws the clouds (it casts its own clouds' shadows), and leaves the sun alone if another mod already puts a cookie on it. Strength 0.7

Thickness is how deep a surface on screen is assumed to be: the depth buffer has nothing behind what it shows. GTAO and the indirect light need an HDR camera (Valheim's is) and draw nothing otherwise. With the post-processing module off (PostFx.Enabled = false) the mod cannot switch the game's own SSAO off, and both occlusions would apply.

SsrEnabled = false retains its original meaning: stop enabling/tuning SSR. Use DisableSsr = true to force it off. Likewise, Reflections.Enabled = false hands control back to the game; it does not disable the game's reflections. To suppress both reflection sources, enable both explicit disable switches while keeping their modules enabled. Custom shaders from other mods can implement additional reflections outside these controls.

The game's built-in scaling path only supports resolutions below native. Values above 100% would require a separate supersampling implementation. Bicubic adds GPU work compared with bilinear; its effect is reconstruction quality, not new image detail. Windows/Proton and native Linux shader bundles are embedded in the DLL. If the shader cannot load on a platform, filtering falls back to bilinear with a log warning.

Performance

The extra effects cost GPU time. On a Ryzen 5 5600X and RTX 4070 SUPER at 2560×1440, screen-space reflections were the largest cost (about 4 ms) and ambient occlusion the next. SSR is off by default: water never shows it and most of Valheim's surfaces are too rough to, so PostFx.SsrEnabled is there for anyone who wants it anyway. The AO default (Medium, downsampled) is the cheaper setting measured, and PostFx.AmbientOcclusion = false is the next thing to turn off for headroom. At 1280×720 contact shadows measured 0.045 ms, GTAO 0.11 ms and the indirect light 0.14 ms per pass (each drawn many times, the difference divided: the game reports no GPU timings; the repeated part is the trace or gather, not the copies, blurs and final composite); four times the pixels at 1440p costs roughly four times as much. Measured on one machine, so results elsewhere will vary.

Compatibility

Works alongside texture replacement mods (normal-map intensity is re-applied to the game's materials they change later; materials on another mod's own shaders are left alone). Do not combine it with a mod that replaces the water shader outright.

The water settings also stand down while ValheimWater draws the sea (it replaces the shader they tune).

Leave the LOD overrides off when another mod manages the same LOD groups. WeatherOverhaul ownership is respected: the environment reflection switch also yields while WeatherOverhaul declares ownership of reflection probes, and the cloud shadows while it draws the clouds. SSR remains a separate post-processing control.

If another mod replaces the camera's post-processing profile, ValheimVisuals yields instead of repeatedly replacing that profile. Changing a PostFx setting or toggling the module off/on permits it to acquire the new profile. Mods that continuously write the same effect parameters can still conflict; configure each shared effect in one mod.

Building and checking

dotnet build -c Release uses the checked-in shader bundles. Rebuild them with tools/Build-Shaders.ps1 (Unity 6000.0.75f1 with Windows and Linux build support). No downloaded Unity packages are needed for this shader project. The Unity project's ShaderChecks.Run checks the built bundle, the screen-space passes included, on a synthetic frame. dotnet run --project tests/Checks/Checks.csproj checks value ownership and scale boundaries. Build tests/Runtime/Runtime.csproj, then run tools/Test-Runtime.ps1 for menu-only integration checks in an installed game. The runner refuses to interrupt an existing game, uses a separate save directory, restores the installed DLL and config, and leaves results under tests/results. It does not load a world or character. tools/Run-Stand.ps1 loads a world (backed up first, saves blocked and compared afterwards) and photographs the screen-space lighting around a stone wall on a sunlit shore (-Extra '-stand-screen-cost' adds its cost); results go to Documents/ValheimVisualsStand.

More

The FAQ covers what to switch off when something looks wrong, the depth-of-field controls, and texture packs.

Contrast-adaptive sharpening is a port of AMD FidelityFX CAS, MIT licence, Copyright (c) 2020 Advanced Micro Devices, Inc.

Problems and feedback

Write to me on Discord: https://discord.com/users/683075123816824940. Attach BepInEx/LogOutput.log from the game folder, or from the profile folder with a mod manager (r2modman: Settings → Browse profile folder), and say what you did when it happened. A screenshot with the Right Arrow comparison (the game's own values against the mod's) helps with anything visual.

CHANGELOG

Changelog

1.4.9

  • Fixed: contact shadows and the other passes on the sun now run for the player's camera only. They also ran for other cameras, such as PortalPreview's views of portals.
  • Fixed: the grass radius has one owner among the mods that set it: Valheim Visuals while its own radius setting is on, then FarLands, then the game. Switching one of them off in the settings could leave the wrong radius in place.
  • Next to a mod that sets the grass radius itself, such as HD Terrain, the radius is left to that mod for the world, and the log says so.

1.4.8

  • The grass radius follows the GPU grass wherever it comes from: SteadyFrame 1.3.0 or FarLands 1.3.0. While its own radius setting is on, FarLands leaves the radius to it.
  • The DLL now tells BepInEx its real version (1.4.7 still said 1.4.6).
  • Contact shadows are traced by Bend Studio's screen-space shadows (from Days Gone): each pixel is tested against every pixel between it and the sun, up to 60, where it took 16 jittered steps before. Thin things - grass blades, plank edges - now cast without the steps' grain, and the pass costs half as much (0.067 against 0.135 ms at 2560x1440). Without compute shaders the old march still draws them.

1.4.7

  • Reflections drop any broken (non-finite) pixel from each new render before showing it, so it can no longer appear as black marks on reflective surfaces, such as the dashes reported on the ice of the Deep North. Works with Smooth refresh on, the default.
  • The grass radius (Vegetation.UseDistance, Distance) now applies only while SteadyFrame draws the grass on the GPU. Without it the game's own radius stays: there each 8 m patch of grass is a draw of its own, and 200 m cost some 3.5 ms of main thread a frame more than the game's 45 m on open land (2560x1440), against 0.5-1 ms with SteadyFrame.
  • With the radius applied, grass reaches it. Most kinds stopped at 100 m of their own whatever the radius, so 200 m looked like 100 m on the Plains. Reeds and water lilies stay near: they are heavy or cast shadows.

1.4.6

  • On a dedicated server Valheim Visuals switches itself off. The server's build of the game lacks the graphics code it changes, which logged "PatchAll failed" there.
  • If a game update removes something the mod changes, only that part stays off, and the log names it. Before, every change after the failing one was silently lost too (on such a build: render-scale settings and the snow-speckle fix).

1.4.5

  • Fixed reflective surfaces that could turn black and stay so until reflections were switched off.

1.4.4

  • Caustics follow the water's real height, so they stay under the sea when a tide mod (Tides) lowers or raises it: no more caustics on the dry shore or on a boat's deck at low tide, and none missing on the flooded shore at high tide.

1.4.3

  • Cloud shadows no longer put a flickering dark band on the world tree in the sky, and the clouds no longer shade themselves. They now go through the sun's own shadows instead of a pattern on the sunlight, so they reach as far as the game's sun shadows (about 300 m).

1.4.2

  • Fixed black patches on the ground with Badger's HD Terrain installed.
  • Grass no longer ripples: the game's own antialiasing is the default again. The optional sharpening is off by default.
  • Reflections fade smoothly into their next update instead of jumping.
  • New: the game's clouds cast shadows on the land (CloudShadows, off by default).
  • Softer contact shadows and less water refraction by default. Configs that still have the old defaults move to the new ones.

1.4.1

  • Stronger normals and particle lighting now apply only to the game's own shaders, not to other mods' materials.

1.4.0

  • New: caustics, the waves' light rippling over the shallow sea bottom and what lies beneath (Caustics, on by default).
  • Stronger normals and particle lighting now also reach materials the game loads while you play: locations, dungeons and texture packs.
  • Caustics cost nothing where they cannot be seen: in dungeons, high above the sea, or in the dark.
  • With the water settings off, or while ValheimWater draws the sea, the mod leaves the water's detail distance alone.
  • Caustics fade under the moon, under clouds and in cloud shadows instead of shining as in full sun.
  • No more empty squares in the sea at the edge of the loaded area: near and far water now meet.
  • Reflections follow the scene within about a second instead of up to six (Reflections.RefreshSeconds).
  • Caustics follow the waves, so no light on sand a wave has left dry.
  • Settings window: grouped and ordered, the main switches first.
  • New "AO even far": ambient occlusion no longer darkens the distance more than the foreground (off by default).
  • Contact shadows and GTAO ambient occlusion are on by default; they cost a fraction of a millisecond on the GPU.
  • The Preset setting is gone. The Right Arrow key is now the Compare key: it shows the game's own look and back for this session. A config with Preset = Off keeps the mod off through Enabled.

1.3.1

  • Optional screen-space lighting, each off by default: ContactShadows (short sun shadows inside the game's own shadow map), Gtao (ambient occlusion of the sky light only, thin objects cast no halo; replaces the post-processing occlusion while on) and IndirectLight (one bounce of light between surfaces on screen).
  • Fixed: with AugaLite installed, antialiasing, ambient occlusion, vignette, reflections and depth of field were lost after a portal trip or dungeon entrance and did not come back when the mod was switched off and on.
  • The water settings stand down while ValheimWater (a separate mod with a new sea surface and caustics) draws the water.
  • Fixed a dark ragged band along the sea's horizon: the distant flat sea started closer than the waves and left the crests sticking out. The far sea now starts where the waves end, and the detail distance is capped at 350 m.

1.3.0

  • Optional TAA jitter spread and vignette controls, including an explicit vignette Off mode.
  • Separate switches to turn off screen-space reflections and environment reflections.
  • Custom render scale from 25 to 100%, with bilinear, pixelated or Catmull–Rom bicubic upscaling.
  • Optional global LOD bias and a separate multiplier for loaded tree LODs; both leave the game's settings alone by default.
  • Graphics changes you make later are kept, and the mod stands down if another mod takes over post-processing.
  • Mountain snow no longer breaks into shimmering patches.
  • With WeatherOverhaul installed, the water and reflection modules stand down where WeatherOverhaul owns the water or the reflections, and come back when it stops.

1.2.4

  • Screen space reflections are off by default, existing configs included: they cost the most FPS and could stutter for almost no visible change. PostFx.SsrEnabled turns them back on.

1.2.3

  • The Thunderstore package now depends on BepInExPack_Valheim 5.4.2351 instead of 5.4.2202, which predates the pack's fixes for the game's Unity 6. Nothing changes in the game.
  • README: where to report problems.