Skip to content

REFramework

OneUp edited this page Nov 5, 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)

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

  • 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 MHRISE.zip and extract it twice to your MonsterHunterRise folder (you should be placing several .dll files and the reframework folder next to MonsterHunterRise.exe)
  • Delete openvr_api.dll from your MonsterHunterRise folder
  • Download and extract this zip to your MonsterHunterRise folder
  • 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
Clone this wiki locally