Logging

There are two main log files. (Any particular plugin may also create their own log file.)

  • Log.txt: The standard X-Plane Log file

  • XPPython3Log.txt: Standard output for python plugins

For common installation error messages, see Common Installation Errors.

Log.txt

  • Some messages go to Log.txt. Specifically, when python plugin itself is loaded:

    Loaded: <XP>/Resources/plugins/XPPython3/mac_x64/xppython3.xpl (XPPython3.0.0).

    If XPPython3 cannot load, you’ll see an error in this log file.

XPPython3Log.txt

Python messages go to <XP>/XPPython3Log.txt 1. You can change location of this logfile by setting environment variable XPPYTHON3_LOG. Log is re-written each time 2. If you want to preserve the contents of the logfile, set environment variable XPPYTHON3_PRESERVE.

  • Log always contains:

    XPPython3 Version <x.x.x> Started.

    Then the script folder(s) are scanned. If the folder cannot be found (not an error really, but just to let you know). This includes scanning for aircraft-specific plugins:

    Can't open <folder> to scan for plugins.

    On each python plugin startup, we print:

    PI_<plugin> initialized.
         Name: <plugin name>
         Sig:  <plugin signature>
         Desc: <plugin description>

    Successful shutdown will included:

    XPPython Stopped.
    

Footnotes

1

For python2 it was a couple files in the <XP>/Resources/plugins/PythonScripts folder.

2

Python2 appended to the file rather than clearing it out.