Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

praydog/REFramework

Games

Mod loader and Lua scripting platform that adds VR, free camera, and gameplay fixes to RE Engine games.

5,743
683
C++
MIT
7 years old

What it does

REFramework is a mod framework, scripting platform, and VR layer for games built on Capcom's RE Engine. It injects a dinput8.dll into the game process and exposes built-in mods plus a Lua scripting API and plugin system, so mod authors can write scripts and tooling against game internals rather than patching binaries by hand.

Built-in mods cover VR with generic 6DOF support, motion controls for RE2/RE3/RE7/RE8, first-person view for RE2/RE3, manual flashlight, free camera, scene timescale, FOV slider, vignette disabling, ultrawide/aspect-ratio fixes, and GUI hiding. Developer mode adds a game objects display and object explorer. The project also ships fixes such as the RE8 startup crash, RE8 stutters, and crashes tied to third-party DLLs in MHRise/RE8.

The supported game list spans Resident Evil 2/3/4/7/Village/Requiem, Devil May Cry 5, Street Fighter 6, Monster Hunter Rise/Wilds/Stories 3, Dragon's Dogma 2, Dead Rising Deluxe Remaster, and several other RE Engine titles. It is aimed at players who want these features in single-player games and at mod developers writing Lua scripts.

Quick start

  1. Pick a build: the last stable release is on the Releases page, and newer builds come from the nightly developer releases.
  2. For non-VR use, extract only dinput8.dll from the zip into the game folder.
  3. For VR, install SteamVR (or use OpenXR on a supported headset), then extract the whole zip into the game folder. See the VR troubleshooting/FAQ page if something fails.
  4. On Proton/Linux, after extraction, add this launch option to the game in Steam properties:
WINEDLLOVERRIDES="dinput8.dll=n,b" %command%

DirectX 11 and DirectX 12 are both supported. A typical game folder looks like G:\SteamLibrary\steamapps\common\RESIDENT EVIL 2 BIOHAZARD RE2.

Script authors should start from the scripting documentation site referenced from the README.

Constraints

  • The DLL is loaded into the game process, so it only suits games where external DLL injection is acceptable; this is generally single-player modding, not something to assume works in competitive online play.
  • VR requires SteamVR or a supported OpenXR setup, and the full archive rather than just the DLL.
  • Linux users depend on Proton/Wine and the DLL override above; native Linux builds are not described.
  • Coverage and features differ per game: motion controls are listed only for RE2/RE3/RE7/RE8, and first-person only for RE2/RE3.
  • No game assets are distributed; scripts and plugins are written against the exposed API. Licensed under MIT.

HotRepo's take

On the CPP daily list for 2026-11-09, REFramework ranked 11th with 6 stars gained that day, at 5,738 stars and 683 forks overall. The project has been public since January 2019 and has accumulated a large modding user base over that time. For a mod loader tied to specific commercial games, its news here is steady rather than explosive; usefulness depends more on which supported title you own than on the star count.

Project source and documentation

Written by AI from the project's README, updated . The project's own docs are the source of truth.

You might also like

  1. UE4SS-RE/RE-UE4SSLua and C++ modding toolkit for Unreal Engine 4/5 games, with SDK generation and runtime property inspection.C++3,106