YAACARS is an alternative client to the XACARS client to log virtual flights to the
Flight Economy Sim "Fly the World" http://www.ftw-sim.de.

It's based on the [[https://github.com/Maeyanie/OAACARS|OAACARS client]] by Maeyanie.

====== Download ======
''**Download: http://www.ftw-sim.de/yaacars/download/**''

===== Installation =====
==== Windows ====
  * Extract the YAACARS folder of the ZIP file to a location of your liking, but avoid "c:\program files"
  * enter the YAACARS\win32 folder
  * start YAACARS.exe
  * enjoy
==== Linux ====
  * chmod u+x the YAACARS.appImage
  * Double-Click the appImage
  * enjoy
==== Mac OS ====
  * Double-Click the DMG
  * Double-Click YAACARS (you can run YAACARS within the DMG or copy it to your APPS folder, as you like!)
  * enjoy

===== ChangeLog =====
[[ChangeLog]]

[[KnownIssues|Known Issues]]

===== Integration =====
==== X-Plane ====
There is the full [[yaacars-interface|YAACARS-Interface]] or the smaller [[YAACARS-Loadmanager.lua]] available.

If you install one of these addons it's possible to set fuel and payload directly in X-Plane.\\
It's not needed for YAACARS to work, just to make life easier!
====== Getting Started ======
===== Startup =====

After starting up YAACARS the "about page" is shown.\\
It contains a small help screen to get you started.\\

You have to enter your:\\
  * FTW user name\\
  * <del>__XACARS__</del> (from YAACARS 2.0 on you have to use your) FTW-Password\\

In the upper section you can also update when newer versions are available.\\
You can also switch between the stable and the latest testing version.

{{:yaacars_01.png?nolink|}}

<del>There is a chance of wrong password transmision, if you use certain special characters in your password.
If you get the message "login failed" when trying to __start the flight__, you might want to change your XACARS password on the FTW website settings and try again.</del>(no longer in 2.0)

===== Receiving the Flightplan =====

Switch over to the "FlightPlan" tab.

<del>Now enter your FTW Flight Number in the orange "Flight Number" field and</del>(no longer in 2.0) press "load FTW flight" to receive the data from the server. No need to copy/paste the flight number anymore!

{{:yaacars_02.png?nolink|}}

===== Adapting the Flightplan =====

<del>You now should enter the fuel weight</del> (the client will check for the correct fuel levels in the sim against this value, if the checkbox "check fuel" is enabled).\\
Alternatively you can disable the "fuel check" feature, but be aware that the flight may fail to log correctly at the end of the flight.

<del>You can also change the following data in the client:
  * the true total weight of the passengers (only needed, if you want to use the "apply weight" feature): the client only receives the number of pax and calculates a pax weight. You can enter the more precise values from the FTW website into the client
</del>(no longer needed in 2.0)
  * Arrival ICAO (if it's wrong or empty from a tranfer flight)

{{:yaacars_03.png?nolink|}}

===== Prepare your Plane (in X-Plane) =====

Apply the weights from the FTW website "fuel weight" and "total payload" to your plane in X-Plane (or use the YAACRS-Interface or the loadManager-Script for X-Plane, if you don't want to do it manually):

{{:yaacars_04.png?nolink|}}

{{:yaacars_05.png?nolink|}}

{{:yaacars_11.png?nolink|}}

{{:yaacars_07a.png?nolink|}}

===== Start the Flight Tracking =====

Make sure, you are connected to the simulator:
  * "Connect to SIM" button is green
  * if yellow or red, click to connect
  * if still red, make sure:
      * check you set the right connection method XPUDP/FSUIPC
      * the plane is loaded (not in Main Menu!)
      * check your firewalls etc blocking the UDP connection
      * ask for help!
and then click "start flight" button.

After the flight tracking has successfully been started, the client will move over to the "Flight Data" tab.

{{:yaacars_08.png?nolink|}}

PLEASE NOTE, that on newer versions of YACARS there's a so-called info bar, a small forground overlay window that can be toggled in the lower right section of the main window. This info bar shows the important details of the flight without the need to have YAACARS' main window in sight all the time!
{{ :yaacars_infobar_waning.png?nolink |}}

Serveral error popups can show up, for wrong fuel settings, wrong plane location, not connected to the sim, which are not discussed in detail here. If you can have any questions about the error messages, please use the contact link shown in the "about" tab.

This is, for example, an error popup message for the detection of mismatching fuel levels...
{{:yaacars_06.png?nolink|}}

===== In-Flight Events =====

There are only two events for now that will <del>cancel (in YAACARS 1.4) or</del> pause (in YAACARS 1.5+) the flight tracking:
  * WARPing: your plane moves a pretty large number of miles in a pretty short time
  * REFUELing: your fuel tank levels rise compared to last measured value

WARPing will result in not adding the "warped" distance to the tracked distance (that needs to be at least 100% at the end of the flight!).\\
REFUELing will pause the flight tracking (stop counting tracked distances and flight time), until the last known fuel level is reached again.

YAACARS 1.5+
{{:yaacars_09a.png?nolink|}}

===== Enjoy your Flight =====

{{:yaacars_10.png?nolink|}}

===== End Flight Tracking =====

After landing the "end flight" button should be enabled, so you can send the pirep to the server.


===== Resuming a Flight =====

[[Resume FAQ]]

====== Gimmicks ======
===== KML files =====
{{ :ge_netlinks.png?direct&600 |}} 

YAACARS generates KML files for Google Earth, if it's enabled on the lower right side of the client.

These files are generated:
  * currentPosition.kml - your plane's position
  * currentRoute.kml - your loaded FTW flight

These files can be embedded to Google Earth as "net links", so they are updating automagically from time to time:
{{ :ge_add_netlink.png?direct&600 |}}