BetterVR hooks Cemu to add PC VR to Breath of the Wild, and the CPU is the bottleneck

It modifies code, not game data, and that is the whole compatibility story

BetterVR is described as a VR mod and hook that adds a PC VR mode for BotW using the Wii U emulator called Cemu. The primary language is C, and the repository carries a CMakeLists.txt, CMakePresets.json, a `Cemu/` directory, a `launcher/` directory, a `MetaXRSimulator/` directory, and a vcpkg.json for C++ dependencies.

The design decision that makes it usable with other mods is stated as one bullet in the feature list: BetterVR only modifies the code and no game data, so most other mods should be compatible. That is a meaningful architectural constraint rather than marketing. A mod that rewrites assets conflicts with any other mod that rewrites the same assets; a hook that sits in the emulator's execution path does not.

The rendering claim is specific and worth quoting because it distinguishes this from cheaper approaches: fully stereo-rendered with 6DOF, with full roomscale support, and no alternated eye rendering is used. Alternated eye rendering is the shortcut where each eye is drawn on alternating frames, which halves the cost by cutting the frame rate in half. The mod does not do that, which is why the CPU requirement is what it is.

Interaction coverage is complete enough to call it a port rather than a proof of concept. Full hands and arms, so you can deck yourself out in whatever clothing. Wielding weapons, torches and bokoblin arms into combat. Gestures to equip and throw weapons. Motion controls to interact with the world for puzzles and starting fires. An optional third person mode is there as an out.

Licence is MIT, and the last push was on 2026-08-24 with release 0.9.23 on the same day, after 0.9.22 and 0.9.21 within hours of each other the day before.

The requirements section is the real product documentation

The README's requirements list is unusually specific, and two entries are performance warnings rather than prerequisites.

Any OpenXR headset is supported, as long as the VR controllers have enough buttons. That phrasing tells you the mod reads controller buttons rather than tracking a specific headset model, so any OpenXR runtime that exposes buttons works.

The hardware note is the one to read twice: a gaming PC with a CPU that is good at single-threaded workloads, with a recent Intel i5 or Ryzen 5 recommended at least. The GPU matters a bit, but the CPU is the bottleneck. Later, in the graphic pack settings, the README says the mod is not very GPU intensive and that a higher resolution multiplier might not cost any performance. Those two statements agree, and they are unusual: a VR project where the GPU is the cheap part.

A legal copy of BotW for the Wii U is required, and the game must list update `V208`.

Windows is required, and the reason is not hedgeable. The README states it does not work under Linux, even with Wine or Proton, and links an issue about it.

Cemu must be properly set up and able to run at 60FPS or higher before anything else is attempted, and only Cemu 2.6 is tested to work. There is a warning in bold inside that bullet: before reporting issues, make sure you have a working version of the game that can go in-game on your PC before installing this mod. That is a maintainer telling you what fraction of bug reports are misdirected.

Eight installation steps, and the two that actually break things

The installation is a numbered procedure, and two steps are called out in bold as non optional.

Step 1 is downloading the latest `BetterVR_Launcher.exe` from Releases. Step 2 is moving it into the same folder as `Cemu.exe`. That co location matters, because the launcher needs to find the emulator.

Step 3 is Cemu configuration, and it contains the setting that most affects performance. Under Debug, Accurate Barriers (Vulkan) must be disabled. Under Options, General Settings, Graphics, the Renderer must be set to Vulkan, the correct GPU selected, and VSync off. Under Options, Graphic Packs, the community graphic packs must be downloaded and updated. The README also asks you to confirm the window title says version 2.6 or newer and that BotW is in the game list at update `V208`.

Step 4 is the VR runtime. Close Cemu, connect the headset, start Virtual Desktop or SteamVR, and confirm the OpenXR runtime is set properly, with separate wiki links for Virtual Desktop and for SteamVR, ALVR and Meta Quest Link.

Step 5 is the critical one. Under Options, then Graphic packs, then The Legend of Zelda: Breath of the Wild, both `BetterVR` and `Mods` then `FPS++` must be enabled, and the README says in plain words that the game will crash without it.

Step 6 is tuning. The VR Resolution Multiplier changes the in game resolution and can go higher because the mod is not GPU intensive. Anti-Aliasing should be `Nvidia FXAA`, or `None` if you are at 2x resolution multiplier or higher. An optional recording mode above the multiplier renders pixels outside the headset field of view to fit a 16:9 aspect ratio. FPS++ should have its FPS limit at 120 or 144 at minimum, with the note that the headset and runtime still control the actual framerate. Under Enhancements, anisotropic filtering at 16x and optionally a Clarity preset to reduce washed out colours.

Step 7 is optional but worth doing: download the shader caches from the linked site to avoid heavy stutters on the first launch, since a first run compiles every shader on the CPU you have chosen not to upgrade.

Step 8 is launching: double click the game in Cemu's list with the headset on and connected. Settings are then reached in game, by holding the X button or equivalent on the left controller, or long pressing Menu on an Xbox controller, and there is an option to start the game automatically from the launcher.

The bug list is short and one of the fixes is struck through

The Current Limitations and Known Issues section has four entries, and one of them carries a strikethrough, which is more information than a plain list would give you.

There is a small chance the screen stays black after exiting any menus, which requires restarting the game to continue. That is the worst of the four because it is a hard stop with no in-game recovery.

Climbing ladders requires jumping up the ladder to go up, and you have to look at the ladder. You can get stuck behind ladders sometimes, especially when you stop moving at the very top while climbing down, so the instruction is to keep moving at the start.

The fourth entry is the one with the struck-through text. It says the mod will lack some comfort options for now, like a left handed mode, and then ~~or snap turning~~ with (added) after it. So snap turning was added, and left handed mode was not, or at least not at the time of writing.

That single formatting artifact tells you the list was maintained rather than abandoned, and it also tells you left handed mode is the open item if you are left handed and reading this before installing.

A second known issue worth noting comes from the launcher guidance rather than this list. Meta and Oculus Link is described as having terrible frame interpolation that makes the game appear to run much worse while also making grass and arms glitchy, even over a cable. The README recommends ALVR (free, wired or wireless), Virtual Desktop (paid, wireless, described as most performant) or Steam Link (free, wireless) for Meta Quest headsets instead.

Building from source and the troubleshooting path when it fails

The repository is laid out as a C project with CMake, so building is a normal CMake workflow rather than a script. There is a `build_mod.bat` for Windows, a `cmake/` directory, `include/` for headers, `src/` for sources, `dependencies/` for third party code, `resources/` for assets, `tools/` for tooling, and `vcpkg.json` describing the C++ dependency set. A `.clang-format` file and a `MetaXRSimulator/` directory suggest the OpenXR call surface is abstracted enough to be exercised without a headset attached.

The README does not document build steps, so treat the CMake files as the specification rather than expecting a documented one command build.

The troubleshooting section is more useful than most, because each step eliminates a category rather than a symptom. Verify you have a working game copy by launching it in `Cemu.exe` normally, since if it loads there it should work. If you are on a laptop, update both the integrated and the dedicated graphics drivers, plug into a wall outlet, and make sure it is not on a power saving setting.

Then the hardware caveats. Some older AMD GPUs might have issues. Uninstall any Vulkan overlays or layers, with Overwolf and RTSS named as programs that can cause problems, though not guaranteed to.

Then the two diagnostic signals. A green screen means the Vulkan layer is not enabled, which is likely due to using OpenGL in Cemu's settings. A Vulkan error like -13 is likely GPU driver related.

The pattern across all of it is that the emulator's graphics configuration is the usual culprit, and the mod itself is comparatively well behaved.

Editorial conclusion

Adopt BetterVR if you own a legal Wii U copy of Breath of the Wild, run Windows, and can get Cemu to hold 60 FPS on a CPU strong in single threaded work, because those three gates decide everything else. Do not attempt it on Linux, since the README states it does not work there even under Wine or Proton, and make sure the CPU is not your bottleneck. Verify first that your game is already at update V208 and that Cemu reports version 2.6 or newer, and download the shader caches from the linked site before your first session to avoid the stutter the README describes.

Frequently asked questions

Official sources

1. Crementif/BotW-BetterVR on GitHub
2. Issues
3. License: MIT
4. README
5. Releases