Skip to main content

Drum Mapping Guide

If you run into any trouble while following these instructions, drop by #help-line in the Clone Hero Discord server with your issue/question.


Rock Band Kits

Rock Band 3's Pro Drums layout is the primary format that Clone Hero supports. Mapping Rock Band kits is fairly self-explanatory, but there are a couple specifics to look out for if you have cymbals.

This section also applies to Midi Pro Adapters and ION Drum Rockers. If you're using the MPA for an e-kit, consider using a MIDI connection and the native MIDI mapper instead, see the MIDI e-kits section. If you're set on using the MPA, continue onward.


Xbox One

Xbox One drumkits require an Xbox One wireless receiver, along with additional software.

  • On Windows you will need RB4InstrumentMapper.
  • On Linux, the xone driver has a branch for adding support for drumkits, however it is not confirmed to work. Use at your own risk, and consider assisting if you can!
  • On Mac there is currently no software written for this.

After setting up the required software, you can then map your controls in-game:

  1. Press Space on the main menu to open the control mapper. Use the Controller column on the right to configure your controls.

  2. THIS IS IMPORTANT: If any of the inputs are automatically mapped, remove them all before continuing. Specifically, remove the mappings for Green, Red, Yellow, Blue, Orange, and 2x Kick. If you don't do this, your controls will not be set up correctly!

    • If you are using RB4InstrumentMapper in ViGEmBus mode, you must unbind 2x Kick if you do not have a second pedal connected, otherwise your cymbals will activate the kick pedal as well. This is an issue with the default Xbox 360 drumkit mappings only accounting for guitars.
  3. Map the D-pad to Strum Up/Down and Left/Right, and the Start/Select buttons to Start and Select.

  4. Map the pads and cymbals to their respective inputs in the control mapper (input names are provided for reference, do not map these using the face buttons):

    MappingDrumsRB4IM (ViGEmBus)RB4IM (vJoy)
    RedRed padBButton 0
    YellowYellow padYButton 1
    BlueBlue padXButton 2
    GreenGreen padAButton 3
    OrangeKick pedalLeft BumperButton 4
    2x Kick2nd kick pedalLeft Stick ClickButton 8
    Yellow CymbalYellow cymbalYButton 5
    Blue CymbalBlue cymbalXButton 6
    Green CymbalGreen cymbalAButton 7
    • If you're using Lefty Flip, the green cymbal is reused as red cymbal. Use the cymbal plugged into the green cymbal port as red cymbal:
    MappingDrums
    Yellow CymbalYellow cymbal
    Blue CymbalBlue cymbal
    Green CymbalRed cymbal
    • Some notes for RB4InstrumentMapper in ViGEmBus mode:
      • The same-color pad and cymbal inputs should be duplicates of each other. For example, both Blue and Blue Cymbal will get mapped to X.
      • You must use the pads and cymbals on their respective inputs only. If you don't, Drum Pad Modifier and Drum Cymbal Modifier will get mapped incorrectly
      • You will need to hit relatively hard to get proper mappings, otherwise the velocity axes will get mapped instead. If you get anything other than A, B, X, or Y when mapping the pads/cymbals, try again.
  5. If you are using RB4InstrumentMapper in ViGEmBus mode, scroll down to the bottom of the list and check that the following mappings have become set automatically to the following inputs:

    MappingMapped Input
    Drum Pad ModifierRight Stick Click
    Drum Cymbal ModifierRight Shoulder
    CymExt1D-pad Up
    CymExt2D-pad Down

    If any of them are blank or mapped to something else, try mapping your pads/cymbals again. Something went wrong or you forgot to (re-)map something. You need to make sure to hit relatively hard or else it may map the wrong input.

  6. Click Done to close the control mapper.

  7. Press Start to open your profile settings, then set the Controller setting to Drums.

  8. Once all that is done, you should be good to go. If you're getting screwy inputs in-game, double-check that all inputs mentioned above are mapped correctly. If you're unsure, reset your mappings and start again from step 2.


PS4

PS4 drumkits connect via bluetooth and can be partially mapped without any additional software, but you won't be able to map both the pads and cymbals at the same time. On Windows, a program called Minatsuki fixes that issue by remapping some inputs that CH can't see to keyboard keys. Currently, no similar software exists for other platforms.

To install Minatsuki:

  1. Download and install Python.
    • Make sure to check the Add to PATH option in the installer, otherwise it will not work!
  2. Go to the Minatsuki repo and click on the green Code button in the top-right, then select Download ZIP.
  3. Extract the zip to a new folder in somewhere such as your desktop.
  4. Open that folder and any subfolders inside of it until there are no more folders to open.
  5. Shift+right-click in the empty space below all of the files and select Open command prompt here/Open PowerShell window here to open a command prompt window.
    • If you're on Windows 11 or have Windows Terminal installed on 10, you can also hit Open in Terminal.
  6. In the command prompt, type pip install -r requirements.txt to install Minatsuki's dependencies.
  7. Once that finishes, type in python main.py to start Minatsuki.

Optionally, you may create a batch script to run the last command for you instead of re-opening the command prompt and doing it yourself.

  1. Create a new text file, open it in Notepad, paste in python main.py.
  2. Go to the File tab and select Save As.
  3. Select All Files (*.*) from the Save as type dropdown.
  4. Name the file anything ending with .bat, for example, Minatsuki.bat, then hit Save.
  5. Double-click that .bat file any time you need to run Minatsuki.

Once you have Minatsuki set up, you can now map your controls:

  1. Press Space on the main menu to open the control mapper. Use the Keyboard column on the left to configure your controls, not the Controller column on the right.

  2. Map the pads and cymbals to their respective inputs in the control mapper:

    MappingDrumsKeyboard column
    RedRed padC
    YellowYellow padF
    BlueBlue padG
    GreenGreen padN
    OrangeKick pedalSpace
    Yellow CymbalYellow cymbalJ
    Blue CymbalBlue cymbalA
    Green CymbalGreen cymbalX
    • If you're using Lefty Flip, the green cymbal is reused as red cymbal. Use the cymbal plugged into the green cymbal port as red cymbal:
    MappingDrums
    Yellow CymbalYellow cymbal
    Blue CymbalBlue cymbal
    Green CymbalRed cymbal
    • If you wish to use a second pedal, you will still need to use the Controller column for that, as Minatsuki does not remap it for you.
    MappingDrumsController column
    2x Kick2nd kick pedalButton 5
  3. Click Done to close the control mapper.

  4. Press Start to open your profile settings, then set the Controller setting to Drums.

  5. Once all that is done, you should be good to go.


Xbox 360, PS3, and Wii Without Cymbals

These kits have little to no special considerations and are fairly trivial to set up.

Connection instructions:

  • Xbox 360:
    • Wired: Just plug in to your PC. (Not compatible with Mac.)
    • Wireless: Sync to an Xbox 360 wireless receiver. (Not compatible with Mac.)
  • PS2/3, Wii:
    • Wired: Just plug in to your PC.
    • Wireless: Plug in the wireless dongle and sync the kit to it.

Mapping instructions:

  1. Press Space on the main menu to open the control mapper. Use the Controller column on the right to configure your controls.

  2. THIS IS IMPORTANT: If you are using an Xbox 360 kit, you must unbind 2x Kick if you do not have a second pedal connected, otherwise your cymbals will activate the kick pedal as well. This is an issue with the default Xbox 360 drumkit mappings only accounting for guitars.

  3. Map the D-pad to Strum Up/Down and Left/Right, and the Start/Select buttons to Start and Select.

  4. Map the pads and kick to their respective inputs in the control mapper:

    MappingDrumsXbox 360PS3/Wii
    RedRed padBButton 2
    YellowYellow padYButton 3
    BlueBlue padXButton 0
    GreenGreen padAButton 1
    OrangeKick pedalLeft BumperButton 4
    2x Kick2nd kick pedalLeft Stick ClickButton 5
  5. Click Done to close the control mapper.

  6. Press Start to open your profile settings, then set the Controller setting to Drums.

  7. Once all that is done, you should be good to go.

Some notes:

  • When selecting the first song of a game session, make sure to pick Change Instruments and select Drums from the list, as the default is Pro Drums which has cymbals.
  • You can use the yellow and blue pads to scroll up and down in the menus by default. If you don't want that, you can disable Drum Pad Scrolling in Settings > General.

Xbox 360, PS3, and Wii With Cymbals

Clone Hero has some special mappings for these kits, which are automatically assigned when mapping the pads and cymbals. These kits use button combos to differentiate between pad hits and cymbal hits, so special attention is needed when mapping things here.

Connection instructions:

  • Xbox 360:
    • Wired: Just plug in to your PC. (Not compatible with Mac.)
    • Wireless: Sync to an Xbox 360 wireless receiver. (Not compatible with Mac.)
  • PS2/3, Wii:
    • Wired: Just plug in to your PC.
    • Wireless: Plug in the wireless dongle and sync the kit to it.

Mapping instructions:

  1. Press Space on the main menu to open the control mapper. Use the Controller column on the right to configure your controls.

  2. THIS IS IMPORTANT: If any of the inputs are automatically mapped, remove them all before continuing. Specifically, remove the mappings for Green, Red, Yellow, Blue, Orange, and 2x Kick. If you don't do this, your controls will not be set up correctly!

    • If you are using an Xbox 360 kit, you must unbind 2x Kick if you do not have a second pedal connected, otherwise your cymbals will activate the kick pedal as well. This is an issue with the default Xbox 360 drumkit mappings only accounting for guitars.
  3. Map the D-pad to Strum Up/Down and Left/Right, and the Start/Select buttons to Start and Select.

  4. Map the pads and cymbals to their respective inputs in the control mapper (input names are provided for reference, do not map these using the face buttons):

    MappingDrumsXbox 360PS3/Wii
    RedRed padBButton 2
    YellowYellow padYButton 3
    BlueBlue padXButton 0
    GreenGreen padAButton 1
    OrangeKick pedalLeft BumperButton 4
    2x Kick2nd kick pedalLeft Stick ClickButton 5
    Yellow CymbalYellow cymbalYButton 3
    Blue CymbalBlue cymbalXButton 0
    Green CymbalGreen cymbalAButton 1
    • If you're using Lefty Flip, the green cymbal is reused as red cymbal. Use the cymbal plugged into the green cymbal port as red cymbal:
    MappingDrums
    Yellow CymbalYellow cymbal
    Blue CymbalBlue cymbal
    Green CymbalRed cymbal
    • Some notes:
      • The same-color pad and cymbal inputs should be duplicates of each other. For example, if Blue maps as button 3, Blue Cymbal should map as button 3.
      • You must use the pads and cymbals on their respective inputs only. If you don't, Drum Pad Modifier and Drum Cymbal Modifier will get mapped incorrectly
      • On Xbox 360 kits, you will need to hit relatively hard to get proper mappings, otherwise the velocity axes will get mapped instead. If you get anything other than A, B, X, or Y when mapping the pads/cymbals, try again.
  5. Scroll down to the bottom of the list and check that the following mappings have become set automatically to the following inputs:

    MappingXbox 360PS3/Wii
    Drum Pad ModifierRight Stick ClickButton 10
    Drum Cymbal ModifierRight ShoulderButton 11
    CymExt1D-pad UpPoV Hat Up
    CymExt2D-pad DownPoV Hat Down

    If any of them are blank or mapped to something else, try mapping your pads/cymbals again. Something went wrong or you forgot to (re-)map something. With Xbox 360 kits, you need to make sure to hit hard or else it may map an axis instead of a button.

  6. Click Done to close the control mapper.

  7. Press Start to open your profile settings, then set the Controller setting to Drums.

  8. Once all that is done, you should be good to go. If you're getting screwy inputs in-game, double-check that all inputs mentioned above are mapped correctly. If you're unsure, reset your mappings and start again from step 2.

Some notes:

  • By default, you can use the yellow and blue pads to scroll up and down in the menus. This can be disabled by toggling Drum Pad Scrolling in Settings > General.
  • There is no way to toggle individual cymbals on or off for Pro Drums. If you only have two cymbals, you may select 5 Lane Drums in your profile's Controller setting as a workaround. It moves blue cymbal to green cymbal and yellow tom to blue tom to make 4-lane Pro charts playable on 5-lane kits, which means you'll be able to use your cymbals at the expense of not using one of the pads.

Guitar Hero Kits

Clone Hero doesn't support a visual 5-lane layout, and there are no plans to add it in the future. However, 5-lane charts are still supported by the game: it auto-converts them to 4-lane Pro. It can also auto-convert 4-lane Pro charts to be playable on a 5-lane kit. Since these auto-conversions use specific notes, GH kits need to be mapped in a specific way to be used as intended.

Connection instructions:

  • Xbox 360: Sync to an Xbox 360 wireless receiver.
  • PS2/3: Plug in the wireless dongle and sync the kit to it.
  • Wii:
    • To use wired, use a Raphnet adapter.
      • Note that no other adapters currently support Guitar Hero drumkits.
    • To use wirelessly:
      • Windows: Use WiitarThing
      • Mac: Only currently known method is using OSCulator. Not particularly recommended, as it is a paid program, and pairing Wiimotes doesn't seem to be possible on macOS 12 Monterey or onward currently.
      • Linux: Natively supported, just sync the Wiimote via Bluetooth. Make sure to hit Assign Controller in the control mapper to assign the correct device.

Mapping instructions:

  1. Press Space on the main menu to open the control mapper. Use the Controller column on the right to configure your controls.

  2. If any of the inputs are automatically mapped, remove them all before continuing, otherwise your controls might not work correctly.

  3. Map the D-pad (or analog stick on Wii drums) to Strum Up/Down and Left/Right, and the Start/Select buttons (or +/- on Wii drums) to Start and Select.

  4. Map the pads and cymbals according to this list:

    MappingDrumsXbox 360/WiitarThingPS3Raphnet
    RedRed padBButton 2Button 1
    BlueBlue padXButton 0Button 3
    GreenGreen padAButton 1Button 0
    Yellow CymbalYellow cymbalYButton 3Button 2
    Green CymbalOrange cymbalRight BumperButton 5Button 4
    OrangeKick pedalLeft BumperButton 4Button 5
    • If you're using Lefty Flip, map yellow cymbal to green cymbal (which will become red cymbal in-game), and orange cymbal to blue cymbal:
    MappingDrums
    Green CymbalYellow cymbal
    Blue CymbalOrange cymbal
  5. Click Done to close the control mapper.

  6. Press Start to open your profile settings, then set the Controller setting to 5 Lane Drums. This will convert 4-lane pro charts to work with 5-lane kits. Again, there is no visual 5-lane layout, you will still have only 4 lanes.

  7. Once all that is done, you should be good to go.

Some notes:

  • Be sure to check the Chart Auto-Conversions section of this guide further down if you want to know how CH handles 5-lane charts, and what the 5 Lane Drums controller type does.
  • By default, anything mapped to Yellow and Blue will scroll up and down in the menus. This can be disabled by toggling Drum Pad Scrolling in Settings > General. (This does not apply to Yellow Cymbal and Blue Cymbal currently, which means that if you followed this guide, the only pad that will do navigation is blue, which will scroll down. You will have to use the proper navigation buttons on the kit for scrolling up.)

MIDI E-kits

Clone Hero has a built-in MIDI mapper for e-kits (or any other MIDI device, if you're brave enough to use something like a MIDI keyboard as drums). It supports multiple MIDI notes per mapping, and individual MIDI note velocity thresholds.

If you're using a Rock Band Midi Pro Adapter for your e-kit, consider using it through a direct MIDI connection instead, either through the USB-B port on your kit if it has one, or a MIDI-to-USB cable. If you must the MPA, follow the Rock Band Kits section instead.

Connection instructions:

  • Connect your e-kit with either a USB-B-to-USB-A (printer) cable, or a MIDI cable connected to the MIDI Out port of the kit, depending on what's available and which your preference is.
  • If you are on Windows, make sure all other software that can use MIDI inputs are closed to ensure that your e-kit isn't being blocked by other software. If you need to use it with multiple programs at once, you can use MIDI loopback software such as loopMIDI.
  1. Use your keyboard or a controller and press the key/button mapped to Start to open your profile settings, then set the Controller setting to Drums.

  2. Still in your profile, go into MIDI Settings and select your drums in the Input Device option. (You'll see <None> at first, this just means no device is selected. Use Up/Down to change the setting once you see <None>, then when you see your kit, press Green to select it.)

  3. Go into Quick Setup and follow the instructions given.

    MappingDrums
    Red PadSnare
    Yellow PadHigh tom
    Blue PadMiddle tom
    Green PadLow tom
    Orange PadKick
    Yellow CymbalHi-hat cymbal
    Blue CymbalRide cymbal
    Green CymbalCrash cymbal
    • If you're using Lefty Flip, you should instead map them like this:
    MappingDrums
    Red PadLow tom
    Yellow PadMiddle tom
    Blue PadHigh tom
    Green PadSnare
    Orange PadKick
    Yellow CymbalRide cymbal
    Blue CymbalHi-hat cymbal
    Green CymbalCrash cymbal

    Green Cymbal is re-used as red cymbal on Lefty Flip.

  4. If applicable, make sure to enter Mappings and map any additional hit zones on your pads/cymbals, and also make sure that both the open and closed hi-hat inputs are mapped to Yellow Cymbal.

  5. Optionally, you may map an additional pad or cymbal to Start or Select in the Mappings menu of your MIDI settings. If you can't do this or choose not to, you should have a controller or keyboard on standby so you can pause.

You can continue to use the keyboard or a controller to navigate the menus, but Clone Hero by default will allow you to use the yellow and blue pads to scroll up and down by default. This can be disabled by toggling Drum Pad Scrolling in Settings > General.

If you wish to use a controller for menu navigation, here are some suggested mappings:

MappingController
Strum UpD-pad Up/Left Stick Up
Strum DownD-pad Down/Left Stick Down
LeftD-pad Left/Left Stick Left
RightD-pad Right/Left Stick Right
MappingXboxPlayStationNintendo
GreenA×A
RedBB
YellowYΔX
BlueXY
OrangeLBL1L

Chart Auto-Conversions

This isn't quite related to the overall topic of this guide, but it's still important to know to clear some confusion.

5-lane drum charts get automatically converted to 4-lane Pro in CH, regardless of your drum kit type:

5-lane ChartConversion
RedRed
YellowYellow cymbal
BlueBlue tom
OrangeGreen cymbal
GreenGreen tom
Orange + GreenG cym + B tom

This conversion also gets converted again down to standard 4-lane if you're not using Pro Drums.

Additionally, the 5 Lane Drums controller type in your profile converts 4-lane Pro charts to be entirely playable on a 5-lane kit:

4-lane ProConversion
RedRed
Yellow cymbalYellow cymbal
Yellow tomBlue tom
Blue cymbalGreen cymbal
Blue tomBlue tom
Green cymbalGreen cymbal
Green tomGreen tom
Y tom + B tomR + B tom
B cym + G cymY cym + G cym