Settings - Debug

The "Debug" section of the Settings dialog: for the programmer or CSL modeller

Settings are available from X-Plane's menu: Plugin > LiveTraffic > Settings.... In the "Debug" section you have access to additional processing information and model matching overrides. This is typically only of interest to programmers and CSL modellers.

SettingDefaultDescription

Set Log Level = "Debug"

Disabled

Provided as a courtesy, in case users search here when asked to set Log Level to Debug.

Log model Matching

Disabled

This places some lines of debugging information into Log.txt about how XPMP2 picks a CSL model. Might be temporarily interesting if you want to figure out why some planes aren't rendered as expected.

Log a/c positions

Disabled

Log Raw Network Data

Disabled

With this option enabled, a separate output file named LTRawFD.log is written into X-Plane's system folder, including each network request and the corresponding response as raw uninterpreted data. This would allow analysing anomalies like "rocket planes" or hovering planes if the logging period covers such behavior.

Note 1: Unlike Log.txt, LTRawFD.log is never overwritten but appended to. You'll need to clean it up yourself from time to time if using this option.

Note 2: This option is not written to the config file but returns to disabled with restart.

Filter single a/c

Empty

Filter all flight data for one specific aircraft. Good for code debugging purposes.

The same search options as in an A/C Info Window apply: Transponder Hex Code, Registration, Call Sign, Flight Number, SquawkCode, Index.

Dump apt layout

Empty

Forced Model Matching

These are options for CSL model builders to test their models with LiveTraffic. Each of the 3 fields overrides the otherwise variable strings that LiveTraffic hands over to the multiplayer library to feed into the model matching algorithms.

Or in other words: You can force LiveTraffic to pick a specific model regardless of the actual aircraft as per tracking data. You can read about the details of the matching process here.

Changes to the settings are announced in the message area.

There are no validations on data input. This is meant for debugging purposes: You can test whatever you like.

Only filled values are overwritten; clear values will be filled with real information as per received tracking data. To return to standard processing clear all three values.

These settings are not written into the config file, hence latest on startup LiveTraffic is back to standard processing, i.e. without forced values.

You definitely want to have Log model matching enabled and watch Log.txt live while testing (see Tips on Testing for how to open a terminal window and keep watching).

FieldIntended content

ICAO a/c type

Matches the ICAO line of xsb_aircrafts.txt.

ICAO operator/airline

Matches against the AIRLINE line of xsb_aircrafts.txt

livery/registration

A text specifically identifying an individual livery. LiveTraffic fills the registration (tail number). So it is theoretically possible to define up to one CSL model per airframe for most realism.

Matches against the LIVERY line of xsb_aircrafts.txt.