鬼武者 DualSense 触觉反馈

描述
《鬼武者：剑之道》PC版非官方DualSense触觉反馈模组。
它通过USB或兼容的蓝牙连接，增加基于声音和动作的触觉反馈，以及自适应扳机效果。

此模组不会重现PS5的触觉反馈或游戏的官方触觉效果。它会从游戏的音效中生成触觉文件，并作为模组播放。

主要功能

• 根据你本地安装的游戏中的音频数据生成详细的触觉反馈。
• 为攻击、命中、格挡、偏转、招架、闪避、移动、UI操作以及其他游戏事件添加专用特效。
• 为支持的操作添加自适应扳机效果。
• 为护手使用、灵魂吸收和裂隙封印添加可配置的L2震动，同时保留弓的扳机效果。
• 支持USB及兼容蓝牙连接，包括手柄重连及在两者间切换。
  

要求

• Windows x64。
• 通过USB或兼容蓝牙连接的DualSense控制器。推荐使用USB连接。DualSense Edge的支持为临时性支持，尚未在实体硬件上测试。
• 适用于 Windows x64 的 .NET 10 运行时不需要 SDK。
• 兼容版本： REFramework.
• 对于USB连接，必须在Windows中启用DualSense音频设备。蓝牙触觉反馈不需要此音频设备。
  

安装
重要
由于Nexus Mods的隔离系统，Nexus Mods ZIP不包含CMD脚本。该 GitHub 发布 ZIP 包含它们。

如果你使用的是Nexus Mods的ZIP包，请将以下三个脚本保存到解压后的模组文件夹中，与config.json和bin文件夹放在一起。请确保它们的文件名以.cmd结尾，而不是.cmd.txt。

• 在游戏文件夹中安装兼容版本的REFramework。
• 下载并解压该模组。
• 从GitHub发布版ZIP中获取CMD文件，或使用以下脚本创建它们。
• 运行 Setup.cmd。如果出现提示，请输入包含 OnimushaWotS.exe 的游戏文件夹。
• 请稍候，安装程序正在下载所需的外部工具，并从您的本地游戏文件生成触觉数据。
• 连接DualSense控制器。
• 运行 Start-Mod.cmd。
  

首次设置可能需要一些时间，并需要约 1 GB 的可用空间来生成触觉数据。

Setup.cmd

@echo off
设置本地化
cd /d "%~dp0"
set "modDotnet=%ProgramFiles%\dotnet\dotnet.exe"
如果不存在 "%modDotnet%" 则设置 "modDotnet=dotnet"
"%modDotnet%" "%~dp0bin\OnimushaDualSense.dll" setup %*
set "modExit=%ERRORLEVEL%"
暂停
exit /b %modExit%

启动模组.cmd

@echo off
设置本地化
cd /d "%~dp0"
set "modDotnet=%ProgramFiles%\dotnet\dotnet.exe"
如果不存在 "%modDotnet%" 则设置 "modDotnet=dotnet"
“%modDotnet%” “%~dp0bin\OnimushaDualSense.dll” launch %*
set "modExit=%ERRORLEVEL%"
如果 not "%modExit%"=="0" 则暂停
exit /b %modExit%

卸载.cmd

@echo off
设置本地化
cd /d "%~dp0"
set "modDotnet=%ProgramFiles%\dotnet\dotnet.exe"
如果不存在 "%modDotnet%" 则设置 "modDotnet=dotnet"
“%modDotnet%” “%~dp0bin\OnimushaDualSense.dll” uninstall %*
set "modExit=%ERRORLEVEL%"
暂停
退出 /b %modExit%

用法

• 连接 DualSense 控制器。
• 运行 Start-Mod.cmd。
• 默认情况下，该模组会自动启动游戏。游玩时请保持命令窗口开启。
• 游戏退出后，模组会自动关闭。你也可以通过关闭其命令窗口来停止模组。
  

要手动启动游戏，请将 auto_launch_game 设置为 false，运行 Start-Mod.cmd，然后从 Steam 启动游戏。

配置
编辑 config.json 在模组文件夹中：

• 获得 — 整体触觉强度。范围：0.0–3.0。默认值：1.0。
• 自适应触发器 — 启用自适应扳机效果。默认：true。设为 false 可同时禁用扳机阻力和扳机震动。
• 自适应触发强度 自适应触发效果的整体强度，包括下方三种振动效果。范围：0.0–1.0。默认值：1.0。
• 护手震动 — 微弱L2嗡鸣的强度。范围：0.0–1.0。默认值：1.0。设为0可禁用。该效果在游戏过程中保持启用，按住L2时可感知；它不会单独检测护手的使用。
• 灵魂振动 吸收灵魂时短暂L2脉冲的强度。范围：0.0–1.0。默认值：1.0。设为0可禁用脉冲，同时不会中断护手嗡鸣声。
• 裂隙震动 封印裂隙时扳机振动的强度。范围：0.0–1.0。默认值：1.0。此项会替换裂隙配置的阻力；设为0可保留其原始阻力。弓的扳机配置不受影响。
• 自动启动游戏 — 启动模组时是否自动启动游戏。默认：true。
  

当 adaptive_triggers 为 false 时，所有三个扳机振动设置都会被忽略。扳机力度有八个硬件档位，因此低值可能会向下取整而无效。

修改配置后重启模组。

该 游戏 路径由安装程序自动检测并写入。

卸载

• 关闭游戏和模组。
• 运行 Uninstall.cmd。
• 如果不再需要，请删除已解压的模组文件夹。
  

故障排除
如果模组没有响应，请检查以下内容：

• DualSense 已通过 USB 或蓝牙连接，且仅连接了一个受支持的手柄。
• 对于USB，DualSense音频设备在Windows中已启用。
• 你的蓝牙连接兼容该模组的直接HID触觉反馈。如果蓝牙无法工作，请尝试使用USB连接。
• REFramework 已安装，并与当前游戏版本兼容。
• Steam输入和游戏的控制器设置工作正常。
• “开始模组”命令窗口保持打开状态。
  

额外的诊断信息将写入：
data/bridge.log
如果遇到问题，请把这个日志发给我。

它是怎么运作的？
在初始设置期间，该模组会下载经过校验和验证的解包与音频解码工具。它使用这些工具从你本地安装的游戏文件中生成触觉数据。

一个REFramework Lua脚本会监听支持的游戏玩法与音频事件。外部模组进程利用这些事件来播放基于声音的触觉反馈，并控制自适应扳机效果。

USB触觉反馈使用DualSense音频设备。兼容的蓝牙连接使用直接HID触觉反馈。

生成的游戏派生数据存储在本地 数据 文件夹并在后续启动时重复使用。请勿重新分发包含此生成数据的使用过的 mod 文件夹。仅重新分发原始下载 ZIP。