Repository navigation
FH-DualSense-Enhanced R6
Enhanced R6 中文说明
Enhanced R6 相比上一稳定版 Enhanced R5,把游戏平台扩展为 Steam 与 Xbox App,并继续支持 Forza Horizon 4、Forza Horizon 5 和 Forza Horizon 6。总览页会记住平台与游戏;Steam 通过对应 steam://run/<app-id> 启动,Xbox App 会优先使用 Windows 当前安装的 AUMID 直接启动,无法解析时打开对应 Xbox App 商品页供用户点击游玩。启动始终由用户点击触发,不会自动启动游戏或修改游戏设置。
Windows x64 版新增内置 DualSense 到 XInput 连接桥。Xbox App 模式把物理 DualSense 映射为虚拟 Xbox 360 Controller,不要求 DS4Windows,也不需要把 Xbox App 游戏加入 Steam。Steam 模式不会创建虚拟手柄。桥接包含 latest-state 转发、100 ms 中立保护和 3 s 移除保护,不接管游戏原生振动,也不安装或配置 HidHide。
若电脑缺少兼容的 ViGEmBus,软件会在用户确认后校验并打开内置的官方 ViGEmBus 1.22.0 安装程序,通过 Windows UAC 安装且不需要联网。已有兼容驱动会直接复用,不自动升级。ViGEmBus 与 ViGEmClient 已停止上游维护,本项目固定版本与 SHA-256,并允许随时切回 Steam 模式关闭连接桥。
独立的“FH6 实用功能”页面集中提供“中文文字 + 英文语音”和 DualSense 按键图标安装与还原,系统与更新页不再保留重复入口。两项功能均支持 Steam 与 Xbox App 安装目录:Steam 自动发现,Xbox App 由用户手动选择并保存。语言卡片分别显示当前游戏语言、实际显示语言和语音语言,无法验证的 Xbox App 语言会明确显示未知并要求额外确认,不会伪造结果。EXE 只内置一份 MOD 资源,安装前分别备份普通与 HiRes 原文件;写入失败会回滚,游戏运行时拒绝修改。感谢图标 MOD 作者 @hotline1337 授权并提供 MOD:Nexus Mods MOD 页面;游戏更新或验证文件后可能需要重新安装。
GUI 页面现在只挂载一次并通过 tkraise() 切换,避免每次导航都重新布局。总览只探测当前选择的 Steam 游戏,找到有效路径后停止探测;未找到时每 30 秒静默重试。按钮、平台选择器和 XInput 提示只在实际状态变化时重绘,默认平台保持 Steam。更新提醒点的黑色方块已修复,并完成 FH4/FH5/FH6 通用启动文案。Enhanced R6 仍基于 Forza-Horizon-DualSense-Python 1.6.2,触觉参考 HorizonHaptics 1.3.0,Bluetooth HD haptics 协议参考 vDS 0.3.0-rc7 与 DS5Dongle。
Windows 独立 EXE(推荐)
下载:FH-DualSense-Enhanced-R6.exe
EXE 已包含 Python 和全部依赖,不需要 BAT、ZUV、uv 或本机 Python。请把对应 .sha256 文件留在 Release 中供内置更新器校验;用户手动启动 EXE 时不需要同时下载 .sha256。
ZUV / Linux 备用方式
Windows 可下载 win_start.bat,Linux 可下载 linux_start.sh。启动器下载 FH-DualSense-Enhanced.zuv.py,Windows 启动器在需要时安装 uv。网络不稳定时,也可以手动下载 ZUV 本体并放到启动器旁边。Linux 独立文件为 FH-DualSense-Enhanced-R6;内置 EXE 更新只支持 Windows 冻结版本。
必要设置
Steam 版保持 Steam Input 与 DualSense vibration 开启;Xbox App 版在软件中选择 Xbox App,不要同时运行 Steam Input 或 DS4Windows 接管同一手柄。所有平台都要在 Forza Horizon 中开启 Data Out,IP 设为 127.0.0.1、端口设为 5300,并关闭游戏内振动,否则原生 rumble 会争用并掩盖本项目的握把反馈。收不到 UDP 时,请在防火墙中允许应用和 UDP 5300。
- 设置保存在程序旁边的
data/user_preferences.json,更新后继续保留。- Linux 启动器不会安装 udev 规则。HID 权限不足时,请下载
70-dualsense.rules,复制到/etc/udev/rules.d/,重新载入规则后连接手柄。- 预发布频道仍可通过
uv run FH-DualSense-Enhanced.zuv.py --prerelease跟踪。
Enhanced R6 English notes
Compared with the previous stable Enhanced R5, Enhanced R6 adds Steam and Xbox App platform workflows for Forza Horizon 4, Forza Horizon 5, and Forza Horizon 6. Overview remembers both selections. Steam uses the matching steam://run/<app-id> URI. Xbox App first attempts direct activation through the installed current-user AUMID, then falls back to the matching Xbox App product page so the user can press Play. Launch is always user initiated and never changes game settings.
Windows x64 now includes a DualSense-to-XInput bridge. Xbox App mode exposes the physical DualSense as a virtual Xbox 360 Controller without DS4Windows or adding the game to Steam. Steam mode creates no virtual target. Latest-state forwarding, a 100 ms neutral guard, and a 3 s target-removal guard prevent stale controls. The bridge does not capture native game rumble and does not install or configure HidHide.
If no compatible ViGEmBus is available, the app verifies and opens the bundled official ViGEmBus 1.22.0 installer only after confirmation. Windows UAC is shown and installation works offline. A compatible existing driver is reused without automatic upgrades. ViGEmBus and ViGEmClient are archived upstream, so this project fixes their versions and SHA-256 values and lets users disable the bridge by returning to Steam mode.
A dedicated FH6 Utilities page now contains the Chinese-text plus English-voice tool and FH6 DualSense icon installation and restore actions; System and Updates no longer duplicates them. Both utilities support Steam and Xbox App installations: Steam paths are discovered automatically, while Xbox App paths are selected and saved manually. The language card separately shows the current game, effective display, and voice languages. An Xbox App language that cannot be verified remains explicitly Unknown and requires extra confirmation instead of being invented. The EXE bundles one MOD archive, backs up the normal and HiRes originals separately, rolls back failed writes, and refuses changes while FH6 is running. Thanks to icon MOD author @hotline1337 for permission and the MOD: Nexus Mods MOD page. Game updates or file verification can require reinstallation.
GUI pages are mounted once and switched with tkraise() instead of being laid out again on every navigation. Overview discovers only the selected Steam game, stops after a valid path is found, and retries missing installs silently every 30 seconds. Buttons, selectors, and XInput hints redraw only when their presentation changes, while Steam remains the default platform. It fixes the black background behind the update notification dot and completes generic FH4/FH5/FH6 launch wording. Enhanced R6 remains based on Forza-Horizon-DualSense-Python 1.6.2, references HorizonHaptics 1.3.0, and uses vDS 0.3.0-rc7 plus DS5Dongle as Bluetooth HD haptics protocol references.
Windows standalone EXE (recommended)
Download FH-DualSense-Enhanced-R6.exe. It includes Python and all runtime dependencies, so BAT, ZUV, uv, and a local Python installation are not required. The matching .sha256 remains attached to the Release for the built-in updater; users launching the EXE manually do not need to download it separately.
ZUV / Linux fallback
Windows users may download win_start.bat, and Linux users may download linux_start.sh. The launchers fetch FH-DualSense-Enhanced.zuv.py; the Windows launcher installs uv when required. On an unreliable connection, place a manually downloaded ZUV file next to the launcher. The standalone Linux asset is FH-DualSense-Enhanced-R6. Built-in executable replacement is available only in the frozen Windows build.
Required settings
For Steam, keep Steam Input and DualSense vibration enabled. For Xbox App, select Xbox App inside FH-DualSense-Enhanced and do not let Steam Input or DS4Windows claim the same controller. On every platform, enable Forza Data Out at 127.0.0.1:5300 and disable in-game vibration, otherwise native rumble can compete with or mask this project's grip feedback. Allow the app and UDP 5300 through Windows Firewall if packets do not arrive.
- Settings are stored in
data/user_preferences.jsonbeside the executable and remain across updates.- The Linux launcher does not install udev rules. If HID access is denied, download
70-dualsense.rules, copy it to/etc/udev/rules.d/, reload the rules, and reconnect the controller.- The preview channel remains available through
uv run FH-DualSense-Enhanced.zuv.py --prerelease.