Skip to main content

Instration

This section covers the steps for installing fsmapper.

info

fsmapper is released as open-source under the Apache-2.0 License, allowing free usage, including modifications to the source code.
For instructions on building and installing from the source code, please refer here.

Download zip package​

You can download the latest version (v1.4.0) of the installation package from here. If you want to download a previous version, please access it here.
Once you have downloaded the installation package (zip file), extract it to your preferred folder.

The file structure after extraction will look like the following.

fsmapper_x.x.x
├── fsmapper
│   ├── samples
│   │   └── sample script files are here
│   ├── sdk
│   │   └── plugin SDK files are here
│   ├── fsmapper.exe
│   └── supplementary files such as DLLs
└── README.txt

Copy fsmapper folder​

Copy the fsmapper folder directly from the package to the location where you want to install fsmapper. fsmapper can be launched from any folder it's placed in.

Additional Softwares​

While not mandatory for running fsmapper, it's highly recommended to additionally install the following two pieces of software. fsmapper provides users with more convenient features by integrating with these softwares. Throughout this documentation, starting from the Tutorial, numerous script examples assume that these softwares are installed.

  • vJoy (Download)
    vJoy is a device driver that functions as a virtual joystick. fsmapper offers multiple functions to alter button status, axis positions, and POV settings of the vJoy device.
    Through the use of the vJoy device, fsmapper provides highly flexible configurability for human interface devices.

  • MobiFlight WASM Module (GitHub)
    This WASM module, functioning as an add-on for Microsoft Flight Simulator 2020, enables an external-process utility to execute arbitrary RPN script and monitor changes in the aircraft's internal state stored in local variables like LVARs. fsmapper gains unrestricted access to retrieve and modify aircraft states by communicating with the MobiFlight WASM Module operating within the MSFS process.
    The easiest way to install the MobiFlight WASM Module is by downloading and installing the MobiFlight Connector from here.

info

The vanilla fsmapper communicates with Microsoft Flight Simurator 2020 through the SimConnect API, which allows an external process to access only SimVars and Event IDs. However, this access isn't sufficient to control all operable objects in a cockpit or retrieve all gauge statuses to display on another DIY gauge or virtual instrument panel.
To control and access all cockpit gauges, accessing local variables within an aircraft module is necessary, and the Gauge API serves this purpose. Regrettably, this API can only be used within the WASM module.
The MobiFlight WASM Module addresses this limitation, enabling fsmapper to access all local variables by communicating with this WASM module.