https://github.com/itsloopyo/resident-evil-3-headtracking
An OpenTrack compatible head tracking mod for Resident Evil 3 Remake
https://github.com/itsloopyo/resident-evil-3-headtracking
Last synced: 13 days ago
JSON representation
An OpenTrack compatible head tracking mod for Resident Evil 3 Remake
- Host: GitHub
- URL: https://github.com/itsloopyo/resident-evil-3-headtracking
- Owner: itsloopyo
- License: mit
- Created: 2026-05-31T22:08:38.000Z (28 days ago)
- Default Branch: main
- Last Pushed: 2026-06-07T20:05:44.000Z (21 days ago)
- Last Synced: 2026-06-07T20:10:07.079Z (21 days ago)
- Language: C++
- Size: 25 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
> [!CAUTION]
> ## Experimental prototype - expect missing core features
>
> This is **not** a finished mod.
>
> Current builds may only test whether head tracking can drive the camera. Bug fixes and core features like decoupled look/aim, independent reticle behavior, correct shot direction, off-screen reticle support, movement handling, and comfort tuning may be missing at this early stage of development.
# Resident Evil 3 Head Tracking
Head tracking for Resident Evil 3 Remake that decouples looking from aiming, so your head moves the camera view through OpenTrack while the mouse or controller still aims independently, with no VR headset required.
## Features
- **Decoupled look and aim** - head tracking moves the camera; aim stays on your mouse/controller
- **6DOF positional tracking** - lean and peek with head position
## Requirements
- [Resident Evil 3 Remake](https://store.steampowered.com/app/952060/Resident_Evil_3/) (Steam)
- [OpenTrack](https://github.com/opentrack/opentrack) or a compatible head tracking app (smartphone, webcam, or dedicated hardware)
- Windows 10/11 (64-bit)
## Installation
1. Download the latest release from the [Releases page](https://github.com/itsloopyo/resident-evil-3-headtracking/releases)
2. Extract the ZIP anywhere
3. Double-click `install.cmd`
4. The installer auto-detects your game and installs REFramework if needed
5. Configure OpenTrack to output UDP to `127.0.0.1:4242`
6. Launch the game. Head tracking is enabled automatically.
The installer automatically finds your game via Steam registry lookup. If it can't find the game:
- Set the `RE3_PATH` environment variable to your game folder, or
- Run from command prompt: `install.cmd "D:\Games\RE3"`
### Manual Installation
1. Install [REFramework](https://github.com/praydog/REFramework-nightly/releases) for RE3 (extract to game root)
2. Copy `RE3HeadTracking.dll` and `HeadTracking.ini` to `/reframework/plugins/`
## Setting Up OpenTrack
1. Download and install [OpenTrack](https://github.com/opentrack/opentrack/releases)
2. Configure your tracker as input
3. Set output to **UDP over network**
4. Host: `127.0.0.1`, Port: `4242`
5. Start tracking before launching the game
### VR Headset Setup
A VR headset makes an excellent tracker for flat games.
1. Connect your headset to the PC via Air Link (Quest) or Virtual Desktop
2. Launch SteamVR
3. In OpenTrack, set the input to **SteamVR**
4. Set output to **UDP over network** (`127.0.0.1:4242`)
5. Start tracking before launching the game
### Webcam Setup
No special hardware needed. OpenTrack's built-in **neuralnet tracker** uses any webcam for 6DOF face tracking.
1. In OpenTrack, set the input to **neuralnet tracker**
2. Select your webcam in the tracker settings
3. Set output to **UDP over network** (`127.0.0.1:4242`)
4. Start tracking before launching the game
5. Recenter in OpenTrack via its hotkey, and press **Home** in-game to recenter the mod as needed
### Phone App Setup
This mod includes built-in smoothing for network jitter, so you can send directly from your phone on port 4242 without needing OpenTrack on PC.
1. Install an OpenTrack-compatible head tracking app
2. Configure it to send to your PC's IP on port 4242 (run `ipconfig` to find it)
3. Set the protocol to OpenTrack/UDP
**With OpenTrack (optional):** If you want curve mapping or visual preview, route through OpenTrack. Set OpenTrack's input to "UDP over network" on a different port (e.g. 5252), point your phone app at that port, and set OpenTrack's output to `127.0.0.1:4242`. Make sure your firewall allows incoming UDP on the input port.
## Controls
Two equivalent binding sets - use whichever your keyboard has:
| Action | Nav-cluster | Chord |
|---------------------|-------------|-----------------|
| Recenter | `Home` | `Ctrl+Shift+T` |
| Toggle tracking | `End` | `Ctrl+Shift+Y` |
| Cycle tracking mode | `Page Up` | `Ctrl+Shift+G` |
| Toggle yaw mode | `Page Down` | `Ctrl+Shift+H` |
| Toggle reticle | `Insert` | `Ctrl+Shift+U` |
`Page Up` / `Ctrl+Shift+G` cycles tracking mode:
1. Normal head-tracked gameplay
2. Positional tracking disabled, rotational tracking enabled
3. Rotational tracking disabled, positional tracking enabled
4. Back to normal
`Toggle yaw mode` switches between world-space (horizon-locked) and camera-local yaw.
## Configuration
The mod creates a config file at `reframework/plugins/HeadTracking.ini` on first run. Edit it to customize:
```ini
[Network]
UDPPort=4242 ; Must match OpenTrack output port
[Sensitivity]
YawMultiplier=1.0 ; Horizontal rotation (0.1-5.0)
PitchMultiplier=1.0 ; Vertical rotation (0.1-5.0)
RollMultiplier=1.0 ; Head tilt (0.0-2.0)
[Position]
SensitivityX=2.0 ; Lateral sensitivity (0.1-10.0)
SensitivityY=2.0 ; Vertical sensitivity (0.1-10.0)
SensitivityZ=2.0 ; Depth sensitivity (0.1-10.0)
LimitX=0.30 ; Max lateral offset in meters
LimitY=0.20 ; Max vertical offset in meters
LimitZ=0.40 ; Max forward offset in meters
LimitZBack=0.10 ; Max backward offset (prevents camera clipping)
Smoothing=0.15 ; Position smoothing (0.0-0.99)
InvertX=false ; Invert lateral axis
InvertY=false ; Invert vertical axis
InvertZ=false ; Invert depth axis
Enabled=true ; Enable/disable 6DOF position tracking
[Hotkeys]
; Virtual key codes (hex)
ToggleKey=0x23 ; End - Enable/disable
RecenterKey=0x24 ; Home - Recenter view
PositionToggleKey=0x21 ; Page Up - Cycle tracking mode
ReticleToggleKey=0x2D ; Insert - Toggle reticle
YawModeKey=0x22 ; Page Down - Toggle world/local yaw
[Reticle]
Enabled=true ; Show the head tracking reticle overlay
[General]
AutoEnable=true ; Auto-enable tracking on game start
WorldSpaceYaw=true ; true = horizon-locked yaw (default), false = camera-local
```
Delete the file to reset to defaults.
## Troubleshooting
**Mod not loading:**
- Ensure REFramework is installed (`dinput8.dll` in game root)
- Check `reframework/` folder exists with `plugins/RE3HeadTracking.dll` inside
- Try running the game as administrator once
**No tracking response:**
- Verify OpenTrack is running and outputting data
- Check UDP port matches (default 4242)
- Press **End** to enable tracking, **Home** to recenter
- Check firewall isn't blocking UDP port 4242
**Jitter:**
- Increase position smoothing in HeadTracking.ini
- If using a phone app over WiFi, some jitter is expected. The built-in interpolation helps.
**Wrong rotation axis:**
- Adjust sensitivity multipliers or use the Invert settings in the Position section
**Yaw feels wrong when looking up or down at extreme angles:**
- Try toggling between world-locked and camera-local yaw with `Page Down`. World-locked (default) is horizon-stable; camera-local follows the camera's current up-axis.
## Updating
Download the new release and run `install.cmd` again. Your config is preserved.
## Uninstalling
Run `uninstall.cmd` from the release folder. This removes the mod DLLs. REFramework is only removed if it was originally installed by this mod. To force-remove REFramework:
```
uninstall.cmd /force
```
## Building from Source
### Prerequisites
- [CMake](https://cmake.org/) 3.20+
- [Visual Studio 2022](https://visualstudio.microsoft.com/) with C++ desktop workload
- [pixi](https://pixi.sh) task runner
- Resident Evil 3 Remake installed (for deployment only)
### Build
```bash
git clone --recurse-submodules https://github.com/itsloopyo/resident-evil-3-headtracking.git
cd resident-evil-3-headtracking
# Build and deploy to game (release)
pixi run install
# Build only (debug)
pixi run build
# Package for release
pixi run package
```
## License
MIT License - see [LICENSE](LICENSE) for details.
## Credits
- [Capcom](https://www.capcom.com/) - Resident Evil 3 Remake
- [praydog](https://github.com/praydog/REFramework) - REFramework
- [OpenTrack](https://github.com/opentrack/opentrack) - Head tracking software
- [CameraUnlock](https://github.com/itsloopyo/cameraunlock-core) - Shared head tracking library
## Disclaimer
This mod is not affiliated with, endorsed by, or supported by Capcom. Use at your own risk.