INSTALL IVAP

How to install IvAp in Prepar3D version 4.x

Revision 29 – 1401-2019 (Section 12 reworked)

Before starting the IvAp v2 installation a thorough knowledge of Windows File Explorer is indispensable.

This webpage concerns the installation of IvAp v2 with the purpose to fly on the IVAO-network (IVAN) and to be able to recognize other VA-aircraft.
This page is devided in sections.

Section 1 – Files you need

  1. File #1:: FSUIPC5.dll
    (Download FSUIPC5.x from this site  | non-licensed works |)
  2. File #2:: SimConnect.msi {C67A3A1B-F52B-42CC-85E8-231428A09312} >> this file is in your P3Dv4 folder disk:\P3D4\redist\Interface\FSX-SP2-XPACK\retail\lib\
  3. File #3:: the usual file from IVAO >> ivap-v2.0.2-b2773.exe
  4. File #4:: a recent IVAO_MTL download.
  5. File #5:: MTLTest-Full-0.1.7z  See section 5
  6. File #6:: add-on.xml in case you want to place the IVAO_MTL in a non-default location.
  7. You need the program Notepad++ to create or change text files

Section 2 – Do’s and Don’t ‘s

  1. Do not install Prepar3D in the root of any disk, but always in a folder named e.g. P3D4 or any other name. 
  2. Do not install IvAp inside the folder disk:\P3D4\ …
  3. Do not install IvAp in the folder C:\Program Files (x86) \ …
  4. When asked to run an executable using Prepar3D… always Run as administrator.
  5. Now first write down your situation (disk\folder\):
    1. You have installed Prepar3D version 4 in a folder called: _____
    2. This folder is on disk: _____

Section 3 – Installation files

3.1 Install File #1::
check before the installation procedure 
if a previous installation of version FSUIPC5.x is already present in the … /Modules folder, 
then you can skip this step, 
else install File #1 (FSUIPC5  – non licensed works).

3.2 Install File #2::
Locate the file SimConnect.msi
Right mouse on the filename and install as administrator.

3.3 Creating a dummy fsx.exe: since IvAp v2 was created for FSX and natively does not support Prepar3D, we have to create a workaround:
Create a copy of the file Prepar3D.exe (this file is in the root of your P3D4 installation folder) and Paste into the same place (the root of your P3D4 installation folder), then… Rename this copy to fsx.exe and leave it where it is.

3.4 Install File #3::
Right mouse click the file ivap-v2.0.2-b2773.exe and install as usual and (of course) as administrator in the root of your P3D4 installation _disk e.g. F:/IvAp_v2
(This folder IvAp v2 is created by the installation of IvAp, so do not create this folder manually; just install in the root of your P3D4 installation disk )

Again: do not install IvAp inside  … \Program Files  (x86)\ …
Again: do not install IvAp inside … \P3D4\ …

We have seen in our comments that some users are still persistent in installing Prepar3D in Program Files…those users MUST execute step 4.1 as well and then in step 4.2 select the location of your P3D installation in (thus) ../Program Files

Section 4 Installation of IVAP

4.1 During the installation you will be asked to browse to the location where you created a copy of Prepar3D.exe named as fsx.exe. See again section 3.3

4.2 Which Flight Simulator version should be used for this installation?
Check box Flight Simulator X and select browse to find the location where you created a copy of the Prepar3D.exe which was renamed as fsx.exe. See again step 3.3. When ready you should see this picture:

4.3 Then you will be asked where the IvAp virtual Pilot client should be installed. Make you life easy and pick a root as high as possible.. so no destination as disk:/folder/folder/folder/folder ….

4.4 The result of your actions are visible in the picture below. What you will recognize is the version numer of Microsoft Flight Simulator X with the properties of the prepar3d.exe… and of course: YOU created the copy!
Press Install.

4.5 Installing TeamSpeak with IvAp v2:: during the install procedure of IvAp v2 you will pass a screen wether to install TeamSpeak2 yes or no.
You may want to skip the TeamSpeak2 process when this is already installed. It is mandatory to install TeamSpeak2 inside IvAp v2, so do not skip installing TS2, else automatic communication with ATC will fail. If there is any previous installed TS2, uninstall the program first.
After installation of TS2 by IvAp, replace the client executable (!)
Read our TeamSpeak page.

Section 5 – Download IVAO P3D4-Models Only

5.1 HERE STARTS THE BETA  MTL PROCEDURE ….ONLY VALID FOR P3D4.x+
In the mean time download this file from
http://mtl.ivao.aero/mtl_test/MTLTest-Full-0.1.7z 
5.2 Unzip the file.
You will create D:\Downloads\MTLTest-Full-0.1\IVAO_MTL\; this additional IVAO_MTL folder contains 368 folders with models only.
5.3 When the installation process of IvAp v2 is completed, then overwrite your IVAO_MTL (in Simobjects\IVAO_MTL\) with D:\Downloads\MTLTest-Full-0.1\IVAO_MTL\
The folder only contains models for P3D4+ and the purpose is to overwrite the initial IVAO_MTL download with the latest textures and correcting the model files.
5.4 Say YES to overwrite and DONE!
:: Any complaints? Refer to this webpage:
If you are a IVAO member, please report any issues with this BETA version with http://forum.ivao.aero/index.php?topic=316799.0
Note: http://forum.ivao.aero/index.php?topic=317836.0 :: in this topic another link is mentioned that will bring you a MTLQuickInstallerP3Dv4-1.0.exe. This file is generating a blank popup.
HERE STOPS THE BETA MTL PROCEDURE

Section 6 – Download current MTL

6.1 Download file #4: (read 6.2 and 6.3 before executing 6.4).
Complete the MTL process by mandatory selecting FULL INSTALL (recommended);

6.2 Pressing FULL INSTALL and then the Download button will give you ALL models to download … let it go and don’t interrupt … else pressing the Downlod button only will fill the folder with only the default models.
A folder \IVAO_MTL in … \Simobjects\ is created by the download itself. But take care:

6.3 If you have already a current installation of IVAO_MTL-folder in Airplanes, zip this folder and then delete the folder IVAO_MTL. The zip remains in …\Airplanes for later use ot to be deleted.

6.4 Now go to mtl.exe and run as administrator. (The mtl.exe is in the root of your current IvAp v2 installation folder). The download will start.

6.5 When the download is completed, check the IVAO_MTL folder in …\Simobjects\IVAO_MTL .What you get is the latest version with all VA’s which version with the latest textures.
However you should overwrite the models for P3D4+
These models exists in file #5

Section 7 – Reindex process

7.1 The MTL index process: after a new download whereby the IVAO_MTL folder is placed in …\SimObjects, the index process will start automaticly.
7.2 Don’t forget that after any manual change in this folder IVAO_MTL, you need always to reindex the database. How?
7.3 Open ivap_config.exe in the root of your IvAp v2 installation folder and run as administrator.
7.4 There select Online Traffic and check Show Online Traffic.
7.5 Press the button Reindex MTL … Wait until completed (you will see a DOS screen runing)  and close with OK.
7.6 Remember that you only can reindex the database when the IVAO_MTL folder is in …\SimObjects\

7.7 NOW overwrite the contents of this IVAO_MTL with the Ivao P3D4-Models Only as explained in Section 5 and re-index again.

7.7 Read more later in Section 12 how to configure IvAP.

Section 8 – Activating IVAO_MTL (normal)

Adding the IVAO_MTL entry in simobjects.cfg
8.1 Open the file  simobjects.cfg in C:\ProgramData\Lockheed Martin\Prepar3D v4\
8.2 Add this text:
[Entry.xx] << mind the xx number sequence!
Title=IVAO MTL
Path=SimObjects\IVAO_MTL
Required=True
Active=True
Save the file and check the name of the folder in … \SimObjects\
8.3 If you don’t want to place the IVAO_MTL folders elswhere OR does not want to activate/deactivate the IVAO_MTL with an add-on.xml…you’re DONE!
Skip the next sections and go to section: Now start the sim.

Section 9 Moving IVAO_MTL folder

9.1 Read first:
you can only re-index the mtl database in the conventional way when the IVAO_MTL-folder is in …/SimObjects. However you can move this MTL-folder to any disk or folder and keep the re-index feature alive. Continue reading. Reasons for moving? Disk volume capacity (current MTL = ~8,5 GB), Loading speed of P3D (will savwe you 2 min.)
9.2 Steps to be taken:
Create a symbolic link for the IVAO_MTL folder… read on.

9.3 Placing IVAO_MTL into another folder and creating a symbolic link.

For whatever reason you could move the IVAO_MTL folder into another Disk and/or Folder. However, without the possibility to reindex the database in the conventional way.

You have 2 options:
(1) Activating the IVAO_MTL through simobjects.cfg
(2) Activating the IVAO_MTL with an add-on.xml
In both options the reindex feature in IvAp MUST see the location where the folder IVAO_MTL is located. Therefore you must create a symbolic link from the <generic source location> to <the new destination location>.
Before we explain both options, first we wil create the symbolic link and move the IVAO_MTL folder to your chosen location.
There we go and execute your actions by the words…because it’s critical.

9.4 Cut the folder ..\IVAO_MTL from …\SimObjects and paste into e.g. F:\IVAO_MTL (write down your own location). Check that it’s gone!

9.5 Press Windows 10 Start button and type CMD and select Command Promp with right mouse  to Run as administrator.

9.6 A DOS box will open with C:\Windows\System32> and execute the next typing word by word!
Type mklink
Type space (hit the space bar)
Type /j and a space (so…type forward slash letter j followed by a space)
Type a double quote (this is ” )
9.7 Now type the generic source location of the IVAO_MTL folder; this is your p3d installation path of …\SimObjects\IVAO_MTL
Type a double quote the a space and again a double quote
9.8 Now type the new location of your IVAO_MTL folder: e.g as in the sample above F:\IVAO_MTL
Check the paths !! Ready? ENTER
9.9 A DOS message will tell you that a junction was created from/to
In this dos box sample you can recognize the mklink /j and the generic source path followed by the new destination path; both paths are between double quotes and separated by a space; after the ENTER command, the message Junction created appears. If you get something else … check your typo’s.

9.10 Now we have “linked” the IVAO_MTL and you must decide wether to create option 1 or option 2

Section 10 – Activating MTL by simobjects.cfg

10.1 Open C:\ProgramData\Lockheed Martin\Prepar3D v4 and open simobjects.cfg
10.2 Create a new entry [Entry.10] << mind the numbering!
[Entry.xx]
PATH= type here your new destination path ….\IVAO_MTL
TITLE=IVAO_MTL
ACTIVE=true
REQUIRED=true
Save and close
10.3 If you use an add-on.xml  don’t make a new entry.
10.4 Re-index the database and start the sim

Section 11 Activating MTL by add-on.xml

11.1 Download File #5:: If you want to store the IVAO_MTL in another disk or folder, please use the add-on.xml as provided. Adapt the <Path> as in your situation.
11.2 In the sample below you will observe that the add-on.xml is placed in the folder: disk:\Documenten\Prepar3D v4 Add-ons\IVAO_MTL and the location of the IVAO_MTL is addressed to <Path>C:\P3D4-AI\IVAO_MTL</Path>
Set your own path!

11.4 Last issue: Do not make additions or changes to the dll.xml since IvAp will be started in another way as will follow. (Reason? There is NO NEW INSTALLER !)

Section – 12 Get started

12.1 Manual Starting IvAp and Configure IvAp
Press your Windows key and go to  the folder IVAO;
you need to check IvAp befor startingthe sim:
(a) Run IvAp v2 Configuration and check the General-Visual Style / Skin setting; no blank skin!
(b) Check the box Show Online Traffic;
(c) Press Reindex MTL (every time the MTL has changed);
(d) 3rd Party Tools: Check enable IvAp <-> FSUIPC SDK ;
then … after this checkup, first start the sim and then IvAp.

12.2 Select the icon IvAp v2 – External | More and Run as administrator.
Done !

12.3 A 2nd (better) option:
Right mouse click the icon IvAp v2 – External and select Add to Start,
then
Open file location, select Properties and check in the compatibility tab Run as administrator.

12.4 After making CONNection and submiting your flightplan (ACARS-SEND FLIGHTPLAN) you will be visible in Webeye.
Your flight results will be registered in the IVAO database. 
When you fly the IVAN network you can see any virual airline (VA).

12.5 IvAp auto start by the sim
If you want IvAp to start always by the sim, add the following statement into the exe.xml. (Line 12 ./. 17)
If you’re not a frequent IVAO-flyer … don’t…
You find this exe.xml file in:
C:\Users\yourname\AppData\Roaming\Lockheed Martin\Prepar3D v4\
Open the exe.xml with Notepad++ and make the changes as in the picture below. (Check your own <Path></Path> !)

Section – 13 Known Issues

13.1 When you get a message as below after starting IvAp, check with ivao_config.exe if the Visual Style / Skin: in General is not blank in the drop-down menu! (Tks-JanH)
REMEMBER: after starting IvAp with the exe.xml the IvAP module will appear just above the system tray.