REFramework is a powerful modding framework for games built on Capcom’s RE Engine, including Resident Evil titles, Monster Hunter Rise (MHRise), Monster Hunter Wilds (MH Wilds), and Dragon’s Dogma 2 (DD2). It functions as a mod loader, script execution environment, and in-game configuration tool, allowing you to tweak settings, run Lua scripts, and use developer utilities.
While many settings can be adjusted in the in-game REFramework menu, ensuring these changes persist between sessions requires attention to saving methods, configuration file locations, and potential system restrictions. This guide covers everything you need to know.
For additional tutorials and updates, visit the REFramework Blog.
1. Saving Settings via the REFramework Menu
Most core settings and integrated mods save automatically through the in-game overlay — but the method of closing the menu is crucial for persistence.
Step 1: Open the REFramework Menu
- Launch your game with REFramework installed.
- Press the default menu hotkey (usually
InsertorHome) to open the overlay.
Step 2: Adjust Settings
- Navigate through the tabs to configure REFramework options (menu keybinds, display options, built-in tools) or any installed Lua scripts/plugins.
Step 3: Save Settings Correctly
- Important: Close the menu by pressing the same hotkey you used to open it, rather than clicking the window’s ‘X’.
- This triggers REFramework’s autosave mechanism for the main configuration file, ensuring changes are written permanently.
2. Configuration File: Location and Manual Edits
If settings don’t save via the UI or you need to rebind the menu key without opening the overlay, you can manually edit the configuration file.
A. Locate the File
- File Name:
re2_fw_config.txt(orre7_fw_config.txt,dd2_fw_config.txt, depending on the game). - Location: The game’s root directory, where
dinput8.dllwas installed:...\Steam\steamapps\common\[GameName]\ - Quick access: Open Steam → Right-click your game → Manage → Browse local files.
B. Edit the Menu Key
- Open the configuration file with Notepad.
- Find the line:
REFrameworkConfig_MenuKey_V2=45 - Change
45(Insert key) to the desired Windows Virtual Key Code. - Save the file and relaunch the game.
3. Persistent Settings for Lua Scripts and Plugins
Individual mods and Lua scripts store their configuration separately from the main REFramework config.
A. Lua Script Settings
- Location:
...\Steam\steamapps\common\[GameName]\reframework\autorun\ - Action: Adjust the settings in the script UI and close the REFramework menu with the hotkey to save automatically.
B. VR Mod Settings
- Location:
...\Steam\steamapps\common\[GameName]\reframework\plugins\[VR-Mod-Folder]\ - Method: Configure VR options (camera, scale, rendering) via the REFramework menu and close using the hotkey. Changes are written to the VR mod config file (e.g.,
openvr_mod.cfg).
4. Troubleshooting: Settings Not Saving
If settings reset after following the steps above, it’s usually a file permissions issue.
| Issue | Solution | Applicable Games |
|---|---|---|
| Config file is read-only | Locate the file → Right-click → Properties → Uncheck Read-only → Apply | MHRise, MH Wilds, DD2, RE Games |
| Permissions issue | Run your game or Steam as Administrator | All PC games |
| Antivirus or Windows Defender blocking writes | Add the game folder to exclusions | All PC games |
| Cloud sync interference | Temporarily disable Google Drive/OneDrive sync or move game folder to an unsynced location | All PC games |
✅ Summary Checklist for Persistent Settings
- Configure Settings: Make all desired changes in the in-game REFramework UI.
- Save Action: Close the menu using the hotkey, not the window’s ‘X’.
- Exit Game: Quit normally via the main menu.
- Verify: Relaunch the game and confirm that all changes persisted.
For more detailed guidance, troubleshooting, and updates, visit REFramework Blog or check out the official GitHub repository.