Repository navigation
Enhanced R12 中文说明
Enhanced R12 改进 Xbox App 模式下的手柄按键响应,并集成实体 DualSense 隔离。
更新内容
- 手柄输入:改进蓝牙 ABXY 短按,以及使用键鼠后首次按键切回手柄的处理;虚拟 Xbox 360 手柄在短暂输入空档中保持连接。
- 一键安装并隔离:Xbox App 模式必须使用 HidHide。总览的“快速入口”显示安装进度、驱动与实体手柄隐藏状态。缺少驱动时,点击安装会下载并校验官方 HidHide 1.5.230 安装器,经 Windows UAC 批准后安装。已安装时不会重复下载。
- 自动配置:虚拟 Xbox 手柄就绪后,FHDS 自动放行自身、隐藏当前实体 DualSense,并在现有隐藏规则只涉及 DualSense 时开启 Device hiding,无需在官方配置界面手动勾选。已有其他设备规则或特殊反向配置时,FHDS 会提示检查。官方配置界面存在时仍可从快速入口打开。
- 输入保护与恢复:确认实体手柄已隐藏前,虚拟手柄只发送中立输入,软件内 Xbox App 游戏启动按钮保持禁用。FHDS 退出时清理自己添加的隐藏规则,保留用户原有规则;意外退出后的自有残留规则会在下次启动时清理。安装后可能需要重启 Windows,首次隐藏后可能需要重连手柄或重启游戏。
- 验收状态:蓝牙 ABXY 连按两次及 Xbox App 游戏内键鼠/手柄反复切换的效果仍需实体手柄与游戏实测。
Windows 独立 EXE(推荐)
下载 FH-DualSense-Enhanced-R12.exe。EXE 已包含 Python 和应用运行依赖;Xbox App 所需的 HidHide 驱动按需安装。
ZUV / Linux 备用方式
Windows 可使用 win_start.bat,Linux 可使用 linux_start.sh,也可以手动下载 FH-DualSense-Enhanced.zuv.py。Linux 独立文件为 FH-DualSense-Enhanced-R12;内置 EXE 更新只支持 Windows 独立版。
Linux 上若遇到 HID 权限不足,请按仓库中的 70-dualsense.rules 配置 udev 权限。
基本设置
- 在 Forza Horizon 中开启 Data Out,设置为
127.0.0.1:5300,并关闭游戏内振动。 - Xbox App 版请在软件内选择
XBOX 版,并避免同时让 Steam Input 或 DS4Windows 接管手柄。 - Xbox App 模式请在总览的“快速入口”确认 HidHide 已安装且当前实体 DualSense 已隐藏。
Enhanced R12 English notes
Enhanced R12 improves controller button response in Xbox App mode and integrates physical DualSense isolation.
What's new
- Controller input: improves handling of short ABXY presses over Bluetooth and the first controller press after mouse or keyboard use. The virtual Xbox 360 controller stays connected through brief input gaps.
- One-click installation and isolation: Xbox App mode requires HidHide. Overview -> Quick access shows installation progress, driver status, and physical controller hiding status. When the driver is missing, Install downloads and verifies the official HidHide 1.5.230 installer, then installs it after Windows UAC approval. An existing installation is not downloaded again.
- Automatic configuration: once the virtual Xbox controller is ready, FHDS allows itself to see the device, hides the current physical DualSense, and enables Device hiding when existing hiding rules only target DualSense. No manual checkbox is needed in the official client. FHDS prompts for review if other devices or inverse configuration are present. The official client remains available from Quick access when installed.
- Input protection and recovery: until the physical controller is confirmed hidden, the virtual controller sends only neutral input and the in-app Xbox App game launch button stays disabled. FHDS removes only its own hiding rules on exit and preserves existing user rules; its rules left by an interrupted exit are cleaned up on the next launch. Installation may require a Windows restart; first-time hiding may require reconnecting the controller or restarting the game.
- Validation status: the double-tap ABXY and repeated mouse/controller switching symptoms still need testing with a physical controller in the Xbox App game.
Windows standalone EXE (recommended)
Download FH-DualSense-Enhanced-R12.exe. It includes Python and the app's runtime dependencies; the HidHide driver required for Xbox App is installed on demand.
ZUV / Linux fallback
Windows users may use win_start.bat, Linux users may use linux_start.sh, or either platform may download FH-DualSense-Enhanced.zuv.py manually. The standalone Linux asset is FH-DualSense-Enhanced-R12. Built-in EXE replacement is available only in the Windows standalone build.
On Linux, if HID access is denied, configure udev permissions with 70-dualsense.rules.
Basic setup
- Enable Forza Data Out at
127.0.0.1:5300and disable in-game vibration. - For Xbox App, select
Xbox Appinside FH-DualSense-Enhanced and do not let Steam Input or DS4Windows claim the controller at the same time. - In Xbox App mode, confirm in Overview -> Quick access that HidHide is installed and the current physical DualSense is hidden.