https://github.com/itsloopyo/assassins-creed-unity-headtracking
An OpenTrack compatible head tracking mod for Assassins Creed Unity
https://github.com/itsloopyo/assassins-creed-unity-headtracking
Last synced: 29 days ago
JSON representation
An OpenTrack compatible head tracking mod for Assassins Creed Unity
- Host: GitHub
- URL: https://github.com/itsloopyo/assassins-creed-unity-headtracking
- Owner: itsloopyo
- License: mit
- Created: 2026-04-27T13:26:09.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-27T22:40:24.000Z (about 1 month ago)
- Last Synced: 2026-05-28T00:26:44.521Z (about 1 month ago)
- Language: C++
- Size: 2.6 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
# Assassin's Creed Unity Head Tracking
Head tracking for Assassin's Creed Unity. Turning your head nudges the camera on top of the normal third-person orbit, so you can peek around corners and lean into rooftop drops without taking your hands off the mouse or controller. No VR headset required.
## Features
- **Head-driven camera nudge** - layered on top of the normal third-person orbit; mouse and controller still drive aim and Arno's facing.
- **6DOF positional tracking** - lean and peek with head position, tuned to ACU's tight follow camera.
## Requirements
- A legitimate copy of [Assassin's Creed Unity on Steam](https://store.steampowered.com/app/289650/Assassins_Creed_Unity/) (or Ubisoft Connect).
- A head-tracking source that outputs OpenTrack UDP, such as [OpenTrack](https://github.com/opentrack/opentrack) with a webcam, a VR headset, or a phone app.
- Windows 10 or 11, 64-bit.
## Installation
1. Download the latest installer ZIP from the [Releases page](https://github.com/itsloopyo/assassins-creed-unity-headtracking/releases).
2. Extract it anywhere.
3. Double-click `install.cmd`.
4. Configure OpenTrack (or your tracker) to send UDP output to `127.0.0.1:4242`.
5. Launch the game normally via Steam or Ubisoft Connect.
If the installer cannot find your game, point it at the install folder explicitly with either an environment variable or a positional argument:
```powershell
set ASSASSINS_CREED_UNITY_PATH=D:\Games\Assassin's Creed Unity
install.cmd
```
or
```powershell
install.cmd "D:\Games\Assassin's Creed Unity"
```
### Manual Installation
For users who prefer to place files by hand, extract the Nexus ZIP into the folder containing `ACU.exe`:
1. Install the [Ultimate ASI Loader](https://github.com/ThirteenAG/Ultimate-ASI-Loader) yourself, kept as `dinput8.dll` next to `ACU.exe`.
2. Copy `AssassinsCreedUnityHeadTracking.asi` into the same folder.
3. `HeadTracking.ini` is written next to `ACU.exe` on first launch.
## Setting Up OpenTrack
Whatever your tracking source, the output configuration is the same:
- **Output**: `UDP over network`
- **IP**: `127.0.0.1`
- **Port**: `4242`
### VR Headset Setup
1. Connect your headset to the PC over Air Link or Virtual Desktop.
2. Start SteamVR.
3. In OpenTrack, set the input to `SteamVR` (the OpenTrack SteamVR input plugin), and the output to UDP `127.0.0.1:4242` as above.
### Webcam Setup
1. In OpenTrack, set the input to the `neuralnet` tracker.
2. Position your webcam so your face is well lit and centered.
3. Set the output to UDP `127.0.0.1:4242`.
### Phone App Setup
If your phone app smooths its own output and can send OpenTrack UDP directly, point it at your PC's IP on port `4242` and skip OpenTrack entirely. If you want OpenTrack's curve mapping and filtering, have the app feed OpenTrack instead and let OpenTrack relay UDP to `127.0.0.1:4242`.
## 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` |
`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
`Page Down` / `Ctrl+Shift+H` toggles yaw between **world-space** (horizon-locked, default) and **camera-local**.
## Configuration
The mod writes `HeadTracking.ini` next to `ACU.exe` on first launch. All settings are annotated in-line; the defaults are below.
```ini
[Network]
; UDP port for OpenTrack data
UDPPort=4242
[Sensitivity]
YawMultiplier=1.0
PitchMultiplier=1.0
; Roll reduced for third-person. ACU is a parkour game and unchecked
; roll whips the horizon on rooftop landings. Raise to 1.0 for more tilt.
RollMultiplier=0.5
; 0.0 = minimum (a 0.15 floor is applied internally to kill jitter).
; 1.0 = heavy smoothing (~5s settling).
Smoothing=0.0
[Position]
SensitivityX=1.0
SensitivityY=1.0
SensitivityZ=1.0
; Positional limits in meters, kept conservative for ACU's tight follow camera.
LimitX=0.20
LimitY=0.15
LimitZ=0.25
LimitZBack=0.05
Smoothing=0.15
InvertX=false
InvertY=false
InvertZ=false
Enabled=true
[Hotkeys]
; Virtual key codes in hex. Nav-cluster defaults:
ToggleKey=0x23 ; End
RecenterKey=0x24 ; Home
PositionToggleKey=0x21; Page Up
YawModeKey=0x22 ; Page Down
; Chord alternatives (Ctrl+Shift+):
ChordToggleKey=0x59 ; Y
ChordRecenterKey=0x54 ; T
ChordPositionKey=0x47 ; G
ChordYawModeKey=0x48 ; H
[General]
AutoEnable=true
; Horizon-locked yaw (true) is best for third-person games.
WorldSpaceYaw=true
CameraHookLogging=false
[Culling]
; Widens actor visibility culling so head turns do not reveal empty crowd edges.
; This does not change the rendered FOV. Ctrl+Shift+J toggles it in-game.
GuardEnabled=true
; Side-plane outward bias in metres.
GuardBiasMeters=500.0
```
## Troubleshooting
- **Mod not loading** - confirm `dinput8.dll` and `AssassinsCreedUnityHeadTracking.asi` sit next to `ACU.exe`. A `HeadTracking.log` file appearing next to them is a good sign; include it if you file an issue. If the game crashes on launch, removing those two files restores vanilla behavior.
- **No tracking response** - check that your tracker is outputting UDP to `127.0.0.1:4242` and that the port matches `UDPPort` in `HeadTracking.ini`.
- **Jittery or unstable tracking** - raise `[Sensitivity] Smoothing` toward `0.3`. A 0.15 floor is always applied, which is usually enough for wired trackers; wireless or WiFi trackers may want more.
- **Wrong rotation / horizon whipping** - lower `[Sensitivity] RollMultiplier`, or set `[General] WorldSpaceYaw=true` for horizon-locked yaw. Use the invert options in `[Position]` if an axis moves the wrong way.
- **NPCs disappear while turning your head** - keep `[Culling] GuardEnabled=true`. Raise `GuardBiasMeters` if crowd edges still pop; lower it if you need to test performance impact.
## Updating
Download the new release and run `install.cmd` again. Your config is preserved.
## Uninstalling
Run `uninstall.cmd`. This removes the mod DLLs. The Ultimate ASI Loader is only removed if the installer put it there. Use `uninstall.cmd /force` to remove it anyway.
## Building from Source
Prerequisites: Visual Studio 2022 with the C++ workload, CMake 3.20+, git, and [pixi](https://pixi.sh).
```powershell
git clone --recurse-submodules https://github.com/itsloopyo/assassins-creed-unity-headtracking
cd assassins-creed-unity-headtracking
pixi run build-release
pixi run package
```
## License
MIT - see [LICENSE](LICENSE). Copyright (c) 2026 itsloopyo.
## Credits
- **Ubisoft Montreal / Ubisoft** - Assassin's Creed Unity and the AnvilNext engine.
- **ThirteenAG** - [Ultimate ASI Loader](https://github.com/ThirteenAG/Ultimate-ASI-Loader).
- **TsudaKageyu** - [MinHook](https://github.com/TsudaKageyu/minhook).
- **Stanisław Halik et al.** - [OpenTrack](https://github.com/opentrack/opentrack).
- Built on the shared [cameraunlock-core](https://github.com/itsloopyo/cameraunlock-core) library.
## Disclaimer
This mod is not affiliated with, endorsed by, or supported by Ubisoft. It modifies only what you see on your own machine; aim, hitboxes, and game logic are unchanged. Tracking is client-side, but keep it off in co-op out of courtesy. Use at your own risk.