Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updating to new version.
Info
titleHeads Up...

This application is in its early stages and therefore will probably go through a number of changes based on user feedback and the addition of features. Please contact us at support@virzoom.com with any input!

Go to github and click on the "Clone or Download" button, and then choose "Download Zip." After downloading this file, unzip the folder wherever you want the emulator to run from.

Now, you have to run VJoySetup.exe. (You'll find it in the unzipped folder) This installs a number of "virtual" joysticks on your system that the emulator uses. Now, simply run VZGamepadEmulator.exe You will see the window pop up with the VirZoom logo. From the menu, you can pick what type of VR headset you are using. Choose OpenVR if you have a Vive, Oculus for Oculus, or None if you just want to use the bike without headset data. Additionally, to reset the head tracking, you hold both triggers for 1 second. Do this when you start, or when you feel like the positional head tracking is not working correctly.

X360ce (Sometimes necessary)

Some PC games only support the Xbox 360/Xbox One controllers. This means we need to take an extra step for VZGE. First, you have to download x360ce here and get the 64 bit version.

This will download a zip file with x360ce_x64.exe inside it. Now, whenever you want to play a game that supports only Xbox controllers with the bike, you have to do the following:

  1. copy x360ce_64.exe into the same folder as the game's exe file.
  2. run x360ce_64.exe
  3. click 'create' when it asks if you want to create xinput1_3.dll
  4. search for automatic settings for vJoy device (this is the VJoySetup device you installed earlier)
  5. click finish
  6. Click save in the main screen.

This will have save xInput1_3.dll in the same folder. Unfortunately, we're not done. Because of multiple versions of XInput, we need to copy this dll 3 times and rename it xinput1_1.dll, xinput1_3.dll, and xinput1_4.dll

We should now be done. Close the x360ce application. VZGE should now appear as an Xbox controller to the PC game in that folder.

But how do you know if a game requires x360ce? It's a pretty good guess if you google the control scheme of a game, and it only shows Xbox controller diagrams. On the other hand, most Unity games use Raw Input, so they don't require x360ceIn order to get the gamepad emulator, do a search for "VirZOOM" on Steam. You will find the VirZOOM Gamepad emulator as a free software application. Select this and install this as usual. Note that the process may also install the VJoy library at this time if you do not have it already.

Once you have the emulator, it can be used to convert output from the bike to either a DirectInput controller or Xbox Controller. To start off, simply follow these steps:

1) Start up the emulator from steam

2) Make sure the bike is connected. There is a text box that shows the state of the bike that will start out in red, and then show when the bike connects. You may have to hit some buttons on your bike to wake it up.

3) If you have a VR headset, Make sure you have the proper VR type selected from the menu. A text box will show the state of the headset. Once it is recognized, look straight forward and hold both triggers for 2 seconds for the emulator to calibrate. Now you are ready.

4) Now, launch the game you would like to play. Use the emulator to map controls coming off the bike to gamepad controls!

Xbox Controllers vs. DirectInput Controllers

PC games handle Xbox controllers and other types differently. This is unfortunate, and complicates the emulator somewhat. In order to use the emulator as an Xbox controller, an additional step must be taken. First, the controller type must be set to Xbox in the menu. The emulator will then prompt you to find the .exe for the game. This can be a real pain, we're sorry. Usually, it's somewhere under Program Files or Program Files (x86). Once the exe is found, the emulator injects some dlls that makes the bike appear like an Xbox controller that the game will communicate with. Later, if you want to play the game as usual, you should select the File/Clean Xbox App Folder to move sure you remove the dlls that were added.

Every time the emulator is switched between VJoy and Xbox Controller types, the necessary files are cleaned up in the game's exe folder.

Steam Workshop

It is possible to get control mappings as UGC (User generated content) as well as create UGC to upload to Steam Workshop.

To get content that other people have created, first go to the VirZOOM Gamepad Emulator page on Steam. Next click "Community Hub" and then Workshop. Now you can browse items and subscribe to those you like. Subscribed items will automatically be downloaded to your emulator. To load the configurations up in the emulator, click "File/Open UGC." This will give you a list of UGC items that were subscribed to. Select one and hit "Ok." For mappings that use the Xbox Controller, the game's exe will need to be selected.

To create UGC for the Steam Workshop, first create the configuration for a game. Make sure to fill out the description window at the bottom of the emulator with additional notes about this mapping. Then, select "File/Upload or Update UGC." If this is the first upload for this mapping, an image will have to be selected to be used in Steam Workshop. Hit OK, and the content will be uploaded to Steam for others to use! After an edits, "File/Upload or Update UGC" will simply update the already existing content.