REFramework RE2 is an advanced open-source modding platform designed for Resident Evil 2 Remake (RE2) and other Capcom titles built on the RE Engine. Created by developer praydog, it revolutionizes how PC players experience and customize the game — from technical modding and real-time scripting to complete Virtual Reality integration.
Unlike traditional mods, REFramework is not a mod itself but a development framework that serves as the foundation for nearly all modern RE Engine mods. It allows users and developers to interact directly with the game’s live systems, unlocking the potential to modify, enhance, and expand gameplay in unprecedented ways.
⚙️ How REFramework RE2 Works
REFramework operates through DLL injection, replacing the standard dinput8.dll during game startup. This technique allows the framework to hook directly into the game’s process, granting it access to the RE Engine’s core systems — including rendering, scripting, and input.
Once loaded, REFramework exposes an extensive API accessible through Lua scripting and C++ plugin development, empowering modders to build dynamic features, optimize performance, and create innovative gameplay experiences without reverse engineering the game after every update.
🧩 Core Features
🧠 1. Lua Scripting Environment
The built-in Lua scripting engine enables users to run, edit, and reload scripts in real-time.
Modders can:
- Create gameplay mechanics or debug tools.
- Customize camera, physics, and input behavior.
- Automate functions or inject new logic seamlessly.
Scripts placed in the reframework/autorun folder load automatically every time the game launches.
🧰 2. Developer Tools and Debugging
Press Insert in-game to open the REFramework menu and access powerful developer tools:
- Object Explorer: Inspect engine objects, singletons, and fields.
- Script Runner: Load, test, or debug Lua scripts on the fly.
- Free Camera Mode: Explore scenes freely or capture cinematic screenshots.
- Native Function Calls: Access internal RE Engine functions directly.
This combination makes REFramework invaluable for mod creation, debugging, and learning RE Engine’s internal workings.
🎮 3. Built-In Trainer and Gameplay Controls
REFramework includes a robust trainer system that offers instant access to advanced gameplay modifications:
- Infinite health, ammo, or stamina.
- Character model swapping.
- Teleportation and time control.
- Real-time player speed and gravity adjustments.
These tools give creators and casual players alike unparalleled flexibility.
🕶️ 4. Virtual Reality and First-Person Integration
REFramework’s most iconic feature is its VR and first-person gameplay transformation.
By dynamically re-routing the in-game camera, the framework attaches a virtual headset view to the player’s perspective. It supports:
- True stereoscopic rendering for 3D immersion.
- Full VR motion control input mapping.
- Head-tracking camera alignment for lifelike realism.
The result is a seamless VR experience that turns Resident Evil 2 into a spine-chilling, fully explorable first-person survival horror masterpiece.
🎨 Graphics & Performance Enhancements
Through its plugin system, REFramework extends beyond gameplay modification to enable next-generation visual upgrades:
- Upscaler Integration: Inject modern technologies like DLSS, FSR, or XeSS for better frame rates.
- Ray Tracing Optimization: Fine-tune lighting and reflections for improved stability.
- Shader and Post-Processing Controls: Customize visuals for a personalized aesthetic.
These community-driven plugins allow users to achieve both high performance and stunning visuals, even on demanding hardware.
⚙️ Installation Guide
Installing REFramework for RE2 is simple and quick.
- Download REFramework from the official download page.
- Extract all files into your Resident Evil 2 game directory (where
re2.exeis located). - Launch the game — the REFramework overlay will appear automatically.
- Press Insert to access scripting tools, developer utilities, and plugins.
💡 Tip: Always use the build that matches your version of RE2 (Ray Tracing or non-Ray Tracing).
⚠️ Compatibility and Troubleshooting
- REFramework works with official PC versions of the game only.
- If your game crashes, check the
re2_framework_log.txtfile in your game directory. - Some overlays (like ReShade) or antivirus software may conflict with REFramework. If issues occur, whitelist the DLL or temporarily disable conflicting tools.
- Frequent game updates may require downloading the latest REFramework version for compatibility.
📚 Documentation and Developer Resources
For scripting, plugin development, and API reference, visit the official REFramework Documentation.
It includes:
- Detailed Lua API examples.
- Plugin development guides (C++).
- Troubleshooting and debugging resources.
- Advanced VR configuration tutorials.
💡 Final Thoughts
REFramework RE2 represents the pinnacle of RE Engine modding technology, a bridge between Capcom’s closed systems and limitless creative freedom. Whether you’re a modder, developer, or passionate player, REFramework gives you complete control to transform Resident Evil 2 into an entirely new experience.
Get started now by downloading the latest version from the official REFramework download page and unlock the full potential of the RE Engine.