Help, Support, Bugs, Issue

What you can do yourself in case of problems and how to get further support

Help and Support

Your best bets for getting clarification on your question or problem are:

  1. LiveTraffic has a help menu and it has [?] buttons in all windows. Use and click them! They bring you here, to the right page.

  2. Search this documentation

    1. There is a search box in the top right corner. Just enter a few words. This documentation is very comprehensive, hoping to cover all usual aspects of operating LiveTaffic. Every question I have answered once is reflected in this documentation. Even a number of typical messages from the message area or your Log.txt are explained. So search for that error text!

    2. Check FAQ. You question might be frequently asked...and answered.

    3. Check the Known Issues. There is stuff I know about.

  3. Check your Log.txt. The file Log.txt is created (and overwritten) at every startup of X-Plane in X-Plane's main directory where also X-Plane.exe/.app resides. It contains diagnostic information of X-Plane itself and all plugins. It is just a plain text file. Double click it...it will open in your standard text editor. You don't need to understand every line of it. If we talk about LiveTraffic then just search for lines starting with "LiveTraffic" (usually [Ctrl+F] starts a search). Chances are you find "ERROR" or even "FATAL" lines written by LiveTraffic. They will point you into the right direction. Every plugin author as well as Laminar will request this file when asked for help. So do I. To make it very clear-cut: No Log.txt, no help. I must have this file to be able to help you.

  4. Ask for more help in the LiveTraffic Support Forum or Discord if none of the above helps. Please follow the guidance for support requests given in this introductory post. Attach your complete Log.txt file to a new post.

Bugs, Defects, Problems, Issues, Suggestions

...are all welcome, provided, they come in a structured and informative way.

I will not follow up on issues like "I once saw an aircraft that...".

If you find a pattern, though, like "Using channel Abc, many planes around KXYZ, especially in the evening, tend to blablabla", then you would have time to switch log level to Debug, maybe even activate network raw data logging (Debug settings) and shoot some meaningful screenshot including an a/c info window. And then I might be able to follow up.

What to do immediately

When you find a problem there are a few things you do right away:

  • [Shift-Space] takes a screenshot (which lands in the Output subdirectory of X-Plane), or sometimes even better:

  • [Ctrl-Space] takes a video.

  • If situation allows, open an A/C Info Wnd and display the a/c in question (the AUTO feature might come in handy), then do another screenshot with that information.

  • Copy away Log.txt to a safe place and rename it aptly. Log.txt is overwritten on restart of X-Plane. Let's make it clear: No Log.txt, no bug analysis. As simple as that.

X-Plane quit unexpectedly

Even if X-Plane quits unexpectedly ("Crash to Desktop" or CTD) it usually writes a last line into Log.txt. So even then Log.txt is of help and needs to be provided. This last line indicates which plugin was the culprit...or if it was at the core of X-Plane. There are several pieces of software that provide your simulator experience. All could fail. If Log.txt ends with

Log.txt (last line)
--=={This application has crashed because of the plugin: LiveTraffic}==--

then chances are good that it really was LiveTraffic. In addition to this last line X-Plane writes crash dumps. They differ by operating system but are very valuable to a developer. Add the crash dump to your support forum post, too.

Windows

X-Plane writes crash reports into Output/crash_reports. The large .rpt files are - in its entirety - only readable by Laminar. A way smaller standard .dmp file is readable by any Windows debugger and would help a lot in analysing why the plugin LiveTraffic crashed, if the crash was inside LiveTraffic. If there is no .dmp file but only a .rpt file, then the .dmp file can be extracted from the .rpt file.

Due to the size please don't attach the .rpt file without being asked for it. The small .dmp file can be attached to any issue report right away.

Mac

When X-Plane crashes on a Mac then

  • a crash log should be written to ~/Library/Logs/DiagnosticReports. Library is a hidden folder in your home directory. In a Finder window you can toggle the display of hidden folders/files by pressing [Shift+Cmd+.] The crash reports are named with application and timestamp so you should be able to pick the right one (like X-Plane_2020-06-04-215443_Charlie.crash). Please attach the .crash file to your report.

  • Mac OS might pop up a question saying "X-Plane ... quit unexpectedly" offering three buttons. Please click the Report... button. A window with crash details opens (the content of the report written to DiagnosticsReports). Please include a copy (select text as shown below and copy text to clipboard, no screenshots please) of the header information and the call stack of the first thread into a bug report:

Mac OS Problem Report, selected the section a bug report needs

Close the window with Don't Send button...Apple won't help me 😏