How to Flash/Reset/Calibrate your Gunfighter

To get started, go to our Downloads page and follow these steps:

  1. Download VKBdevCfg and extract it to any folder you like.
  2. Optionally, download ZBootloader and extract it into the same folder as above (only needed when updating firmware).
  3. Optionally, download VKB Device Firmware and extract the firmware (*.vkb) for your Gunfighter with matching grip, e.g., _BlackBox_GF_<grip>_<version>.vkb, where <grip> = KG (KG12), MCG, MCG PRO, or SCG (Kosmosima) respectively, and put it into the same folder as above (only needed when updating firmware).
  4. If you have created a custom profile (i.e., different, or custom button assignment) be sure to save it first via VKBdevCfg > Action > Save
  5. When installing a new grip, ensure that your new grip is installed on the Gunfighter base, and that it’s seated correctly.
From here on out, there are three basic steps involved in the overall process:
  • Flash your Gunfighter’s BlackBox with the new firmware (only needed when installing a new grip, or improved firmware was made available by VKB HQ).
  • Reset your Gunfighter to default (only needed after updating firmware).
  • Calibrate your Gunfighter (always needed with a brand new out-of-the box joystick, or after updating its firmware).
I. Flash your Gunfighter’s BlackBox firmware (only needed when installing a new grip, or an improved firmware was made available by VKB HQ):
Q: Why do I have to flash when installing a new grip?
A: You will have to flash your your joystick base to make any new grip work with it. Simply removing your current grip and installing your new grip will not magically make the base understand what just happened; you need to tell the base (via firmware update) that there’s a new grip installed!
  1. Launch VKBdevCfg (highly recommended to right-click on the VKBdevCfg app and select ‘Run as Administrator’)..
  2. In the top panel, click on the “VKBsim Gunfighter…” name to select it.
  3. From the Tools tab, click on the “Bootloader” icon; this should close VKBdevCfg and automatically start ZBootloader (if you have it in the same folder).
  4. Point ZBootloader to the extracted *.vkb file and update the firmware of your BlackBox by clicking “Flash It”.
  5. The device will restart with the new firmware installed.
II. After Flashing, you need to Reset your Gunfighter’s BlackBox to default (only needed after updating firmware):
  1. Launch VKBdevCfg-C (highly recommended to right-click on the VKBdevCfg app and select ‘Run as Administrator’)..
  2. In the top panel, click on the “VKBsim Gunfighter…” name to select it.
  3. From the Tools tab, click on the “Default” button in the top-left corner.
  4. The device will restart with factory default settings; any previously red blinking ‘Stick LED’ on the the BlackBox should turn solid green.
III. After resetting, you need to Calibrate your Gunfighter :

The goal is to be able to capture all available axes in the calibration procedure: the Gunfighter’s pitch and roll axes, as well as the ministicks, trigger and brake axes for the MCG/MCG PRO; other grips, such as KG12 and Kosmosima, don’t require specific instructions for calibration. 

Don’t use the MS Windows calibration utility! If you already did, you will have to first reset your joystick using the same MS calibration tool; once done, continue with the steps below (using VKBdevCfg instead).
  1. Flip the foldable trigger to the “up” position, and then squeeze the trigger fully, and then let go of it to determine its middle position (MCG PRO only).
  2. Launch VKBdevCfg (highly recommended to right-click on the VKBdevCfg app and select ‘Run as Administrator’)..
  3. In the top panel, click on the “VKBsim Gunfighter Modern Combat” name to select it.
  4. From the Tools tab, click the ‘Start Calibr’ button; the SYS LED on the Blackbox starts blinking (switch to the Test > Axes1 tab to observe your calibration action).
  5. Move the stick through its full range (pitch and roll axes).
  6. Move the MASTER MODE (РЕЖИМ КБО) ministick through its full range (you might have to do a long-press on the ministick push button in order to enable relative axis mode first; otherwise the ministick defaults to button mode and thus won’t calibrate).
  7. Move the GATE CONT (УПРАВ СТРОБ) ministick through its full range.
  8. Squeeze the BRAKE lever fully and let go of it.
  9. Move the foldable trigger to the “up” position, squeeze it, and then let go of it – this moves it through its full range (MCG PRO only).
  10. If you have VKB T-Rudders connected to the Gunfighter’s BlackBox, move rudder axis through its full range as well..
  11. Click the ‘End Calibr’ button; the BlackBox will restart.
  12. Done; calibration information is stored within the Gunfighter’s BlackBox.
Reminder: Don’t forget to load your custom profile again via VKBdevCfg > Action > Load and then Set.