Installation
============
Please see the provided document: Installing and Registering FSUIPC7.pdf.
Please also not that you should NOT run the installer with Admin / elevated privileges,
but the Windoiws account used for installation must be an Administrator account, so that
the installer can request elevated privileges.
When you double-click the installer to run it, it will request the privileges needed.


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, either double-click the tray icon,
use the provided context menu (on right-click) or use the provided hot-key Alt+F (see below).
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 provided / acquired to 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

Please see the FSUIPC7 User guide for further details and on how to use FSUIPC7.

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 for details.


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 Properties 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 exactlry as provided. It seems that some people have issues with
   copy/pasting the key exactly as written:the key is 12 characters. If you double-click to select, all
   12 characters of the key may not be selected so beware.

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.

7. You ran the installer with elevated / Admin privileges. The installer will request required privileges - there is no need to run it with
   Administrator privileges. Simply double click the installer to run it. 

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

Please also note that you cannot drag/copy the FSUIPC7.exe to your Desktop and use it from there. If you want a
specific Desktop icon to start FSUIPC7, then create a shortcut of the FSUIPC7.exe in the FSUIPC7 installation
folder, then drag this to your Desktop and then rename it. However, it is better to have FSUIPC7 auto-started
by MSFS, which is the default installation configuration.


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://fsuipc.com/community/fsuipc-faq-issues/msfs-fsuipc7-auto-start-with-msfs2020-2024/
   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.
		
		
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
(no longer available) or from your SimMarket account are not valid.

Support is also available via Discord. Please use the following invitation link: https://discord.gg/zjwUTrxmmE

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, March 2026