From bbc6212d164e318dcfd648ca8d9e6e35e7d43c01 Mon Sep 17 00:00:00 2001 From: applezra Date: Sat, 31 Oct 2026 01:08:17 -0700 Subject: [PATCH] Document how to connect a Switch 2 Pro Controller with motion SDL does not open the Switch 2 Pro Controller on Windows by itself, so it needs a bridge program. Tested with the game: hbashton's DS4Windows fork emulating a DualSense gives buttons, rumble, gyro, accelerometer and calibrated sticks, read directly by the game. Bridges that output a ViGEm DualShock 4 (ProCon2Windows, connectyourpro) give rumble but frozen motion values, so motion controls do nothing with them. docs/controls.md gets a short section with the log lines that show a working setup. Co-Authored-By: Claude Opus 5.5 --- docs/controls.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/controls.md b/docs/controls.md index 29f53f0d..fbd2b192 100644 --- a/docs/controls.md +++ b/docs/controls.md @@ -86,6 +86,12 @@ Mouse motion (raw input) becomes right-stick deflection. Each presented frame ta The stick direction bits (`StickLLeft` to `StickRDown`) are derived from the sticks at 50% deflection. A gamepad plugged in later is picked up within one second; with none connected the log says `input: no gamepad`. +## Nintendo Switch 2 controllers + +Windows does not present the Switch 2 Pro Controller as a gamepad SDL can open (the log says `input: no gamepad`), so it needs a bridge program that wakes it and creates a virtual gamepad. The DS4Windows fork by hbashton ([github.com/hbashton/DS4Windows](https://github.com/hbashton/DS4Windows), tested with release VIIPERRC4.5.1, a pre-release) with the output set to an emulated DualSense gives buttons, rumble, gyro and accelerometer, and reads the sticks through the controller's calibration (they rest at 0 to 2%). The game reads its virtual DualSense directly; the log then shows `input: gamepad "DualSense Wireless Controller" (rumble, gyro and accelerometer, ...)` and `input: motion sensors on`. Its release notes also list Joy-Con 2 support, which is untested here. + +Bridges that output a ViGEm DualShock 4 (ProCon2Windows, connectyourpro as tested) give buttons and rumble but no motion: their virtual DualShock 4 reports a gyro and an accelerometer that never change, so motion aiming and Ultrahand rotation do nothing. Run one bridge at a time; Steam Input can also claim the controller, so close Steam if the bridge does not find it. + ## Scripted input `TOTK_INPUT_SCRIPT=` replays presses. It is ORed with real input and still applies under `TOTK_INPUT=none`. One event per line, `#` starts a comment: