Skip to content

vJoy output

gilphilbert edited this page Sep 12, 2024 · 1 revision

While wireless is the preferred option, there are other ways to connect your pedal as a game controller. One of these is vJoy, an application for Windows that provides a way to implement a Windows game controller without needing to implement one in firmware/drivers. For our project, we can use the serial input from the pedal(s) and convert it to axes on a virtual joystick (vJoy) device that most games can access.

Note

Setting up vJoy is more complicated than many of the other methods and requires the installation of older software, which can be challenging to get working properly on newer Windows versions, especially Windows 11. It's recommended that you only use vJoy if the other options aren't possible for some reason.

Installation

  • Install the supported version of Vjoy. Other versions are not supported by the plugin and will not work.
  • Once installed, open vJoy configuration from the Start menu
  • Open the Device #1 tab (this is the device that the SimHub plugin will use by default)
  • Enable the device. Enable all axes, naking sure to include Rx, Ry and Rz. Set the number of buttons to 128 as this will make it easier to setup in the Control Mapper SimHub plugin (more on that in a moment...)
  • Click "Apply"

Control Mapper plugin

The Control Mapper plugin is one of the pre-installed plugins for SimHub but it needs to be enabled. The Control Mapper plugin allows the mapping of devices, usually key mappings and other capabilities. While it may seem odd, it's required for vJoy.

  • Open SimHub and open the settings screen
  • In settings, open the plugins tab and enable the Control Mapper plugin
  • Close settings and open the Control Mapper plugin which should now appear on the left.
  • Under "Output Mode" choose "vJoy"
  • For the target vJoy, choose the "1"

Configuring the FFB Pedal plugin

  • Open the FFB Pedal Dashboard
  • In the plugin setting block, enable vJoy output. Make sure the device number is also set to 1 (the default value)

Monitoring vJoy devices

  • After enabling vJoy output, open "Monitor vJoy" from the Windows Start menu or search.
  • In vJoy device #1 the pedal can be tested by pressing down on the pedals while monitoring the values of Rx (throttle), Ry (brake) and Rz (clutch)