SuperSampling (DSR)

Higher-resolution 3D rendering with normal-size HUD and menus.

0.1.2 is the renamed Valheim 1.0 compatibility test release. Built with Unity 6000.0.75f1 references and BepInExPack 5.4.2350. The required hooks were checked against the Valheim 1.0.12 public reference API. All 43 logic checks and 21 API checks passed. These references omit method bodies; live Valheim rendering, Harmony patching, UI behavior and GPU/DSR testing remain unverified.

Install

1. Install BepInExPack Valheim 5.4.2350 or a compatible newer version.
2. Import this ZIP as a local mod in your mod manager, or copy its BepInEx folder into the Valheim game folder.
3. Launch the modded game. Press F8.
4. Choose In-Game → 150% → Apply to begin.

Install on your playing client. A server installation is unnecessary. No Jotunn, Configuration Manager, NVIDIA SDK, or separate shader download is required.

Updating from Valheim Supersampling 0.1.0 or 0.1.1: close Valheim and replace BepInEx/plugins/ValheimSupersampling/ValheimSupersampling.dll with this version. Keep only one copy of the plugin. Your existing configuration, native display reference and shortcuts are retained.

Controls

Shortcuts are configurable. The settings panel uses keyboard and mouse.

In-Game

• 125%, 150%, 175%, 200%, or custom values from 100% to 300%, including decimals.
• Scales both world-render dimensions. 200% means 4× as many pixels.
• HUD, inventory, map UI, and menus retain normal output resolution and layout.
• Uses Valheim's separate world framebuffer and UI presentation.
• Defaults to trilinear mipmapped downsampling. Optional basic bilinear filtering can look sharper at fractional scales.
• Uses the game's normal windowed, borderless, and fullscreen output paths. Actual DirectX/Vulkan behavior still needs game testing.
• Has no NVIDIA requirement.

Scale is relative to the current game output. Use the monitor's native output for the usual supersampling setup. Higher scales increase GPU work and VRAM use. Targets beyond the GPU dimension limit or 67,108,864 pixels are rejected. Allocation failure disables the feature; this cannot prevent every driver or memory-exhaustion crash.

NVIDIA / System DSR

1. Enable your preferred DSR/DLDSR factors in NVIDIA's driver settings.
2. Open F8 → System DSR.
3. Check the native reference, refresh the list, and select a higher resolution.
4. Leave Keep UI at native size enabled. UI adjustment 100% adds no extra enlargement.
5. Apply, then choose Keep within 15 seconds after the mode applies.

The list contains higher, matching-aspect resolutions exposed by Unity, with refresh rates. Unity does not identify entries as DSR, DLDSR, custom modes, or another vendor's equivalent. The driver selects the downsampling algorithm; the mod does not enable driver factors or implement NVIDIA's proprietary filters.

System mode currently uses Windows exclusive fullscreen. Leaving it restores the previous resolution and fullscreen/windowed mode. For windowed supersampling, use In-Game. If no higher modes appear, check driver settings and restart the game.

The game's 3D resolution cap is bypassed while either mod mode is active, so it cannot undo the higher world resolution. Off resumes the game's current graphics settings.

UI compensation evaluates Valheim's normal sizing at the native reference, then scales that result for the higher output. This retains the existing Valheim UI-size preference and avoids multiplying its high-resolution scaling twice. Other mods' independent UI systems may need their own settings.

Recovery and compatibility

• Unapplied resolutions get a 20-second application timeout.
• Applied modes get a separate 15-second Keep / Revert countdown.
• A recovery record is saved before display changes and retained until restoration is verified.
• DSR must be selected manually each launch; the last selection is remembered. In-Game can resume automatically.
• Changed/missing framebuffer or UI hooks produce a status message. Field types, static/instance status, return types and parameter types are checked. Failed adapter installation removes its own patches. In-Game does not require the DSR UI hook.
• The native reference is initially estimated from desktop/output size. Correct it if the desktop already uses DSR or you change monitors.
• VR, replacement render pipelines, and third-party UI systems are not verified. Avoid combining this test build with another mod that takes over the same framebuffer.

First game test

1. In a world at native output, test In-Game at 125%, 150%, and 200%.
2. Compare foliage, distant edges, water, sky, fog, and post-processing against Off at the same position.
3. Open inventory, full map, settings, and menus. Check size, sharpness, and mouse alignment.
4. Resize the window, change scenes, and toggle Off. Check for black frames, inverted images, or missing UI.
5. If DSR is available, test Revert, Keep, and Off / restore.

If something fails, use Left Ctrl + F8. Send BepInEx/LogOutput.log and the report from F8 → Display reference and diagnostics → Write diagnostic report. Its filename is BepInEx/config/mods.valheim.supersampling.diagnostics.txt.

To uninstall: turn Off, close Valheim, and remove BepInEx/plugins/ValheimSupersampling. After an interrupted DSR session, leave the recovery record in place and launch once with the mod so it can restore the display.

Technical references

• Valheim 1.0 release notes
• Valheim 1.0.12 hotfix notes
• BepInExPack Valheim
• Unity render texture mipmaps
• Unity display switching
• NVIDIA DSR/DLDSR and driver setup

Changelog

0.1.3

• Clarify that render scale starts from the current game output, including 720p, 1080p, 1440p, 4K, ultrawide and custom sizes.
• Replace the mostly 1080p examples with a range of starting resolutions, including 4K to 8K.
• Clarify render-size limits and how system DSR choices depend on the native reference and driver.
• Documentation and version metadata update only; rendering behavior is unchanged.

0.1.2

• Rename the Thunderstore package to SuperSampling_DSR and the in-game/README title to SuperSampling (DSR).
• Retain the plugin ID, DLL path and configuration so existing settings continue to work.
• Rendering behavior is unchanged from 0.1.1.

0.1.1

• Update the build target to Valheim 1.0.12 reference APIs and Unity 6000.0.75f1.
• Update the Thunderstore dependency to BepInExPack Valheim 5.4.2350.
• Share exact framebuffer, UI and input member requirements between runtime bindings and offline checks. Validate field types, parameter types, return types, and static/instance status.
• Resolve input hooks by their complete signatures and catch binding failures during startup.
• Remove an adapter's own patches if its installation fails.
• Include the reference target and loaded BepInEx version in diagnostics.
• Add a game API check to the Windows build script and derive the ZIP version from the manifest.
• Preserve plugin identity, configuration keys, shortcuts and both rendering modes.
• Zero compiler errors/warnings; 43 logic checks and 21 API checks passed.
• Public references have stripped method bodies. Live Valheim/GPU and DSR validation remain pending.

0.1.0

• Initial client-side test release.
• World supersampling: 125%, 150%, 175%, 200%, and custom 100–300% scales.
• Trilinear mipmapped downsampling; optional basic bilinear filtering.
• F8 settings with render/output dimensions.
• Optional system DSR resolution selection and native-size UI compensation.
• Timed confirmation, recovery journal, emergency Off, and diagnostics.
• Compiled with Unity 6000.0.61 references and BepInExPack Valheim 5.4.2333.
• 43 automated logic checks passed. Live Valheim/GPU validation is pending.