Control Mapper plugin
The control mapper plugin is designed to be an alternative to various "Joy to joy" solutions already available, but primarily focused on wheels hot swapping with the "keep it simple" philosophy, it allows to aggregate multiple wheels buttons / controllers to a single one allowing easy in game controller/wheel hot swapping.
- Many simple use cases :
- Wheel hot swapping : no matter if you have two or ten wheels, diy or commercial , wheel swapping dream is often broken by in game mappings to be done again
- Sequential shifter vs paddles ? you can have both ready to go.
- Controllers limits ? ATS/ETS2 limits you to 4 controllers : one handbrake, one split shifter, one shifter, one wheel ... No room available anymore for your button box or any fancy controller you might still have.
- Some key features
- "role name" based mapping, because most wheels have many buttons nowadays who can remember what does "button 1" or "button 42" ? It allows to quickly add a new wheel based on names instead of numbers.
- Multiple virtual controller options available to fit as best as possible your existing setup :
- Vjoy : as it is THE known software only solution for such cases, but it went so popular that it's maybe already busy for another software, and adding multiple Vjoy controllers is not always handled fluently by all games.
- Arduino Pro micro / leonardo bridge: just plug one of those arduino boards and after a two clicks flash process, benefit of a driver less and conflict less virtual controller.
- A simple web interface accessible from your phone allows to do all your in game bindings avoiding tinkering with HIDHide and similar softwares to avoid double inputs.
- SimHub internal actions bindings will use "roles" in priority allowing to bind actions independently of the actual device.
- Currently only buttons are supported, in a future update it's planned to get up to 6 axis mostly targeting wheels clutch paddles.
- To keep it robust it's not planned to support FFB in any way. when it comes to FFB the simplest the better ;)
- Go in SimHub settings/plugins and enable the Control Mapper plugin :
- Go back to games to apply the changes
You can choose either VJoy or an Arduino bridge (ATMEGA32U4 based : Arduino Leonardo or Arduino pro micro)
PROS :
- The free software only solution.
CONS :
- Might conflict with existing apps (IRfff, joystick gremlin)
- Multiple VJoy controllers are not always gracefully handled by games
HOW TO :
- Install VJOY : (download is available here https://github.com/jshafer817/vJoy see releases on the right column) :
- Open the "configure Vjoy" app
- Activate a Vjoy controller with 128 buttons
- In the control mapper plugin choose "VJoy" and set the target joystick :
There you are you are ready for remapping !
PROS :
- A specifically tailored solution avoiding conflicts with VJOY
- It's a standard HID device not requiring any specific drivers and not risking to be broken after a window update.
CONS :
- It's an hardware solution requiring a to throw a few bucks into an Arduino ;)
HOW TO :
- Get an "Arduino Pro Micro" or an "Arduino Leonardo"
- Plug it to your computer
- Unplug any other arduinos you might have to avoid flashing the wrong device
- In the control mapper plugin choose "Bridge" and click on the flash button :
- Select your Arduino serial port, read the warning once again, check that your agree and click on "Flash" :
- Flashing process will take a few seconds
- Click Ok, the device will now connect :
There you are you are ready for remapping !
- Click on "assign roles" and review all the actions you want to be available, games will bind your controller based on button numbers, don't "move" a button after having it assigned in game :
- Add a controller
- Click on Map controller :
- You can now review all the actions and associate a button from the controller, when you are done, click on OK :
Most games won't bind buttons correctly when two devices are sending the inputs at the same time, it requires a little trickery to get past the input binding step ;)
- Take your phone, make sure it is on the same network as your computer and flash the QR code available in SimHub :
It will open a simple page with a button per role, simply click on it to trigger the virtual controller and avoid the "double inputs" conflicts :
It's now time to have fun !
NB : If the page don't show you can refer to the web access troubleshooting guide available here : https://github.com/SHWotever/SimHub/wiki/Troubleshoot-Dashstudio-Web-access