RB4InstrumentMapper

A program that maps packets from Xbox One instrument peripherals to virtual controllers, for use in games such as Clone Hero.

All Xbox One instruments are supported (RB4 guitars/drums, GHL guitar), along with the RB4 wireless legacy adapter.

Table of Contents

• Installation
  • ViGEmBus Setup
  • vJoy Setup
• Using Rock Band 4 Wireless Guitars and Drums
  • Setup
  • Jaguar Guitar Firmware Update
  • Usage
  • Having Sync Issues?
• Using Riffmasters, Guitar Hero Live Guitars, and RB4 Wireless Legacy Adapters
  • Setup
  • Usage
• Mapping your Controls
  • Clone Hero
  • YARG
• Packet Logs
• Error Logs
• Building
• References
• License

Installation

1. Download and install RB4InstrumentMapper from the Releases page.
2. Download and set up ViGEmBus or vJoy using the guides below.
   • ViGEmBus is recommended, as it is significantly easier to use and requires no configuration. vJoy is supported as an alternative on the off-chance you run into issues with ViGEmBus.
   • Both can be installed simultaneously if desired, however RB4InstrumentMapper will only use one of them at a time.

ViGEmBus Setup

1. Download and install ViGEmBus.
2. That's all.

vJoy Setup

1. Download and install vJoy.

2. After installing, open your Start menu, find the vJoy folder, and open the Configure vJoy program inside it.

3. Configure one device for each one of your controllers, using these settings:

   • Number of Buttons: 16
   • POV Hat Switch: Continuous, POVs: 1
   • Axes: X, Y, Z

   

4. Click Apply.

5. You're all set up!

---

Using Rock Band 4 Wireless Guitars and Drums

Note that RB4InstrumentMapper is NOT required to use guitars in Fortnite!

For Riffmasters, please refer to this section.

Setup

For wireless Rock Band 4 guitars and drums, you will need an Xbox One wireless receiver. Both versions of the official one are shown here.

• This is not the same as an Xbox 360 wireless receiver! You must get an Xbox One (or just "Xbox") receiver, as shown above.
• Third-party receivers are untested, and they will not be deliberately supported.

You will also need to install WinPCap. This is used to read inputs from the Xbox One receiver.

Jaguar Guitar Firmware Update

Jaguar guitars require a firmware update in order to connect to Xbox One receivers.

• Instructions
• Clone Hero wiki re-host, in case the above link goes down again.

Usage

1. Check the Enable checkbox under the Pcap group.

   

2. Xbox One receivers should be detected under the device dropdown automatically. If they are not, click the Auto-Detect Pcap button and follow its instructions.

   • If needed, the receiver can also be selected manually. However, this is not recommended, as it is often difficult to identify the correct device to use. Xbox One receivers have either no device name (and display only the device path), or a name of MT7612US_RL (displays the device path afterwards in parentheses).

     

   • KNOWN ISSUE: On some systems, the receiver will not be picked up whatsoever. This issue is out of RB4InstrumentMapper's control, and I unfortunately don't have any clue on what the cause is. If the auto-detect process doesn't pick up anything, you're most likely afflicted by this issue.

3. Do not connect your instruments yet! They may not function correctly otherwise.

4. In the Controller Emulation Mode dropdown, select the controller emulation mode you want to use.

   

5. Hit the Start button to begin reading inputs.

6. Now you may connect your instruments. They will be picked up and read automatically until you hit Stop or close the program.

7. Map your controls in the game you'll be playing.

Having Sync Issues?

Some guitars/drumkits might not sync properly when using just the sync button. This includes the PDP drumkit and occasionally the Jaguar guitar. Follow these steps to sync your device correctly:

1. Go to Windows settings > Devices > Bluetooth & other devices
2. Click Add Bluetooth or other device and pick the Everything else option.
3. Press and hold the sync button until the Xbox button light flashes quickly.
4. Select Xbox compatible game controller from the list once it appears.
5. If that doesn't work, restart your PC and try again.

---

Using Riffmasters, Guitar Hero Live Guitars, and RB4 Wireless Legacy Adapters

Note that RB4InstrumentMapper is NOT required to use the Riffmaster in Fortnite!

Setup

You will need to install the WinUSB driver onto the Riffmaster dongle, Guitar Hero Live dongle, or Rock Band 4 wireless legacy adapter before using it. RB4InstrumentMapper is capable of doing this directly, through the Configure Devices button on its main menu:

1. Check the Enable checkbox under the USB group, then click the Configure Devices button underneath it.

   

2. Find the device you want to use on the left side of the menu.

   

3. Click the Switch Driver button and wait for it to switch the driver. The device will show up on the right side of the menu once it's done.

   

   • Note that games that natively support the device will no longer work directly with it until you uninstall the WinUSB driver, you will have to use RB4InstrumentMapper.
   • If you want to remove this limitation, you can hit the Revert Driver button on the device, after which those games will work with it again.
   • After you do this, RB4InstrumentMapper will no longer be able to make it usable in other games until you switch the driver back over.

If you run into any issues with this process, you may try installing the driver manually. This is not recommended for normal use, it should only be used if the Configure Devices menu is not working.

• This also covers uninstalling manually, in case a device gets stuck with the driver installed and RB4InstrumentMapper stops picking it up.

Usage

1. Check the Enable checkbox under the USB group.

   

2. Ensure you have installed WinUSB on the devices you want to use! They will not be recognized otherwise!

3. In the Controller Type dropdown, select the controller emulation mode you want to use.

   

4. Hit the Start button to begin reading inputs.

5. Map your controls in the game you'll be playing.

Devices will be detected automatically as they are connected/removed, though they will not be read until you hit Start.

If you are having issues with inputs not being registered or other general weirdness, try unplugging and replugging the dongle/cable. Unfortunately this backend is still finnicky, so things may not work the smoothest.

---

Mapping your Controls

Now that RB4InstrumentMapper is set up and running, map your controls for each instrument in the game you'll be playing.

Clone Hero

If you're using a guitar in ViGEmBus mode, Clone Hero will automatically map your controls. You shouldn't need to do any manual mapping, unless you're using a Guitar Hero Live guitar, in which case you may need to swap your whammy and tilt bindings.

• This automatic mapping will also apply to drumkits, however here the bindings will not be correct, as they are meant for guitars. You will need to remove the default bindings and do them manually.

For drumkits, vJoy mode, or if you otherwise need to customize your controls:

1. Press Space on the main menu.

   

2. Click Assign Controller and press a button on the device for it to be assigned.

   

3. Click the slots in the Controller column to map each of the controls.

   

4. Repeat for each connected device.

5. Click Done.

If you require further help with mapping, you can ask in the Clone Hero Discord server.

YARG

Refer to the official documentation.

GHWT: Definitive Edition

Refer to the official documentation.

RPCS3

For RPCS3, use the ViGEmBus (RPCS3 compatibility) controller mode. This will change the mappings that RB4InstrumentMapper outputs so that little to no remapping is required to use instruments in RPCS3.

Packet Logs

RB4InstrumentMapper is capable of logging packets to a file for debugging purposes. To do so, enable both the Show Packets (for debugging) and Log packets to file checkboxes, then hit Start. Packet logs get saved to a RB4InstrumentMapper > PacketLogs folder inside your Documents folder. Make sure to include it when getting help or creating an issue report for packet parsing issues.

Note that these settings are meant for debugging purposes only, leaving them enabled can reduce the performance of the program somewhat.

Error Logs

In the case that the program crashes, an error log is saved to a RB4InstrumentMapper > Logs folder inside your Documents folder. Make sure to include it when getting help or creating an issue report for the crash.

Building

To build this program, you will need:

• Visual Studio, or MSBuild/the .NET SDK + your code editor of choice.
• WiX Toolset v4 if you wish to build the installer.

References

Predecessors:

• GuitarSniffer repository
• DrumSniffer repository

Packet data:

• GuitarSniffer guitar packet logs
• GuitarSniffer guitar packet spreadsheets: New, Old
• rb4.app's Javascript source
• Original research, found in the PlasticBand documentation repository.

License

This program is licensed under the MIT license. See LICENSE for details.