Retro gaming steering wheel emulation, separate desktop control, and improved adaptive triggers

r57zone · r57zone · commit c13d139e6fe0 · 2025-11-06T00:23:14.000+04:00
diff --git a/BINDINGS.RU.md b/BINDINGS.RU.md
@@ -33,6 +33,15 @@ RIGHT-STICK-DOWN  = NONE
 ...
 ```
 
+## Руль (движение геймпада наклонами)  
+При переключении режима на вождение наклоны геймпада по оси X используются для эмуляции нажатий кнопок влево и вправо на D-Pad.  
+
+Если наклон находится в пределах мёртвой зоны - руль считается в нулевом положении, и нажатия не эмулируются.  
+
+Параметр `SteeringWheelDeadZone` отвечает за мертвую зону руля, задается в процентах, от `0` до `100`.  
+
+Параметр `SteeringWheelReleaseThreshold` определяет, насколько сильно руль должен вернуться к центру, чтобы прекратилось удержание направления, задается в процентах, от `0` до `100`.
+
 ## Клавиатура и мышь
 Название клавиши | Значение
 ------------ | -------------
diff --git a/BINDINGS.md b/BINDINGS.md
@@ -33,6 +33,15 @@ To enable support for a second player, duplicate the `[FIRST-GAMEPAD]` section a
 ...
 ```
 
+## Steering Wheel (gamepad tilt movement)  
+When switching to driving mode, tilts of the gamepad along the X-axis are used to emulate presses of the D-Pad buttons: left and right.  
+
+If the tilt is within the dead zone, the wheel is considered centered, and no button presses are emulated.  
+
+Parameter `SteeringWheelDeadZone` defines the wheel's dead zone, specified in percent, from 0 to 100.  
+
+Parameter `SteeringWheelReleaseThreshold` determines how far the wheel must return to the center to stop holding the direction, specified in percent, from 0 to 100.
+
 ## Keyboard and mouse
 Key name | Value
 ------------ | -------------
diff --git a/KMProfiles/Knight Rider The Game (2002).ini b/KMProfiles/Knight Rider The Game (2002).ini
@@ -0,0 +1,46 @@
+[FIRST-GAMEPAD]
+LEFT-TRIGGER = DOWN
+RIGHT-TRIGGER = UP
+
+L1-LB = Z
+R1-RB = X
+
+BACK = ESCAPE
+START = ENTER
+
+DPAD-UP = UP
+DPAD-UP-LEFT=NONE
+DPAD-LEFT = LEFT
+DPAD-UP-RIGHT=NONE
+DPAD-RIGHT = RIGHT
+DPAD-DOWN = DOWN
+DPAD-DOWN-LEFT=NONE
+DPAD-DOWN-RIGHT=NONE
+
+TRIANGLE-Y = A
+SQUARE-X = D
+CROSS-A = SPACE
+CIRCLE-B = B
+
+LEFT-STICK = CUSTOM-BUTTONS
+LEFT-STICK-UP = NONE
+LEFT-STICK-LEFT = LEFT
+LEFT-STICK-RIGHT = RIGHT
+LEFT-STICK-DOWN = NONE
+LEFT-STICK-CLICK = S
+
+RIGHT-STICK = CUSTOM-BUTTONS
+RIGHT-STICK-UP = W
+RIGHT-STICK-LEFT = NONE
+RIGHT-STICK-RIGHT = NONE
+RIGHT-STICK-DOWN = Q
+RIGHT-STICK-CLICK = E
+
+[MOUSE]
+SensitivityX = 100
+SensitivityY = 100
+
+[MOTION]
+# Percent 0 - 100%
+SteeringWheelDeadZone=17
+SteeringWheelReleaseThreshold=3
diff --git a/KMProfiles/Need For Speed - Underground (2003).ini b/KMProfiles/Need For Speed - Underground (2003).ini
@@ -34,4 +34,10 @@ RIGHT-STICK-CLICK = MOUSE-LEFT
 
 [MOUSE]
 SensitivityX = 100
-SensitivityY = 100
+SensitivityY = 100
+
+[MOTION]
+# Percent 0 - 100%
+SteeringWheelDeadZone=17
+SteeringWheelReleaseThreshold=2
+
diff --git a/README.RU.md b/README.RU.md
@@ -13,7 +13,7 @@
 ✔️ Управление Windows, изменение громкости, создание скриншотов, с помощью геймпада;<br>
 ✔️ Переназначение кнопок Xbox контроллера, различные профили;<br>
 ✔️ Эмуляция клавиатуру и мыши для старых игр, а также профили;<br>
-✔️ Поддержка адаптивных триггеров для Sony DualSense в режиме USB подключения;<br>
+✔️ Поддержка адаптивных триггеров для Sony DualSense в режиме USB подключения (пистолет, автомат, винтовка, лук, педаль авто);<br>
 ✔️ Различные режимы эмуляции для игр с адаптивными курками;<br>
 ✔️ Показ заряда батареи на световой панели и индикаторах игрока (для геймпадов Sony);<br>
 ✔️ Выключение подсветки для полного погружения в темноте;<br>
@@ -35,13 +35,14 @@
 
 Дважды нажмите на область яркости, затем проведите по ней влево или вправо, чтобы изменить яркость подсветки. Повторное двойное нажатие заблокирует случайные изменения.
 
-Есть 3 режима эмуляции:
-* Простая эмуляция Xbox геймпада с расширенными функциями;
-* Эмуляция Xbox геймпада только для режима вождения и прицеливание мышью (для определенных игр с адаптивными триггерами);
-* Только мышь;
-* Эмуляция клавиатуры и мыши для управления Windows и некоторых старых игр;
+Есть 5 режимов эмуляции:
+* Эмуляция Xbox геймпада с расширенными функциями;
+* Эмуляция Xbox геймпада только для режима вождения и прицеливание мышью (для игр с адаптивными триггерами);
+* Только мышь (если хотите использовать родную поддержку геймпада, но с более точным прицеливанием);
+* Эмуляция клавиатуры и мыши для управления Windows;
+* Эмуляция клавиатуры и мыши для старых, ретро игр;
 
-Переключение режимов происходит на `ALT + Q` или `PS/Home + ←/→` и `Capture/Home`. Эмуляция клавиатуры и мыши поддерживает разные профили, выберите нужный профиль или [создайте новый профиль](https://github.com/r57zone/DSAdvance/blob/master/BINDINGS.RU.md). Также имеются Xbox профили, для изменения раскладки кнопок. Профили переключаются на клавиши `ALT + ↑/↓`, если окно активно или на геймпаде, с помощью `PS/Home + ↑/↓`. Профиль по умолчанию позволяет работать в Windows. 
+Переключение режимов происходит на `ALT + Q`, `ALT + ←/→` или `PS/Home + ←/→` и `Capture/Home`. Эмуляция клавиатуры и мыши поддерживает разные профили, выберите нужный профиль или [создайте новый профиль](https://github.com/r57zone/DSAdvance/blob/master/BINDINGS.RU.md). Также имеются Xbox профили, для изменения раскладки кнопок. Профили переключаются на клавиши `ALT + ↑/↓`, если окно активно или на геймпаде, с помощью `PS/Home + ↑/↓`. Профиль по умолчанию позволяет работать в Windows. 
 
 Поддержаются адаптивные триггеры для Sony DualSense в режиме USB, переключаться между различными режимами можно на `ALT + 3/4`.
 
@@ -64,6 +65,8 @@
 ------------ | ------------- | ------------- | -------------
 Сброс/поиска контроллеров | - | - | `CTRL + R` или `Numpad 0` (по умолчанию, можно изменить)
 Обменять первый и второй контроллер местами | - | - | `ALT + V`
+Переключение режимов (геймпад, клавиатура и мышь и т.д.) | `PS/Home + ←/→` | `Capture/Home` | `ALT + Q`, `ALT + ←/→`
+Переключение профилей Xbox / Клавиатура и мышь | `PS+ ↑/↓` | `Home + ↑/↓` | `ALT + ↑/↓`
 Открытие игровой панели Xbox (нажатие `Win + G`) | `PS` | `Capture + Home` | -
 Уменьшение и увеличение громкости Windows | `PS + □` и `PS + ○` | `Capture + Y` и `Capture + A` | -
 Скриншот (нажатие `Win + ALT + PrtScn`) | Кнопка микрофона или `PS + X` | `Capture + B` | -
@@ -87,7 +90,7 @@
 6. При необходимости измените мёртвые зоны стиков, триггеров или другие параметры, в конфигурационном файле `Config.ini`.
 7. (Необязательно) Для включения работы двух геймпадов измените параметр `Enabled` на `1`, в разделе `SecondaryGamepad`. Также можете изменить мёртвые зоны стиков, триггеров и цвет.
 8. При использовании со Steam играми, в настройках контроллера, отключите `персональные настройки Playstation`.
-9. Также рекомендуется установить [HidHide](https://github.com/nefarius/HidHide/releases), после чего в `HidHide Configuration Client` нужно добавить `DSAdvance.exe` и включить параметр `Enable device hiding` (если выключен). Необходимо для того, чтобы игра не видела наш контроллер, а видела только эмулируемый Xbox 360 геймпад.
+9. Также рекомендуется скрыть контроллер для современных игр, чтобы игры видели только эмулируемый, продвинутый Xbox 360 контроллер. Для этого необходимо установить [HidHide](https://github.com/nefarius/HidHide/releases), после чего в `HidHide Configuration Client`, в разделе `Devices` нужно отметить галочкой ваш контроллер (например, Sony Wireless контроллер) и включить параметр `Enable device hiding` (если выключен), в разделе `Applications` нужно добавить путь до `DSAdvance.exe`. Можно также посмотреть [эту инструкцию](https://github.com/user-attachments/assets/13ad8583-4b32-4a0d-b9a6-8e6c5bfcca71), где показано куда нажимать. Через Launcher можно проделать все тоже самое, кроме добавления геймпада в список для скрытия.
 10. (Необязательно) Для запуска из области уведомлений (tray), по двойному клику, можно добавить ярлык на `Launcher.exe` в автозагрузку Windows `%AppData%\Microsoft\Windows\Start Menu\Programs\Startup`.
 11. (Необязательно) Для запуска сторонних утилит через Launcher укажатие имя и путь до приложения в конфигурационном файле.
 
@@ -120,6 +123,11 @@
 • **Nintendo Pro контроллер или Джойконы постоянно вибрируют после старта программы**<br>
 К сожалению, на некоторых геймпадах вибрация может работать некоректно, выключите геймпад и отключите вибрацию в конфигурационном файле, изменив параметр `RumbleStrength` на `0`.
 
+
+
+• **Nintendo контроллеры не вибрируют в проводном режиме**<br>
+К сожалению, это не реализовано.
+
 ## Благодарности
 * Sony и Nintendo за самые продвинутые геймпады и инвестирование в инновации, а также за продвижение инноваций в игры.
 * [ViGEm](https://github.com/nefarius/ViGEmBus) за возможность эмуляции разных геймпадов.
diff --git a/README.md b/README.md
@@ -14,7 +14,7 @@ Advanced Xbox gamepad emulation for Sony DualSense, DualShock 4, Nintendo Pro co
 ✔️ Windows control, volume adjustment, and screenshot creation using a gamepad;<br>
 ✔️ Remapping Xbox controller buttons, different profiles;<br>
 ✔️ Keyboard and mouse emulation for old games, as well as profiles;<br>
-✔️ Support for adaptive triggers for Sony DualSense in USB connection mode;<br>
+✔️ Support for adaptive triggers for Sony DualSense in USB connection mode (pistol, rifle, sniper rifle, bow, car pedal);<br>
 ✔️ Various emulation modes for games with adaptive triggers;<br>
 ✔️ Battery level display on the light bar and player indicators (for Sony gamepads);<br>
 ✔️ Turning off the light bar for full immersion in the dark;<br>
@@ -36,13 +36,14 @@ When pressing the default profile button on the DualSense, white LEDs indicate t
 
 Double-tap the brightness area, then swipe left or right to adjust the backlight brightness. Double-tap again to lock it and prevent accidental changes.
 
-There are 3 emulation modes:
-* Simple Xbox gamepad emulation with extended functionality;
-* Xbox gamepad emulation only for driving mode and mouse aiming (for certain games with adaptive triggers);
-* Mouse only;
-* Keyboard and mouse emulation for Windows control and some older games;
+There are 5 emulation modes:
+* Xbox gamepad emulation with extended features;
+* Xbox gamepad emulation only for driving mode and mouse aiming (for games with adaptive triggers);
+* Mouse only (if you want to use native gamepad support but with more precise aiming);
+* Keyboard and mouse emulation for Windows control;
+* Keyboard and mouse emulation for old retro games;
 
-Mode switching is done via `ALT + Q` or `PS/Home + ←/→` and `Capture/Home`. Keyboard and mouse emulation supports different profiles; select the required profile or [create a new one](https://github.com/r57zone/DSAdvance/blob/master/BINDINGS.md). There are also Xbox profiles for changing the button layout. Profiles can be switched using `ALT + ↑/↓` when the window is active, or on the gamepad using `PS/Home + ↑/↓`. The default profile allows Windows operation.
+Mode switching is done via `ALT + Q`, `ALT + ←/→` or `PS/Home + ←/→` and `Capture/Home`. Keyboard and mouse emulation supports different profiles; select the required profile or [create a new one](https://github.com/r57zone/DSAdvance/blob/master/BINDINGS.md). There are also Xbox profiles for changing the button layout. Profiles can be switched using `ALT + ↑/↓` when the window is active, or on the gamepad using `PS/Home + ↑/↓`. The default profile allows Windows operation.
 
 Adaptive triggers for Sony DualSense in USB mode are supported, you can switch between different modes with `ALT + 3/4`.
 
@@ -65,6 +66,8 @@ Action | Sony Buttons | Nintendo Buttons | Windows
 ------------ | ------------- | ------------- | -------------  
 Reset/Search Controllers | - | - | `CTRL + R` or `Numpad 0` (default, can be changed)
 Swap first and second controllers | - | - | `ALT + V`
+Mode switching (gamepad, keyboard and mouse, etc.) | `PS/Home + ←/→` | `Capture/Home` | `ALT + Q`, `ALT + ←/→`
+Switching profiles Xbox / Keyboard and mouse | `PS+ ↑/↓` | `Home + ↑/↓` | `ALT + ↑/↓`
 Open Xbox Game Bar (`Win + G` press) | `PS` | `Capture + Home` | -  
 Decrease and increase Windows volume | `PS + □` and `PS + ○` | `Capture + Y` and `Capture + A` | -  
 Screenshot (`Win + ALT + PrtScn` press) | Microphone button or `PS + X` | `Capture + B` | -  
@@ -88,7 +91,7 @@ Turn off light bar (Sony) | `PS + L1` or double-tap the brightness area of the t
 6. If necessary, change the dead zones of the sticks, triggers or other parameters in the configuration file `Config.ini`.
 7. (Optional) To enable operation of two gamepads, change the `Enabled` parameter to `1` in the `SecondaryGamepad` section. You can also adjust dead zones for sticks, triggers, and colors.
 8. When used with Steam games, in the controller settings, disable `Playstation personal settings`.
-9. It is also recommended to install [HidHide](https://github.com/nefarius/HidHide/releases), then in the `HidHide Configuration Client` add `DSAdvance.exe` and turn on the parameter `Enable device hiding` (If turned off). It is necessary so that the game did not see our controller, and saw only emulated Xbox 360 gamepad.
+9. It is also recommended to hide your controller for modern games so that they detect only the emulated, advanced Xbox 360 controller.   To do this, install [HidHide](https://github.com/nefarius/HidHide/releases). Then, in the `HidHide Configuration Client`, under the `Devices` tab, check your controller (for example, Sony Wireless Controller) and enable the `Enable device hiding` option (if it is disabled). In the `Applications` tab, add the path to `DSAdvance.exe`. You can also check [this guide](https://github.com/user-attachments/assets/13ad8583-4b32-4a0d-b9a6-8e6c5bfcca71) showing exactly where to click. Through the Launcher, you can do the same, except adding the gamepad to the hidden devices list.
 10. (Optional) To launch from the notification area (tray), by double-clicking, you can add a shortcut to `Launcher.exe` to Windows startup `%AppData%\Microsoft\Windows\Start Menu\Programs\Startup`.
 11. (Optional) To run third-party utilities via Launcher, specify the title and path to the application in the configuration file.
 
@@ -121,6 +124,12 @@ Launch DSAdvance first, and only then the game itself, the game can give priorit
 • **Nintendo Pro controller or Joy-Cons rumble constantly after starting the program**<br>
 Unfortunately, rumble may not work correctly on some gamepads. Turn off the gamepad and disable rumble in the configuration file by changing the `RumbleStrength` parameter to `0`.
 
+
+
+• **Nintendo controllers don't rumble in wired mode**<br>
+Unfortunately, this feature is not implemented.
+
+
 ## Credits
 * Sony and Nintendo for the most advanced gamepads and investment in innovation, and for driving innovation in games.
 * [ViGEm](https://github.com/nefarius/ViGEmBus) for the ability to emulate different gamepads.
diff --git a/Source/DSAdvance/DSAdvance.cpp b/Source/DSAdvance/DSAdvance.cpp
diff --git a/Source/DSAdvance/DSAdvance.h b/Source/DSAdvance/DSAdvance.h
