Return of DesktopHeadTracking

This commit is contained in:
SDraw 2024-01-20 14:24:44 +03:00
parent c8743158ac
commit b05447c4df
No known key found for this signature in database
GPG key ID: BB95B4DAB2BB8BB5
24 changed files with 812 additions and 888 deletions

31
ml_dht/README.md Normal file
View file

@ -0,0 +1,31 @@
# Desktop Head Tracking
This mod adds desktop head tracking based on data from memory-mapped file `head/data`.
Refer to `TrackingData.cs` for reference in case of implementing own software.
[![](.github/img_01.png)](https://youtu.be/jgcFhSNi9DM)
# Features
* Head rotation
* Eyes gaze direction
* Basic mouth shapes: open, smile and pout
* Blinking
# Installation
* Install [latest MelonLoader](https://github.com/LavaGang/MelonLoader)
* Get [latest release DLL](../../../releases/latest):
* Put `ml_dht.dll` in `Mods` folder of game
# Usage
Available mod's settings in `Settings - Implementation - Desktop Head Tracking`:
* **Enabled:** enables mod's activity; default value - `false`.
* **Use head tracking:** enables head tracking; default value - `true`.
* **Use eyes tracking:** enables eyes tracking; default value - `true`.
* **Use face tracking:** enables mouth shapes tracking; default value - `true`.
* **Note:** You need to enable desktop tracking of `Vive Face tracking` in `Settings - Implementation` menu page.
* **Note:** Your avatar should have configured `CVR Face Tracking` component.
* **Use blinking:** uses blinking from data; default value - `true`.
* **Mirrored movement:** mirrors movement and gaze along 0YZ plane; default value - `false`.
* **Movement smoothing:** smoothing factor between new and old movement data; default value - `50`.
# Known compatible tracking software
* [VSeeFace](https://www.vseeface.icu) with [Tracking Data Parser mod](https://github.com/SDraw/ml_mods_vsf)