Skip to content

Troubleshoot installation and 1st start

1) All simulators, OS


Read this checklist

Setup / bootstrap file trouble

See Bootstrap file.

swift does not start / connect

  • Could be a Virus scanner/Security suite issue, maybe check if swift needs some permission there
  • Firewall, ports open ...
  • if you see something like "ASSERT failure in QList <T>::operator "index out of range", file C:\QT\5.12.0\msvc2017_64\include\ Qtcore/qlist.h,line 552" your settings could be corrupt, see here
  • sometimes it can help to uncheck and check again the simulator again (simulator settings)

swift hangs after start

Validation errors

See Why do I see validation errors during startup?

No Mic / cannot talk to controller

The Qt WIFI problem

If you see messages like No network access point or No network and you are using WIFI then you likely suffer from a Qt bug. In some versions the Qt framework (the library swift uses) is broken. Qt has promised to fix that. However, you can try the following workaround. In your swift installation directory you will see a directory bearer, just remove this directory and try again.

2) Simulator specific

P3D/FSX specific

  • I only see "Constellations". Most likely you have no model set, an improper model set.
  • If the simulator does NOT connect, see the configuration page for your simulator
  • make sure you have the correct swift version, 32 bit or 64 bit
  • If you cannot connect the simulator and swift: If you run P3D "as admin\", run swift "as admin"
  • make sure you use the correct P3D driver version. If this version does not (yet) exists, selected the version which comes closest.

X-Plane specific

  • Warn of XSquawkBox/xPilot conflict
    • xswiftbus doesn\'t work properly if xsquawkbox or x-ivap is also installed since only one can have control of X-Plane multiplayer aircraft. swift will raise a warning in case another plugin is controlling the multiplayer aircraft.
    • Remove or disable the conflicting plugin and restart X-Plane. Plugins are still loaded even if they are disabled. Disabled just means that any callbacks registered by the plugin will not be called. Some people have to remove the plugins from the folder, some do not.
    • Maybe you consider a 3rd party tool like XOrganizer
  • Bluebell CSL models sunken in ground (vertical offset fix) , see TODO
  • XPlane models in model set, but not rendered. Solution: CSL files need to be inside the XPlane folder. Moving the XPlane models might require to reload your swift model cache, then recreating the model set.
  • swift cannot connect to XPlane simulator side plugin:

    • Check if the settings of the swift side and XPlane side do match, xswiftbus settings.
    • If the simulator LED is "on" the simulator can be connected:

    • XPlane not connecting with swift on MacOS, see this page.

    • HINT: Some users did have problems with spaces in their model directory paths
    • Aircraft animation as gear down not working:
    • There are some known conflicts with other XPlane add-ons as those keep common multiplayer animation datarefs (being shared between all pilot clients) locked and the swift dataref registration fails.
    • In order to resolve the problem move the conflicting plugin out of your plugin folder and restart. The conflict is known to cause trouble with gear animations and such.
    • Problems with the following plugins have been reported: all other client plugins like XSB, x-ivap, fscloud, fs2play

FS9 specific

  • FS9 needs two connections: DirectPlay Multiplayer and FSUIPC since DP MP doesn't have all required details

    • DirectPlay is auto connected if swift runs on the same machine and has been properly installed (adding itself as "lobby-able" application on windows registry)
    • See this page
  • When you run FS9 as admin, then FSUIPC isn't connecting, because swift running as non admin blocks the connection. Run both as admin.

  • Some people have have reported issues with models not from the aircraft folder of FS9
  • some users have problems with the auto-connect to FS9 since Win10 1909 update, see this page
  • FS9 elevation

3) OS specific

Some issues with Mac OS

  • XPlane not connecting with swift on MacOS, see this page.
  • Not validated: Installation in Application failed, but in XPlane directory it works.