Skip to content

REFramework

Jump to bottom
OneUp edited this page Nov 18, 2024 · 11 revisions

REFramework is a VR mod for Capcom's RE Engine

  • The main GitHub is here but there are newer versions available as nightlies and on the pd_upscaler branch
  • Support praydog's efforts on Patreon
  • Some Game-Specific Settings and profiles are available
  • 3DVision is compatible with older RE Engine games, but the drivers are too old for newer ones (Dragon's Dogma 2 and newer)
  • You may get improved performance with GPU Scheduling OFF - you can change it here

Quick Reference

  • REFramework menu can be toggled using INSERT
  • The menu is navigable by Mouse, but sometimes you can't properly click on it
  • The menu looks like this:
  • Screenshot 2024-10-19 234658
  • Screenshot 2024-10-19 234714
  • The main settings you may want to modify are 2D UI Scale, 2D UI Distance, World-Space UI Scale
  • If you can't properly modify settings in-game, you can edit the generated re2_fw_config.txt config file when the game isn't running
  • In general, you want to set the game to run in windowed mode for single and multi display VRto3D configurations
  • OpenXR seems to be a bit more stable, but OpenVR should also work
  • The pd_upscaler branch has a newer renderer that fixes TAA and some other effects better, but it's still WIP and isn't fully compatible with all games. You need a GitHub account to access downloads for it

Game Specific Configurations

Game 3DVision Compatible
Dragon's Dogma 2 No
Kunitsu-Gami No
Monster Hunter Rise Yes
Resident Evil 4 Yes
Resident Evil VIllage Yes

Dragon's Dogma 2 and Kunitsu-Gami

  • no VRto3D profile created for either yet - create one and share it!
  • REFramework support is WIP but the games are relatively playable in their current states
  • Both use the DD2.zip
  • Can try either the REFramework nightly or the pd_upscaler branch
  • May need to try these settings in re2_fw_config.txt
    • VR_AllowEngineOverlays= false
    • VR_AlternateFrameRendering=true
    • VR_AsyncRendering_V2=false

Monster Hunter Rise

  • Features
    • Dynamic UI depth
    • Multiplayer compatible
  • Remaining issues:
    • Ambient Occlusion is broken - disable it for now, hopefully fixed in future
    • Some UI elements don't render correctly (weapon thumbnails in blacksmith menu, zoomed map when holding L1)
    • Zoom in/out doesn't work for the in-game camera tool for taking pictures of things

VRto3D Settings for MHRise

  • Close SteamVR if it is running
  • Extract the latest profiles into your Documents\My Games\vrto3d\ folder
  • This game's profile sets:
    • A lower depth preset toggle for menus/NPCs when you press the guide button
    • Depth reset on Numpad 1

REFramework Installation for MHRise

  • Download and extract this zip to your MonsterHunterRise folder (you should be placing several .dll and .txt files and the reframework folder next to MonsterHunterRise.exe)
  • Optionally, additional MHRise mods that are compatible with REFramework can be added if desired - SpiritBirds and Remove Monster Kill-Cam Plus Stylish SlowMo Finishers work
  • Run the game and REFramework should initialize and load up SteamVR
  • Change in-game settings:
    • Display:
      • Output Display Settings to your second display if you are using a multi-display setup
      • Screen Mode to Windowed Mode
      • Resolution Settings to your render resolution
      • Display Frequency to 59.95Hz or whatever frequency per-eye your display can do
      • Nvidia DLSS to Off
    • Display - Advanced Graphics Settings:
      • Ambient Occlusion to Off
      • Anti-Aliasing can use TAA + FXAA
      • Motion Blur Lens Distortion Depth of Field Film Grain and Filters to Off
    • After loading a character: Game Settings - HUD Settings - Open Settings Menu and adjust as desired. Recommendations:
    • Screenshot 2024-10-20 001141
  • Close out of the game and SteamVR
  • Start MHRise again and SteamVR should load up
  • For single-display setups, enable VRto3D foregrounding with Ctrl + F8 and Alt + Tab to the 2D game window for controls
  • For multi-display setups, ensure that the 3D Headset Window is fullscreen by clicking on it and then click on the 2D game window for controls

Resident Evil 4 REmake

  • Full game and chainsaw demo both work
  • Features
    • Dynamic crosshair depth
    • Dynamic UI depth
    • Different depth/convergence setting while aiming
  • Remaining issues:
    • There's two versions of REFramework to choose between, each with pros/cons
    • Nightly Version:
      • TAA is broken, but it's disabled by the mod
      • Shimmering foliage, but can be reduced by increasing resolution or in-game Image Quality setting
      • Some UI renders differently in each eye
    • pd-upscaler Version:
      • TAA is fixed, which also fixes shimmering foliage
      • UI is good
      • Some foliage only renders in one eye
      • 2D Game Window won't render anything, but you don't need this for 3D gameplay

VRto3D Settings for RE4

  • Close SteamVR if it is running
  • Extract the latest profiles into your Documents\My Games\vrto3d\ folder
  • This game's profile sets:
    • A higher depth preset toggle when you press the guide button or Numpad 2
    • A lower depth preset when you hold Left Trigger or Right Mouse Button
    • Depth reset on Numpad 1

REFramework Installation for RE4

  • Nightly Version
    • Go to the latest nightly
    • Download the latest RE4.zip and extract it to your RESIDENT EVIL 4 BIOHAZARD RE4 folder (you should be placing several .dll files and the reframework folder next to re4.exe)
  • pd-upscaler Version
    • Create a GitHub account if you don't have one and login
    • Go to the pd_upscaler branch and click the newest/topmost workflow run link that has a Green Checkmark
    • Download the latest RE4.zip and extract it twice to your RESIDENT EVIL 4 BIOHAZARD RE4 folder (you should be placing several .dll files and the reframework folder next to re4.exe)
  • Delete openvr_api.dll from your RESIDENT EVIL 4 BIOHAZARD RE4 folder
  • Download and extract this zip to your RESIDENT EVIL 4 BIOHAZARD RE4 folder
  • Run the game and REFramework should initialize and load up SteamVR
  • Change in-game settings:
    • Graphics:
      • Screen Resolution to your render resolution
      • Refresh Rate to 59.95Hz or whatever frequency per-eye your display can do
      • Display Mode to Windowed Mode
      • Ray Tracing to Off
      • FidelityFX Super Resolution to Off
      • Rendering Mode to Normal
      • Contact Shadows to Off
      • Lens Distortion to Off
      • Depth of Field to Off
  • Close out of the game and SteamVR
  • Start RE4 again and SteamVR should load up
  • For single-display setups, enable VRto3D foregrounding with Ctrl + F8 and Alt + Tab to the 2D game window for controls. Mouse control is not possible
  • For multi-display setups, ensure that the 3D Headset Window is fullscreen by clicking on it and then click on the 2D game window for controls. Mouse control is supported

Resident Evil 8 Village

  • Features
    • Dynamic crosshair depth in first person mode
    • Dynamic UI depth
    • Different depth/convergence setting while aiming
  • Remaining issues:
    • If using mouse for controls in multi-display mode, the cursor can escape the game window when navigating menus in-game

VRto3D Settings for RE8

  • Close SteamVR if it is running
  • Extract the latest profiles into your Documents\My Games\vrto3d\ folder
  • This game's profile sets:
    • A higher depth preset toggle when you press the guide button or Numpad 2
    • A lower depth preset when you hold Left Trigger or Right Mouse Button
    • Depth reset on Numpad 1

REFramework Installation for RE8

  • Download and extract this zip to your Resident Evil Village BIOHAZARD VILLAGE folder
  • Choose between running the game in 1st person or 3rd person
    • For 3rd person, copy the reframework folder from the 3rdPerson folder to your Resident Evil Village BIOHAZARD VILLAGE folder and overwrite. Also copy the re8.exe_config.json to Documents\My Games\vrto3d\ and overwrite
  • Run the game and REFramework should initialize and load up SteamVR
  • Change in-game settings:
    • Camera:
      • View Mode to 1st or 3rd person
    • Graphics:
      • Display Mode to Window
      • Screen Resolution to your render resolution
      • Refresh Rate to 59.95Hz or whatever frequency per-eye your display can do
      • Frame Rate to match Refresh Rate
      • FidelityFX Super Resolution to Off
      • Rendering Mode to Normal
      • Anti-aliasing to FXAA+TAA
      • Ray Tracing to Off
      • Film Noise to Off
      • Depth of Field to Off
      • Lens Distortion to Off
  • Close out of the game and SteamVR
  • Start RE8 again and SteamVR should load up
  • For single-display setups, enable VRto3D foregrounding with Ctrl + F8 and Alt + Tab to the 2D game window for controls. Mouse control is not possible
  • For multi-display setups, ensure that the 3D Headset Window is fullscreen by clicking on it and then click on the 2D game window for controls. Mouse control is supported
Clone this wiki locally