Plugin Installation

Requirements

  • X-Plane 12.00+. Linux, Mac (Intel and M-series processors) or Windows. This plugin is built with SDK 400 and is NOT backward compatible to X-Plane 11 or earlier.

Note

This version of XPPython3 requires X-Plane 12. If you are using X-Plane 11.52, you must install XPPython3 v3.1.5. See Installation for X-Plane 11.

If you’re upgrading from XPPython v3.1.5, see Upgrading XPPython3.

Installation

Three steps:

  1. Download XPPython3 zipfile:

Select zipfile:

OS

Stable Version

Beta Version 1

For Windows

xp3-win32.zip

xp3-win32b.zip

For Linux

xp3-linux.zip

xp3-linuxb.zip

For Mac

xp3-darwin.zip

xp3-darwinb.zip

  1. Extract the xp3xxx.zip into your X-Plane/Resources/plugins folder, such that you have folder there called XPPython3.

This plugin XPPython3 folder must be placed in <XP>/Resources/plugins. On first execution of X-Plane, XPPython3 will create the Resources/plugins/PythonPlugins folder.

You should place any third-party python plugins in that PythonPlugins folder. (On first run of the plugin, XPPython3 will automatically download a set of sample plugins into your Resources/plugins/PythonPlugins/samples folder. To execute a sample, move a plugin up into the PythonPlugins folder.)

You file system layout should match (with only one of mac_x64 or lin_x64 or win_x64:

<X-Plane>/
└─── Resources/
     └─── plugins/
          └─── XPPython3/
               ├─── mac_x64/
               |    ├─── XPPython3.xpl
               |    └─── python3.12/
               ├─── lin_x64/
               |    ├─── XPPython3.xpl
               |    └─── python3.12/
               └─── win_x64/
                    ├─── XPPython3.xpl
                    ├─── python.exe
                    ├─── ...
                    └─── Lib/

Extra For Mac

STOP! Before continuing, you need to remove the quarantine. Follow instructions in Mac Quarantine.

If you forget to do this, XPPython3 will not load and you’ll get error popup indicating XPPython3.xpl cannot be opened. See Common Installation Errors.

  1. Start X-Plane.

On installation success, we’ll popup a window:

../_images/python_samples_popup.png

Note

If you have problems with installation

  1. Actually read this page.

  2. Check Common Installation Errors.

  3. If you still have problems with installation provide information described in Getting Support.

Errors are logged, see Logging.

If it’s running, get familiar with XPPython3 Menus.

1

Caution: It’s Beta. Save a copy of your stable XPPython3 just in case (just rename the folder and it won’t load automatically). Anything can happen in a Beta, “not working” is common. If you’ve been invited to use a beta, my deepest thanks.