Frequently Asked Questions

How much does XSquawkBox cost?

XSquawkBox does not cost any money; you do not have to pay for XSquawkBox to use it. The network for which it is intended (VATSIM) also does not require payment.

XSquawkBox does come with legal restrictions, however; please read the EULA carefully before downloading it. In particular, you may not redistribute XSquawkBox; other users who want XSquawkBox must download it from this site.

What Version of X-Plane can I use XSquawkBox with?

XSquawkBox currently works with X-Plane 10 and 11 on Windows, MacOS and Linux systems.  Older versions support X-Plane 8 and 9 and probably earlier, but no support is offered for these versions.  Make sure to update to the very latest (stable) version of X-Plane!

What networks does XSquawkBox work with?

XSquawkBox works with the VATSIM network. While it was initially used for IVAO, that organization has developed their own client and XSquawkBox is no longer used.

How do I use voice-over-IP with XSquawkBox

For VATSIM, configure your microphone and speakers using the Audio Setup dialog box. Voice features will work automatically as you tune your COM1 radio to controllers that are using voice.

What ports do I have to open in my firewall to use VATSIM voice?

In some cases, in order to reliably use voice on VATSIM, you need to open port 3290 for UDP traffic in your Firewall, and forward this port if you have a NAT router. However, in many cases with a modern router, no changes are necessary. We recommend you just try connecting to voice first and see if it works reliably for you. If it does, no changes are necessary.

If you do end up doing port-forwarding, to check if you are correctly forwarded, check the web page of a voice server while flying. If your port is listed as 3290 you are correctly forwarded. If your port is some high number in the ten-thousands range, your port is not forwarded correctly. If your port is not forwarded correctly then you may experience voice disruptions based on your firewall’s firmware.

To see your port in a voice server room, use the URL:


Can I use XSquawkBox’s voice-over-IP capabilities with networks other than VATSIM?

No – the voice system in XSquawkBox is specific to the VATSIM network.

Can I extend XSquawkBox or make add-ons for it?

Yes. XSquawkBox supports interplugin communication. By writing your own X-Plane plugin you can communicate with XSB. If you are a programmer, please refer to the developer page.

My friends and I don’t want to fly on VATSIM, can we just fly by ourselves?

Yes and No. XSquawkBox is only designed for use with VATSIM at this time, as such, XSquawkBox cannot be used in this way.

That said, if you only want to fly with your friends, you can use X-Plane’s integrated multiplayer support for that without the need for XSquawkBox.

I don’t like the aircraft lights – Can’t you fix them?

The aircraft lights are a holdover from the “legacy CSL” support and are unlikely to be “fixed”.   CSLs developed using “new-style” models (which use the X-Plane’s standard OBJ8 format) do not use these old lights and generally look a lot better.

Further to this, “legacy CSL” models are now deprecated, and support will be removed when X-Plane implements alternate (non-OpenGL) rendering methods.

Why don’t I see the right airplanes out the window.

This generally comes down to one of a few specific issues.

  • XSquawkBox version earlier than 1.3.3 have a number of bugs that will prevent non-generic liveries from working reliably.
  • Your installed CSL set has to have a suitable model with livery installed.
  • If there is no direct match available, you need to have a good “related” model set defined.
  • The other aircraft has not set their type code correctly.

The bugs will be dealt with in the upcoming 1.3.3 release of XSquawkBox. Until then you’re not likely to see the right airline livery on an aircraft, and in 1.3.2, you’re not likely to see the right aircraft type either.

The absence of useful models to match with can be dealt with by installing third party CSL libraries. No support can be offered for these however.

With regards to the related models table, as it’s not practical for CSL model sets to cover every imaginable model of aircraft out there (there’s simply too many of them!), it relies on “related” type matching, where an aircraft is matched based upon other, similar, models. As there’s no standard way to say what a “related” model is, XSquawkBox ships with it’s own table which groups similar looking aircraft together, and that will be used to find an acceptable match when a perfect match cannot be found. You can read the related.txt file in your resources directory (it’s an ordinary text file) to see how to configure it. If you feel that you can propose a change to the standard related mappings that will improve the simulator’s behaviour, feel free to let the developer(s) know via the VATSIM XSquawkBox support forum.

As for pilot setting invalid (or incorrect) type codes – that one is out of our hands. We currently do not have a way to override somebody’s reported type.

Some aircraft appear to float above the ground.

This is a combination of a limitation of the network protocol, and differing terrain elevation data between X-Plane and FSX/P3D.

The network protocol limitations arise from the fact that the protocol does not clearly define where the altitude is measured from for any given aircraft (is it from the wheels?  from the CG?).

The terrain elevation data differences arise from the relative age of the simulator data – X-Plane uses fairly recent, very high quality terrain elevation data, whereas the FSX data is quite old and low resolution.  As a consequence, you will most likely see aircraft from other flight sims appear to hover or be buried in the ground.

We will continue to improve this as technology and time allow.

VATSIM weather is not up-to-date/not conducive to flying? Can I use another weather source?

Yes.  If you set the weather update interval in XSquawkBox’s settings to 0 first, XSquawkBox will stop trying to control the simulator’s weather.  From there, you can use the real-weather support, or a third party weather plugin.