REFramework Troubleshooting

REFramework: Complete Troubleshooting & Fix Guide

REFramework is a versatile, open-source modding tool for Capcom’s RE Engine games, including Resident Evil, Monster Hunter Rise, Devil May Cry 5, and Dragon’s Dogma 2. While it enhances gameplay and VR support, updates from developers—especially changes to core files or anti-tamper measures—can disrupt REFramework, often causing crashes on startup.

This guide provides step-by-step solutions to common issues and ensures smooth operation.

🔄 1. Core Installation & Startup Issues

🚫 Game Crashes or Won’t Launch

Problem: Immediate crash on startup.
Potential Cause: Outdated REFramework version, especially after a game update.
Solution:

  1. Download the latest REFramework version from the official REFramework website.

  2. Locate your game directory (e.g., C:\Program Files (x86)\Steam\steamapps\common\[Game Name]).

  3. Delete old REFramework files:

    • dinput8.dll (or other proxy DLLs)

    • dxgi.dll, dstorage.dll, or similar injector files not belonging to the latest REFramework

  4. Extract the new files into the game directory.

  5. Launch the game and verify REFramework loads.

If issues persist, verify game file integrity via your launcher (Steam, etc.).

🕹️ 2. REFramework Menu Access

❌ Menu Doesn’t Appear

Problem: REFramework menu does not open.
Potential Cause: Wrong keybind or VR detection issues.
Solution:

  • Desktop Mode: Press Insert to open the menu.

  • VR Mode: Aim your head and right hand at the palm of your left hand without pressing buttons.

If the menu is still inaccessible, check for software or overlay conflicts.

🎮 3. VR-Specific and Graphical Fixes

🌈 Visual Anomalies (Rainbow Colors, Black Bars)

Problem: Distorted visuals or black bars.
Potential Cause: HDR enabled or incompatible display mode.
Solution:

  • Disable HDR in Windows and in-game.

  • Use Windowed mode instead of Borderless.

  • Temporarily unplug HDR monitors if problems persist.

⚙️ Performance and Controls

Problem: Low FPS or motion control issues.
Potential Cause: Hardware conflicts or controller interference.
Solution:

  • Adjust SteamVR render resolution for better performance.

  • Disable Hardware-accelerated GPU Scheduling in Windows.

  • Disconnect all controllers to prevent VR motion conflicts.

  • Enable “Decoupled Camera Pitch” in REFramework VR settings to reduce motion sickness.

🧩 4. Advanced Mod & Upscaler Troubleshooting

Problem: Temporal Upscaler missing or malfunctioning.
Potential Cause: Using a base REFramework version without upscaler support.
Solution:

  • Download the Upscaler-specific REFramework build.

  • Ensure all upscaler DLLs (e.g., DLSS, XeSS) are in the correct folders (reframework/plugins).

  • Switch to DX11 if DX12 is causing conflicts with other injectors.

🛠️ 5. General Mod Conflicts and Maintenance

Problem: Persistent crashing, memory leaks, or Lua script issues.
Solution:

  • Remove or temporarily move custom Lua scripts from reframework/autorun.

  • Update REFramework to the latest version compatible with your game.

  • Restart your PC to clear residual memory issues.

📝 6. Reporting & Diagnostic Tools

📂 Locate Log Files

  • re2_framework_log.txt – main log

  • reframework_crash.dmp – crash dump (only if a crash occurred)

🐞 Submit a Bug Report

Use the REFramework official website or forum pages to report issues. Include:

  • Detailed issue description

  • System specs (OS, GPU, CPU)

  • Relevant log files

📥 7. Official Resources

For downloads, guides, and documentation: