Create definition file

Not every combination of VKB modules has a pre-made definition file available. To enable support for LED outputs and friendly names in such a configuration, it is necessary to create a new definition file.

To help with the creation of such files, the VKB/MobiFlight Definer tool can build a file for the default configuration of most controller combinations. Download, extract and run the latest release, then follow the on-screen prompts.

To create the definition file for a device, first select the USB device in question. Continue by choosing the base (which may include some grips and modules to streamline the process, depending on the hardware). When selecting different add-on controllers, it is generally recommended to adhere to the following order to get good defaults for button and LED numbers:

Module	Notes
Base	Including modules listed in the base description.
Grips	Starting from left to right for throttle grips. Not including the WW2 throttle grip, which is part of its associated THQ.
SEMs	Including both standard SEM and vertical SEM-V units.
THQs	Including both standard THQ and vertical THQ-V modules. If one of the THQs has a WW2 throttle grip, choose that one last.
STEM	Only one module per device.
FSM.GA

It is best to verify button numbers in a button tester application.

Once the program has completed, a file ending in .joystick.json will be available in the output folder. Copy this file to the Joysticks folder in your MobiFlight installation directory, e.g. %LOCALAPPDATA%\MobiFlight\MobiFlight Connector\Joysticks.

If you are running a heavily customized VKBDevCfg configuration, it may be necessary to make manual adjustments to the file to ensure button labels are accurate.