BetterJoy：让Switch手柄跨平台复用的开源工具

BetterJoy：让Switch手柄跨平台复用的开源工具

【免费下载链接】BetterJoyAllows the Nintendo Switch Pro Controller, Joycons and SNES controller to be used with CEMU, Citra, Dolphin, Yuzu and as generic XInput项目地址: https://gitcode.com/gh_mirrors/be/BetterJoy

BetterJoy是一款开源工具，能够使Nintendo Switch Pro手柄、Joy-Con和SNES控制器在Cemu、Citra、Dolphin、Yuzu等主流模拟器以及系统级XInput平台上无缝使用。通过该工具，用户可以充分发挥Switch手柄的潜力，实现陀螺仪转鼠标控制、自定义特殊按键功能等操作，让Switch手柄不再局限于Switch主机，成为跨平台的万能游戏控制器。

功能价值：解决Switch手柄跨平台使用难题

多设备兼容能力

BetterJoy支持Nintendo Switch Pro手柄、Joy-Con（单握和双握模式）以及SNES经典手柄等多种设备，满足不同用户的手柄使用需求。无论是喜欢Pro手柄的舒适握持感，还是偏好Joy-Con的灵活操作，都能通过该工具实现跨平台使用。

跨平台适配优势

该工具能够适配Cemu、Citra、Dolphin、Yuzu等主流游戏模拟器，同时还支持Steam等系统级XInput平台。这意味着用户无需为不同的游戏平台购买额外的手柄，极大地降低了手柄使用成本，解决了跨平台适配的问题。

场景应用：BetterJoy的典型使用场景

模拟器游戏体验

在Cemu模拟器中玩《塞尔达传说：荒野之息》时，使用Switch Pro手柄通过BetterJoy进行连接。打开Cemu后，进入输入设置选择XInput作为输入源，按照正常流程分配按键，勾选"Also use for buttons/axes"选项，即可获得如同在Switch主机上一样的操作体验，尤其是利用Pro手柄的体感功能进行瞄准等操作，更加精准便捷。

系统级游戏娱乐

在Steam平台玩《怪物猎人：世界》等支持XInput的游戏时，将Joy-Con通过蓝牙连接到电脑，BetterJoy会自动识别并将其模拟为XInput设备。用户可以根据自己的习惯自定义按键映射，使用Joy-Con的体感功能来实现游戏中的视角控制，提升游戏的沉浸感。

配置指南：驱动安装与软件设置

驱动安装步骤

1. 操作目的：安装必要的驱动程序，确保手柄能被正确识别和模拟。执行方法：进入项目驱动目录BetterJoyForCemu/Drivers/，根据系统类型选择安装ViGEmBus驱动，64位系统运行ViGEmBusSetup_x64.msi，32位系统运行ViGEmBusSetup_x86.msi；若需要解决手柄冲突，可运行HIDGuardian Install (Run as Admin).bat安装HIDGuardian驱动。预期结果：驱动安装成功，重启电脑后生效。

[!NOTE] 安装驱动时请务必以管理员身份运行，否则可能导致驱动安装失败或功能异常。ViGEmBus驱动是实现手柄模拟的关键，它能将Switch手柄模拟为标准的XInput设备，让各种游戏和模拟器能够正常识别和使用。

软件启动与手柄连接

1. 操作目的：启动BetterJoy软件并连接手柄。执行方法：运行BetterJoyForCemu.exe，建议以管理员身份启动。对于蓝牙连接，长按手柄Sync键5秒进入配对模式，在系统蓝牙设置中配对；对于USB连接，直接用USB-C数据线连接电脑。预期结果：软件启动成功，手柄连接后在主界面显示已连接的控制器图标和状态。

进阶技巧：释放手柄高级功能

陀螺仪鼠标控制

适用场景：在需要精准瞄准的游戏（如射击类游戏）中，将手柄陀螺仪转为鼠标控制可提高瞄准精度。 操作方法：在BetterJoy主界面勾选"Gyro Mouse"选项，然后在设置中根据个人习惯调整灵敏度和响应曲线。设置完成后，移动手柄即可像使用鼠标一样控制游戏中的视角。

特殊按键自定义

适用场景：对于SL、SR、Capture等特殊按键，用户可根据自己的需求将其映射为键盘快捷键，实现更便捷的操作。 操作方法：在主界面点击"Reassign"按钮打开映射窗口，选择要自定义的按键，按下键盘上的目标按键完成映射，保存配置并应用。例如，可将Capture键映射为游戏中的截图快捷键。

故障排除指南：常见问题解决方法

连接问题

1. 手柄无法被识别
   • 检查ViGEmBus驱动是否已正确安装并重启电脑。
   • 尝试重新插拔USB线或重新配对蓝牙。
   • 查看Windows设备管理器中是否有未知设备，如有可尝试更新驱动。
   • 以管理员身份运行BetterJoy。

功能异常

1. 按键映射不生效
   • 确保BetterJoy以管理员身份运行。
   • 检查是否有其他手柄软件占用设备，关闭其他相关软件后重试。
   • 尝试重新安装HIDGuardian驱动。
   • 在设置中重置按键映射为默认值。

性能优化

如果在使用过程中出现手柄响应延迟等性能问题，可尝试关闭电脑后台不必要的程序，减少系统资源占用；或者降低陀螺仪鼠标控制的灵敏度，以提高响应速度。

项目获取与编译

源码获取

通过以下命令克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/be/BetterJoy

编译指南

项目使用C#开发，需Visual Studio 2019或更高版本：

1. 打开解决方案文件BetterJoy.sln。
2. 还原NuGet包依赖。
3. 选择目标平台（x86/x64）和配置（Release/Debug）。
4. 构建解决方案，输出文件位于BetterJoyForCemu/bin/[平台]/[配置]/。

【免费下载链接】BetterJoyAllows the Nintendo Switch Pro Controller, Joycons and SNES controller to be used with CEMU, Citra, Dolphin, Yuzu and as generic XInput项目地址: https://gitcode.com/gh_mirrors/be/BetterJoy