Repository navigation
Releases
Witcher 3 VR – Remastered fork v0.9.8v2-remastered.4
Witcher 3 VR – Remastered fork, v0.9.8v2-remastered.4
Release of this fork of Witcher 3 VR by tig3rmast3r.
All credit for the mod goes to him; this fork adds support for The Witcher 3 Remastered on top of
his v0.9.8v2 release. Many of the 5.x improvements come from
kaarele/witcher3-remastered-vr (MIT), taken
over feature by feature.
On 5.x, use this fork only. The original v0.9.8v2 is made for 4.04; on 5.x its scripts fail to
compile (@wrapMethod cannot wrap 'HorseRiding::OnGameCameraPostTick') and its game hooks do not
match.
Game versions
- The Witcher 3 Remastered, patch 5.01 (GOG): Stereo or Mono with the game's FXAA, FSR per
eye or, on NVIDIA, DLSS per eye (launcher choice). TAAU, ray tracing, AER + AFW,
OptiScaler, ReShade and OFXR are not ported to 5.x yet. - The Witcher 3 Next-Gen 4.04: as in the original v0.9.8v2, plus the fixes of this fork.
- Newer Remastered patches (for example 5.1c) are not supported yet. The mod detects them and
keeps its game hooks off, so it does nothing there. Keep the game on 5.01 for now (GOG: turn off
auto-update and roll back to 5.01).
The 5.x port is made for the normal third-person game and tested with a gamepad. VR controllers
and the first-person mode are not tested yet on 5.x.
Changes compared to v0.9.8v2-remastered.3
Image and stability on 5.x
- No left-eye glitch in dialogues:
[openxr] native_stereo=1half-enabled the 4.04 asymmetric
projection, which is not ported to 5.x. In Full VR dialogues the left eye then briefly showed the
right eye's image now and then. Merely opening the launcher set it to 1 until the next Save. The
mod now ignoresnative_stereo(and the F2 toggle) on 5.01, and the launcher keeps it at 0 on
5.x. Headset: glitch in 4 of 4 dialogue runs before, 0 of 3 after. - No flash at cutscene camera cuts with FSR or DLSS per eye: the game never restarts the
upscaler history at a camera cut, so after a cut in a dialogue or cutscene both eyes briefly
blended in the previous shot. The mod now restarts both eye histories at every Full VR camera cut
([engine] remaster_cut_history_reset, on by default), as it already did for TAAU on 4.04. - No double image behind the system menu: the game keeps rendering both eyes behind the system
menu, and the menu panel alternated between them from frame to frame, so the scene behind the
menu flickered as a double image. The panel now shows one eye (the background runs at half the
frame rate there). The menu itself is unchanged. - No black rectangle during fades: the game draws its fade to black (loading, scene changes,
fast travel) into the HUD layer, which showed as a black HUD-sized rectangle in VR. The whole view
now darkens with the fade instead ([openxr] hud_fade_mode=uniform, default;removedrops the
fade,nativekeeps the game's rectangle). Taken over from kaarele's fork, withuniformas the
default here becauseremoveshowed a short flash at the start of cutscenes.
HUD and menus on 5.x
- Sharper HUD text: a HUD made smaller with
hud_sizeskipped pixels, so text broke up and
shimmered with head motion. The HUD is now filtered ([openxr] hud_filtered_sampling, on by
default on 5.x, off on 4.04). Taken over from kaarele's fork. - Subtitles stay in place with the controller-locked HUD: with Controller-locked HUD
([openxr] hud_controller_locked=1) the HUD already stayed in the recentered direction during
gameplay; now subtitles and dialogue choices in Full VR cutscenes and dialogues do too. - Loading screen stays in place: the main menu and the loading screen after Continue followed
every head turn, which felt jerky with the loading screen's moving picture. They are now fixed in
the room like the in-game menus, in the direction you look when they appear (placed again if the
headset moves more than 0.5 m, for example while putting it on). 4.04 is unchanged.
Launcher
- DLSS per eye (5.x, NVIDIA): the "FSR per eye (5.x)" checkbox is now an anti-aliasing choice
next to Integration: FXAA (5.x), FSR per eye (5.x) or DLSS per eye (5.x). DLSS per eye
writes the game's DLSS (AAMode=6,AllowDLSS=true) and[engine] temporal_backend=dlss, which
before had to be set by hand. Confirmed on an NVIDIA RTX 5090 by a user (#23). The Linux tool
acceptsconfigure --aa dlsson 5.01 as well.
For testers
[debug] history_event_log=1writes only the per-eye upscaler history events (resets, camera
cuts) towitcher3vr.log, without the cost of the full diagnostics.
The changes of v0.9.8v2-remastered.3 and .2 are described in their release notes
(.3,
.2).
Not included
- PureDark AFW (
PDAFWPlugin.dll), needed only for AER + AFW on 4.04. Copy it from the
original release intobin\x64_dx12, or
use a Stereo or Mono mode. - Fast Transitions DLC (optional, 4.04). Also in the original release (
dlcfolder). - NVIDIA DLSS5 files, as in the original release.
Installation
- Extract the archive into the game folder (the one containing
bin,contentandmods); merge
and overwrite. When the original v0.9.8v2 was installed on 5.x before, delete
mods\modWitcher3VRStateBridgefirst. - Start
bin\x64_dx12\Witcher3VRLauncher.exe. - Press Configure Settings for VR once (also when updating from v0.9.8v2-remastered.1; not
needed when updating from .2 or .3). It backs up your game settings first, and Restore
Original Settings brings them back. - Optional on 5.x: choose the anti-aliasing (FSR per eye (5.x), or DLSS per eye (5.x) on
NVIDIA) and the recenter key. - Press Save & Launch.
Tips for 5.x
- A setup that plays smoothly at 90 Hz on an AMD RX 7900 XTX with a Pico 4 over Virtual Desktop:
VR Graphics Quality "Ultra", FOV tangent 80 % horizontal and 65 % vertical, launcher resolution
AUTO (2292x1884 per eye), FSR per eye. - Controller-locked HUD in the launcher (or
[openxr] hud_controller_locked=1) and
hud_size=0.85inwitcher3vr.inikeep the HUD and subtitles in place when you turn your head
and make them easier to read.
Known issues on 5.x
- Distant water can switch between blue and white with the head pose.
- AMD GPUs need Adrenalin 26.9.2 or newer, otherwise some grass renders black (with or without the
mod). - The gameplay HUD follows the head by default (see the tip above).
- The scene behind the system menu has no anti-aliasing and runs at half the frame rate.
- Windows Defender may flag the unsigned
dxgi.dllas a false positive.
Not tested yet
- Full playthrough on 5.01: in progress. No blockers so far; later regions and quests not
tested yet. - NVIDIA GPUs in this fork (DLSS per eye was confirmed by a user, see above).
- Headsets and runtimes other than a Pico 4 over Virtual Desktop (VDXR) on Windows and WiVRn on
Linux. - VR controllers and the first-person mode on 5.x.
- Aiming with the crossbow; the cutscene camera light fix in the headset.
Full list: docs/remaster-open-issues.md.
Witcher 3 VR – Remastered fork v0.9.8v2-remastered.3
Witcher 3 VR – Remastered fork, v0.9.8v2-remastered.3
First regular (non-pre-release) release of this fork of
Witcher 3 VR by tig3rmast3r. All credit for the mod
goes to him; this fork adds support for The Witcher 3 Remastered on top of his v0.9.8v2 release.
Many of the 5.x improvements come from
kaarele/witcher3-remastered-vr (MIT), taken
over feature by feature.
On 5.x, use this fork only. The original v0.9.8v2 is made for 4.04; on 5.x its scripts fail to
compile (@wrapMethod cannot wrap 'HorseRiding::OnGameCameraPostTick') and its game hooks do not
match.
Game versions
- The Witcher 3 Remastered, patch 5.01 (GOG): Stereo or Mono with the game's FXAA, or with
FSR per eye (launcher switch). TAAU, ray tracing, AER + AFW, OptiScaler, ReShade and OFXR are
not ported to 5.x yet. - The Witcher 3 Next-Gen 4.04: as in the original v0.9.8v2, plus the fixes of this fork.
The 5.x port is made for the normal third-person game and tested with a gamepad. VR controllers
and the first-person mode are not tested yet on 5.x.
Changes compared to v0.9.8v2-remastered.2
- Characters at the edge of the view are animated on 5.x: the game only animated characters
inside its own (flat) camera view, so in VR people and animals at the side of the headset's wider
view stood frozen. They now move normally. Switches inwitcher3vr.ini:
[engine] animated_component_visibleandasync_anim_tick_visible(both on by default). - Recenter key in the launcher: choose F9, Space or Numpad / (the key used by Luke Ross's
R.E.A.L. VR mods) next to Camera Follow. A different key set by hand inwitcher3vr.ini
([openxr] recenter_key) is kept and shown as "(INI)". The HUD tooltip names the chosen key.
The changes of v0.9.8v2-remastered.2 (FSR per eye, lower CPU load, close cameras, Linux/Proton,
DLSS per eye) are described in its
release notes.
Not included
- PureDark AFW (
PDAFWPlugin.dll), needed only for AER + AFW on 4.04. Copy it from the
original release intobin\x64_dx12, or
use a Stereo or Mono mode. - Fast Transitions DLC (optional, 4.04). Also in the original release (
dlcfolder). - NVIDIA DLSS5 files, as in the original release.
Installation
- Extract the archive into the game folder (the one containing
bin,contentandmods); merge
and overwrite. When the original v0.9.8v2 was installed on 5.x before, delete
mods\modWitcher3VRStateBridgefirst. - Start
bin\x64_dx12\Witcher3VRLauncher.exe. - Press Configure Settings for VR once (also when updating from v0.9.8v2-remastered.1; not
needed when updating from .2). It backs up your game settings first, and Restore Original
Settings brings them back. - Optional on 5.x: tick FSR per eye (5.x), choose the recenter key.
- Press Save & Launch.
Tips for 5.x
- A setup that plays smoothly at 90 Hz on an AMD RX 7900 XTX with a Pico 4 over Virtual Desktop:
VR Graphics Quality "Ultra", FOV tangent 80 % horizontal and 65 % vertical, launcher resolution
AUTO (2292x1884 per eye), FSR per eye on. [openxr] hud_controller_locked=1andhud_size=0.85inwitcher3vr.inikeep the HUD in place
when you turn your head and make it easier to read.
Known issues on 5.x
- Distant water can switch between blue and white with the head pose.
- AMD GPUs need Adrenalin 26.9.2 or newer, otherwise some grass renders black (with or without the
mod). - The gameplay HUD follows the head by default (see the tip above).
- Windows Defender may flag the unsigned
dxgi.dllas a false positive.
Not tested yet
- Full playthrough on 5.01: started and still in progress. No blockers so far; later regions and
quests not tested yet. - NVIDIA GPUs, including DLSS per eye (
[engine] temporal_backend=dlss; tested by kaarele on
NVIDIA, not tested yet in this fork). - Headsets and runtimes other than a Pico 4 over Virtual Desktop (VDXR) on Windows and WiVRn on
Linux. - VR controllers and the first-person mode on 5.x.
- Aiming with the crossbow; the cutscene camera light fix in the headset.
Full list: docs/remaster-open-issues.md.
Witcher 3 VR – Remastered fork v0.9.8v2-remastered.2
Witcher 3 VR – Remastered fork, v0.9.8v2-remastered.2
Second release of this fork of Witcher 3 VR by
tig3rmast3r. All credit for the mod goes to him; this fork adds support for The Witcher 3
Remastered on top of his v0.9.8v2 release. Many of the 5.x improvements in this release come from
kaarele/witcher3-remastered-vr (MIT), taken
over feature by feature.
Game versions
- The Witcher 3 Remastered, patch 5.01 (GOG; tested): experimental. Stereo or Mono with the
game's FXAA, or with FSR per eye (new). TAAU, ray tracing, AER + AFW, OptiScaler, ReShade
and OFXR are not ported to 5.x yet. DLSS per eye exists but is untested in this fork (see below). - The Witcher 3 Next-Gen 4.04: as in the original v0.9.8v2, plus the fixes of this fork.
Changes compared to v0.9.8v2-remastered.1
- FSR per eye on 5.x (launcher switch FSR per eye (5.x)): uses the game's FSR instead of
FXAA, with one FSR history per eye, so the eyes no longer ghost into each other. Smoother edges and
much less GPU load at high resolutions, the image is a little softer. Works with the FidelityFX
path the game uses on newer AMD GPUs and with its built-in FSR 2 on other GPUs. Off = FXAA as
before. - Better temporal quality on 5.x: both eyes of a stereo pair use the same jitter and noise
pattern, and moving characters keep their motion vectors in the second eye (no smearing there). - Lower CPU load on 5.x: a new descriptor metadata store and render-thread trims (about -27 %
CPU time per frame in our benchmark), and the game thread no longer waits for each stereo pair to
finish rendering (one pair of run-ahead) while both eyes still show the same animation poses. - Close cameras on 5.x: Configure Settings for VR now also sets the game's close exploration
and combat cameras (recommended for VR). The 5.x default "Modern" camera re-frames while walking,
which in VR shows as the camera jumping between far and near when you start or stop walking. When
updating from v0.9.8v2-remastered.1, press the button once more, or choose the close cameras in the
game's camera options. - Square render sizes on 5.x: an exactly square per-eye size (for example full FOV in Virtual
Desktop) made the game crash while loading or show the sky only in a corner with an upscaler; the
mod now renders 8 pixels less in height in that case. - DLSS per eye on 5.x (
[engine] temporal_backend=dlssinwitcher3vr.ini, Anti-aliasing =
DLSS in the game): one DLSS history per eye. Tested by kaarele on NVIDIA; not tested in this fork
and not offered in the launcher yet. - Linux/Proton (Steam and Heroic/GOG): the release zip can be installed with the Linux tool from
this repository; see LINUX.md.
Itsconfigure --aa fsrsets the same FSR per eye as the launcher. - All new 5.x options can be switched off one by one in
witcher3vr.ini(described in
Witcher3VR/config/witcher3vr.example.ini); 4.04 is unchanged by them.
Not included
- PureDark AFW (
PDAFWPlugin.dll), needed only for AER + AFW on 4.04. Copy it from the
original release intobin\x64_dx12, or
use a Stereo or Mono mode. - Fast Transitions DLC (optional, 4.04). Also in the original release (
dlcfolder). - NVIDIA DLSS5 files, as in the original release.
Installation
- Extract the archive into the game folder (the one containing
bin,contentandmods); merge
and overwrite. - Start
bin\x64_dx12\Witcher3VRLauncher.exe. - Press Configure Settings for VR once, also when updating from v0.9.8v2-remastered.1 (it sets
the close cameras; it backs up your game settings first, and Restore Original Settings brings
them back). - Optional on 5.x: tick FSR per eye (5.x).
- Press Save & Launch.
Tips for 5.x
- With FSR per eye a high render resolution pays off. If 90 Hz is not reached at full FOV, reduce
the FOV in Virtual Desktop slightly (for example 80 % horizontal, 70 % vertical) or use the "High"
quality instead of "Ultra"; the launcher's AUTO resolution follows the headset's recommendation.
Known issues on 5.x
- Distant water can switch between blue and white with the head pose.
- AMD GPUs need Adrenalin 26.9.2 or newer, otherwise some grass renders black (with or without the
mod). - Windows Defender may flag the unsigned
dxgi.dllas a false positive.
Full list: docs/remaster-open-issues.md.
Witcher 3 VR – Remastered fork v0.9.8v2-remastered.1
Witcher 3 VR – Remastered fork, v0.9.8v2-remastered.1
First release of this fork of Witcher 3 VR by
tig3rmast3r. All credit for the mod goes to him; this fork adds support for The Witcher 3
Remastered on top of his v0.9.8v2 release.
Game versions
- The Witcher 3 Remastered, patch 5.01 (GOG; tested): experimental. Stereo or Mono with the
game's FXAA. TAAU, DLSS, ray tracing, AER + AFW, OptiScaler, ReShade and OFXR are not ported to
5.x yet. - The Witcher 3 Next-Gen 4.04: as in the original v0.9.8v2, plus the fixes below.
Changes compared to the original v0.9.8v2
- Remastered 5.01 support: game hooks, stereo rendering, HUD, menus, cutscenes and the OpenXR path.
Unknown game builds are detected and the game hooks stay disabled. - Full VR cutscenes: sky and trees no longer stay attached to the head in cutscenes that reuse the
game camera (4.04 and 5.x). - Cutscene and dialogue camera lights keep the camera's direction instead of following head turns
like a head lamp (4.04 and 5.x). - The recenter key is configurable:
[openxr] recenter_keyinwitcher3vr.ini(defaultF9; for
exampleF5orSpace). - Launcher: detects Remastered 5.x. Configure Settings for VR applies the 5.x VR settings there
(FXAA; ray tracing, light shafts, frame generation, low-latency modes and HDR off) and keeps all
other settings; only the modes that work on 5.x can be saved. - With AUTO resolution, the launcher reads the headset's recommended resolution on every Save &
Launch. Without a reachable headset it keeps the last known resolution instead of failing, and
asks before launching. - On 5.x the HUD editor setup no longer needs
dx12filelist.txt(5.x loads the menu XML itself). - The mod's game scripts compile on 5.x: the launcher installs the horse and boat camera script for
the detected game version (4.04 and 5.x need different state names). Start the game through the
launcher at least once after installing or updating. - Default render mode is Stereo - No AA / FXAA on both game versions (AER + AFW needs the
optional PureDark plugin). Existing settings with AER + AFW switch to the matching Stereo mode when
the plugin is not installed.
Not included
- PureDark AFW (
PDAFWPlugin.dll), needed only for AER + AFW on 4.04. Copy it from the
original release intobin\x64_dx12, or
use a Stereo or Mono mode. - Fast Transitions DLC (optional, 4.04). Also in the original release (
dlcfolder). - NVIDIA DLSS5 files, as in the original release.
Installation
- Extract the archive into the game folder (the one containing
bin,contentandmods); merge
and overwrite. - Start
bin\x64_dx12\Witcher3VRLauncher.exe. - Press Configure Settings for VR once (it backs up your game settings first; Restore
Original Settings brings them back). - Press Save & Launch.
Known issues on 5.x
- Only FXAA anti-aliasing; a higher render resolution helps (Virtual Desktop "Ultra" or above).
- Distant water can switch between blue and white with the head pose.
- AMD GPUs need Adrenalin 26.9.2 or newer, otherwise some grass renders black (with or without the
mod). - Windows Defender may flag the unsigned
dxgi.dllas a false positive.
Full list: docs/remaster-open-issues.md.