Installation
============
Please see the provided document: Installing and Registering FSUIPC7.pdf


Usage Instructions
==================
FSUIPC7 as now a standalone executable, and no longer an embedded dll.
Simply run the FSUIPC7.exe to start.
Alternativly, if you opted to install the auto-start component (installed by default),
FSUIPC7 will automatically be started by MSFS during start-up.
It is recommended to use the auto-start method, but not required.

FSUIPC7 will then sit in the system tray (by default). To open, double-click the tray icon or
use the provided context menu. FSUIPC7 will start with the main window visible only when the
'Auto-Connect to FS' option is disabled.

A default windows hot key (Alt-F) is also acquired when you start FSUIPC7
which will display/open the FSUIPC7 main window. If this hot key cannot be acquired
(e.g. as its already in use) then a message will be logged. You can change the key
assigned by manually editing the following ini parameter:

InvokeFSUIPCOptionsKey=70,12

where, in the above example, 70 is the F key (0x46) and 12 is the modifier (which is
actually a hex value, 0x12 which is VK_MENU, i.e. the Alt key).

For no hot key, use

    InvokeFSUIPCOptionsKey=No


Missing Functionality
=====================
The following functionality, available in previous versions, is not currently available in FSUIPC7 as
the facilites to implement them are not provided by the MSFS SDK:

1. Mouse Macros (and other mouse functionality, e.g “mouse look”, etc. MSFS uses HVARS (HTML variables) and Input Events instead of mouse macros.
2. Text/menu display facilities: the Simconnect functions for text and menu display have been depracated and are no longer available.
   For now, you can use the lua Wnd library to display text in a separate window.
3. Weather: apart from a few variables concerning ambient conditions at the aircraft, no other weather information
   is available for reading or updating. It is not expected that MSFS will implement such facilities, and even if they
   do they will be radically different, and so no futher weather control will be provided by FSUIPC7.
4. Assignments to Xbox One and Xbox 360 game controllers only take effect when FSUIPC7 has the window focus.
   However, there is a work-around for this using a conversion utility called XInput Plus - see below.


Limitations
===========
Quite a few events/controls that are available in MSFS are not available (or are provided but have
no effect/don't work) for use by 3rd party applications via the provided SDKs. These include:
   - events for view control
   - events for slew control
   - events for weather

For view and slew control, you can assign in MSFS or assign in FSUIPC7 but to the default key assignments
used for view/slew control in MSFS.

Text/message/menu display facilities: do not work due to issues with SimConnect_Text API function, which has been deprecated.
It is recommended to switch to using the lua Wnd library for textual display, but menu selection is not supported.

Keyboard input is not masked, and so any key assigned in FSUIPC (via any mechanism) will also be seen by the sim.

XINPUT devices, such as the XBox One and XBox 360 controllers do not work natively with FSUIPC7.
If you want to use FSUIPC7 with such devices, you will need to install and configure a conversion utility called XInput Plus.
Please see the following tutorial:
    https://www.play-old-pc-games.com/compatibility-tools/xinput-plus-tutorial/
You can download from here: https://community.pcgamingwiki.com/files/file/2265-xinput-plus-v415290/
Also note that you need to point this utility to the FSUIPC7.exe, not the MSFS.exe.
   
   
Problems installing or registering FSUIPC7
==========================================
If you have problems installing or registering FSUIPC7, then this
can be caused by one of the following issues:

1. If the installer won't run, this is normally because anti-virus
   software has blocked it. This is a known issue with some anti-virus software
   (e.g. Norton). Right-click the installer and check the files Properities to make
   sure that it has not been blocked from running. 

2. You have entered your registration details incorrectly. Please copy and paste the details from your
   purchase email or SimMarket account.

3. You do not have the required VC++ redistributables installed. Please download and install
   the latest combined (ie. 2015, 2017, 2019 & 2022) redistributable packages, both x64 and x86, from
      https://docs.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist

4. Anti-virus software is preventing the license validation. Check your anti-virus reports and
   either add an exception to allow the installer to run or temprarily disable while installing.

5. If, when running the installer, you are prompted for a password for a user with Admin privileges, then please cancel and do not install as doing so will
   install certain items (e.g. documents) in the wrong place. If you have already installed this way, please uninstall using the created uninstaller (or via
   the windows App management panel).
   This situation occurs when the user account installing FSUIPC7 doesn't have admin privileges, which Windows automatically requests when running the
   installer (even though these are not needed by the installer). The correct way to install in such circumstances is to temporarily grant admin privileges
   to the user account under which you wish to install FSUIPC7. Once you have installed, you can remove this elevated privilege.

6. If, when running the installer, you see the error message "invalid opcode", then this
   is due to the installer not being able to get full Admin privileges, which
   are needed by the installer. To resolve this issue, you need grant the
   user account that you are using for the install full Admin rights.
   Please consult google (or other search engine) to find out how to do this.

For further details and issues, please see the provided documentation : Installing and Registering FSUIPC7


Problems running FSUIPC7
========================
1. If you receive the following error when running FSUIPC7:
        The code execution cannot proceed because VCRUNTIME140_1.dll was not found. Reinstalling the program may fix this problem.
   then you need to uninstall the 2015, 2017, 2019 & 2022 VC++ redistributables from the Windows App management panel (any/all that are installed),
   and then install the latest combined redistributable packages (both the x86 and x64 versions recommended, although FSUIPC7 only requires the x64 version)
   from here:
		https://docs.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist

2. If you receive a pop-up System Error from MSFS when auto-starting FSUIPC7, or when startung FSUIPC7 manually, please try the steps outlined in 1 above
   (i.e. re-install your VC++ redistributables).

3. FSUIPC7 does not auto-start with MSFS, even though this option was selected during installation.
   If you find that FSUIPC7 doesn't start with MSFS, this is usually due to a problem with your EXE.xml file. Please check your InstallFSUIPC7.log file.
   This is usually due to another add-on corrupting the EXE.xml file. To resolve, you can delete/rename your current EXE.xml file (whose location can be
   determined from your InstallFSUIPC7.log file) and re-install FSUIPC7. However, the add-on that corrupted the EXE.xml may not be started automatically.
   You will need to manually add this back if you want this app to also auto-start.
   Please see the following FAQ entry for further details on this as well as other possible causes:
       https://forum.simflight.com/topic/95918-fsuipc7-auto-start-with-msfs2020/
   I will NOT RESPOND to further support requests regarding this issue - I will reference this FAQ entry and close/lock the topic.
   If you must post, please use that topic referenced and NOT create a new support request for this issue.

4. There is a known issue that can cause the FSUIPC WASM module to crash. This has been reported to occur when
   using a complex add-on aircraft (e.g. the Fenix A320/A321, PMDG 737 or 777, etc) as well as complex add-on
   scenery. If you find that presets are not working, or lvars are not being updated, then you could be
   experiencing this issue. See the following FAQ entry on how ro confirm this and what to do to prevent:
       https://forum.simflight.com/topic/98821-msfs-fsuipc7-wasm-crash-and-how-to-prevent-presets-stop-working-lvars-stop-updating-etc/
		
		
Documentation
=============
Documentation is provided and installed by the installer. Note that the documentation will be installed under your
Windows Documents folder, in an FSUIPC7 sub-folder.


Feedback
========
The FSUIPC support forums (as well as further information) can be found at the following location: 
        https://fsuipc.com/support/
		
Note that you need to register on the forums for support. Registration details from the old forums
(previously at https://forum.simflight.com/forum/30-fsuipc-support-pete-dowson-modules/) or from your SimMarket account are not valid.

For support, please provide all relevant information and attach the relevant files/logs. For installation issues, this will be
your InstallFSUIPC7.log file, and for other issues your FSUIPC7.log file and FSUIPC7.ini file.
Before posting, please check the forum to see if your issue/problem has already been reported, as you may find a
solution there.


John Dowson, 30th October 2025