The XSquawkBox web page also has a forum for new users of XSquawkBox.
184.108.40.206_ Which Version of this plugin do I need?
XSquawkBox comes in two versions - the IVAO and VATSIM variant. Download and install the appropriate plugin for the network you will participate in. For a network other than VATSIM or IVAO, use the IVAO version of the plugin.
220.127.116.11_ What Happens in Online Flight
The online flight environment is a virtual world that simulates all aviation activities. You will see other aircraft in the sky and on the ground and be able to hear/see text from the other pilots. ATC will monitor you on radar-scope simulation software, issue vectors to you, and provide separation services. XSquawkBox will set X-Plane's weather to match real world weather.
While online, you are expected to follow basic real-world aviation procedures. You will need to file an IFR flight plan when flying in controlled airspace under instrument weather conditions.
18.104.22.168_ Basic Etiquette of Online Flight
Here are a few basic suggestions for successful online flight:
5.1.3_ If You Are New to X-Plane
- When in doubt, always obey ATC instructions, particularly regarding administrative matters.
- Do not connect to the network while in flight or parked on a runway or taxiway. Position your aircraft on the ramp first, then connect to the network. Otherwise you might plug in just in time to see another aircraft bearing down on you!
- Do not connect to the network with X-Plane in demo mode!
- Do not pause X-Plane! If you pause, other aircraft that are behind you will crash into you, since you will appear suspended in mid-air or stopped on the ground. Opening any windows (weather window, plates windows, etc.) will pause the simulator, so fully configure x-plane and download approach plates and charts from the Internet before taking off.
- "Aviate, Navigate, Communicate." Your first priority is to fly your plane safely, second is to follow your intended route, and third is to talk to ATC. Don't let talking to ATC endanger your flight.
X-Plane is an amazing simulator, but it also takes some getting used to. A few notes about X-Plane:
22.214.171.124_ X-Plane Releases and Upgrades
X-Plane is updated on a continuous basis. When buying a version of X-Plane, you receive access to all future upgrades in that major version. In other words, if you buy X-Plane 7.20, you may upgrade to the highest X-Plane 7.xx product. Typically a major version of X-Plane comes out every two years; version 7.15 is just about to be released as of this writing.
The X-Plane demo download is exactly the same as the real X-Plane application; having a CD'unlocks' X-Plane, allowing you to leave the Southern California area and fly for more than 6 minutes with the joystick. All of X-Plane's features are in the demo; frame rates you see in the demo will by typical of the full version; bugs in the demo are in the full version too. The demo does not hide anything (except the rest of the world).
Before you use XSquawkBox you may need to update to a newer version of X-Plane (for example, if you have X-Plane 6.25 you'd need to upgrade to 6.70). However, you may not want to take the latest X-Plane upgrade until you are sure that it will work; sometimes the latest upgrade ships with bugs. The latest version of X-Plane is provided in the form of the X-Plane demo; you must merge these with any custom files you have (for example, the XSquawkBox plugin).
For example, if you have X-Plane version 7.00 and you want to upgrade to X-Plane 7.10, you would download the X-Plane 7.10 demo and merge the X-Plane 7.10 demo files with your files from X-Plane 7.00.
You do not need to install the old version of X-Plane that came on your X-Plane CD; you can simply download the latest X-Plane from the web and run it using the CD in the drive to unlock the joystick.
X-Plane betas are released publicly. If you are not an experienced X-Plane user, I do not recommend participating in the beta program, as X-Plane betas are often unstable. The purpose of the beta program is to find bugs in X-Plane; if the beta builds were not buggy, they would be releases.
When upgrading X-Plane, I recommend caution. Download the new X-Plane first and try it, then move your airplanes and plugins to the new version and delete the old only when you're sure the new version works with your system.
126.96.36.199_ Global Scenery
Laminar Research and the Global Scenery project (GLoS) provide scenery for the entire planet Earth. This scenery can be obtained by purchasing a set of CDs from Laminar Research (X-Plane 7 comes with the latest scenery CDs), or scenery may be downloaded for free as sets of 10x10 degree areas from the GLoS website at http://www.glos.webhop.org/
This scenery is not photorealistic and has limited accuracy. It is generated from government GIS data and is reasaonably accurate to real-world topology and coastlines. The Southern California scenery that ships with X-Plane (not counting San Bernardino) is an excerpt of the global scenery.
If you are considering purchasing the global scenery, especially to upgrade from previous global scenery CDs, download an area you know well from the GLoS server first so you can evaluate the quality of the scenery and understand what you are buying.
188.8.131.52_ Custom scenery and Add-ons
Custom scenery is also available for X-Plane. Simply drag a custom scenery package into the "Custom Scenery" folder.
X-Plane features many add-on planes, scenery, and other content, most for free. The X-Plane home page (http://www.x-plane.com/
) contains links to many portals and other sites that contain free content.
5.1.4_ Installation and Setup
184.108.40.206_ Installing XSquawkBox
There are two versions of XSquawkBox: one for VATSIM, and one for IVAO (and other networks). XSquawkBox comes as a .zip archive for Windows or a .sit archive for Macintosh. Make sure to download the correct version of XSquawkBox for your platform and your network. Once unstuffed or unzipped, the XSquawkBox files for Mac and Windows are almost impossible to tell apart.
To install XSquawkBox, simply decompress the archive and copy the contents of the "for plugins folder" folder into the "X-System/Resources/plugins" folder.
The XSquawkBox.xpl file should be directly inside the X-System/Resources/plugins folder. The "XSquawkBox Resources" folder will sit inside the plugins folder, too.
When XSquawkBox is installed correctly, there will be an "XSquawkBox" menu item in X-Plane's "plugins menu". If you do not have a plugin menu, your X-Plane is incapable of running plugins.
220.127.116.11_ Installation for Flying on Both VATSIM and IVAO
If you wish to fly on two networks, you will need to install both XSquawkBox for IVAO and for VATSIM. Download both installations, but keep only one XSquawkBox plugin (.xpl) file in your plugins folder at a time. You may use one "XSquawkBox Resources" folder for both networks, but you will have to quit X-Plane, remove one XSquawkBox plugin from the plugins folder, and replace it with the other, before restarting X-Plane.
18.104.22.168_ What You Need To Do Before You Fly
Most of XSquawkBox configures automatically, however, there are three important things you must do:
- Get the Latest X-Plane. If you are not used to getting X-Plane updates, please see the "If you are new to X-Plane" web site. The XSquawkBox web site will indicate what versions of X-Plane work with XSquawkBox, but usually the latest non-beta X-Plane is best.
- For VATSIM voice, set up your default audio hardware. Pick the audio devices you want to use from the "Setup Audio" dialog box and then click "Setup Mic" to calibrate and test your microphone.
- For other networks, there may be additional plugins that allow XSquawkBox to use voice technology. See the XSquawkBox home page or network home page for more information. As of this writing, IVAO is developing a voice plugin for XSquawkBox.
- Get your pilot's ID and server IP address for your network. If you don't have a pilot's ID, visit the home page of your favorite network and register. Typically the networks will list server IP addresses on a home page and have an online form for receiving a pilot's ID by email.
Once you've installed XSquawkBox and done these things, you're ready to fly. Read the next section to learn how to use XSquawkBox; if you're not used to online flight, see the section for new users.
22.214.171.124_ Important X-Plane Settings (for X-Plane 7)
A few things you must set in X-Plane for normal operation:
5.1.5_ Using XSquawkBox
- In the rendering settings dialog box, set the number of planes to at least 8.
- In the rendering settings dialog box, enable loading fixes (version 7.00 only).
- In the rendering settings dialog box, turn off "draw aircraft on the ground" (7.10 and higher).
- If you are using VATSIM with voice or another voice-over-IP system, you may want to turn off "background radio chatter" in the Sound dialog box.
Please read this section completely before connecting to the network.
126.96.36.199_ Connecting to the Network
To connect to the network, please pick'Connect...' from the XSquawkBox submenu of the plugins menu in X-Plane. A dialog box will come up asking for the following fields:
- Callsign. The callsign you will be known as on the network. It must include only letters and/or numbers. Examples: N1943, DAL2024
- (Aircraft) Model. The ICAO equipment code of your aircraft. Pick a manufacturer from the left menu and then an aircraft model from the right menu.
- Real Name. Your full name. Examples: John Q. Smith
- Server. The IP address or domain name of your server. Examples: 188.8.131.52.87. You may also pick from a recent server.
- Port. The port for the server you will connect to. Nearly all major networks use port 6809; nearly all training servers use port 6820.
- ID: Your pilot's ID. You receive this from your flight simulation network. Example: 810123.
- Password: the password for your flight sim network. It will appear as stars so that other people cannot read it.
Click the connect button; you will see the prompt "connecting..."
at the top of your screen. If the login is successful, you will then see the welcome message for your flight simulation network. If you cannot login, you will receive an error message. If the server cannot be reached at all, you will simply see "You have been disconnected."
To disconnect from the network, pick "Disconnect" from the XSquawkBox submenu of the Plugins menu. After a few seconds, the message "Disconnected" will appear on the screen.
You may also be disconnected inadvertently due to internet problems or if a supervisor removes you from the network.
184.108.40.206_ Operating the Transponder
A transponder is a radio transmitter and receiver on your airplane that helps air traffic controllers see you on their radar screens. The transponder transmits a four-digit code (often called a "squawk code") that identifies your aircraft.
The X-Plane transponder on your airplane's panel controls your squawk code as seen by air traffic control on the network. If you do not have a transponder on your plane's panel, you will not be able to change your transponder settings and may not be allowed on your network. You can add a transponder to your aircraft's panel using PlaneMaker.
Use the keyboard or mouse to change transponder codes as assigned by ATC. Do not ever let the transponder read 7500, 7600, or 7700; as in real life this will trigger alerts for ATC.
To put your transponder into ident mode, click the'ident' button on your transponder on the x-plane panel with the mouse.
Before X-Plane version 7.10, X-Plane transponders did not have a working standby/Mode C switch. For these older versions of X-Plane, you cannot put your transponder into standby or normal mode-C operation using the X-Plane panel; you must do this using the "Standby" item on the XSquawkBox menu. When you connect, your transponder will be in standby mode; pick the menu item to toggle between normal and standby mode. The menu item will have a light next to it when you are in standby, indicating that you are in standby mode.
For X-Plane 7.10 and more recent versions, simply set the transponder to standby or mode C by clicking on the panel. The light on the transponder will blink when you are squawking mode C.
220.127.116.11_ Talking on the Radio
X-Plane allows you to talk on the radio using either text with the keyboard or voice, where available.
You will receive and send text and voice radio messages only on the frequency specified by your com1 radio. You must tune your com1 radio to the frequency you want to listen to. No other facilities except your com radio exist for changing frequencies in XSquawkBox; your com radio matters!
When someone sends a radio message to you via text, it appears on your windshield with tinting. The messages are color coded based on the origins of the message.
To broadcast, press return; a text entry field will appear. You can type messages or use the mouse to edit. Press return again to send the message, press escape to cancel sending. When you are typing, you cannot use keyboard shortcuts to control the sim. Keyboard focus will return to the sim when you press return or escape. Also, you cannot access X-Plane's built-in "AI ATC" functions while on XSquawkBox.
You can also send messages privately directly to a user by using the syntax
.msg <callsign> <message>
Use the tab key to bring up the last radio transmissions if they have disappeared and you must review one. You can use the page up/page down/end/home keys to scroll through a history of the last 1000 radio messages.
X-Plane only provides 2 decimal places of tuning on the com radios, e.g. 134.12. XSquawkBox works to 25 khz intervals, so this will be treated as 134.125 mhz and tune correctly. Air Traffic Controllers should tune to the full 3 decimal-place frequency, e.g. 134.125. XSquawkBox cannot tune to 8 khz intervals.
18.104.22.168_ Filing a Flight Plan
You can file a flight plan from XSquawkBox. Pick the "Send Flightplan..." menu item from the XSquawkBox menu. A flight plan dialog box will appear. From this dialog box you can enter your flight plan and then press Send to send it to the network.
On VATSIM if ATC has edited your flight plan, sending a new one may have no effect. If you resend a flight plan and the controller does not receive it, notify the controller that he or she must refile the flight plan for you.
even if you have already filed a flight plan online via the VATSIM web page, or even if you are flying VFR and do not intend to request ATC services, you may still want to fill out the flight plan dialog box with a departure and destination airport; XSquawkBox will use this information to correctly set up weather from your departure and destination airports, rather than airports nearby your departure and destination.
22.214.171.124_ A Few Gotchas
Do not use X-Plane's ATC functions to check the local weather; the results will not be accurate. XSquawkBox does not download a metar.rwx file. Use the .metar command (listed below) to check weather online or use ServInfo.
Do not pause the sim or open modal dialog boxes; this will both freeze you in space and cause you to stop hearing voice transmissions (if on VATSIM).
126.96.36.199_ Using Voice on VATSIM
This section is for VATSIM users only. Other users should refer to their network's documentation on voice.
Before you can use voice online, you must choose and calibrate your audio hardware. Pick "Setup Audio..." from the XSquawkBox menu. Two popups will let you choose devices using either Wave or DirectSound input. Try DirectSound first, but try Wave if DirectSound does not work. You may use any audio device; if a device is not compatible with XSquawkBox, an error message will show below.
The volume slider reduces the volume of just voice transmissions; use it to balance volumes with the rest of X-Plane's sound. You may want to turn off X-Plane's built in radio chatter, etc.
Once you have picked hardware, pick'Test Mic'. This will take you through a wizard that sets up your squelch and mic levels and helps you diagnose problems. The squelch level is the level at which your mic does not transmit, and is important for reducing engine noise over the network.
You must go through the mic wizard every time you pick a new input device!
Your push-to-talk keyboard key will block out any previously mapped X-Plane keystroke. But your push-to-talk joystick button will activate both push-to-talk and
any other mapped X-Plane function!
Once your audio settings are set up, fly normally. When you tune into a controller with a voice room (using the com1 radio), you will see messages first that you are joining the voice room and then that you have joined. When you are connected to a voice room, hold down the ` key to talk. You will hear other controllers and pilots.
188.8.131.52_ Using Voice on Other Networks
While XSquawkBox does not have built-in support for voice on networks other than VATSIM, various developers are writing plugins that add voice capability to XSquawkBox. To find these plugins, visit the XSquawkBox home page or your network's home page.
The online flight environment is a complex one with lots of interoperating software; here are a few tips for trouble-shooting XSquawkBox problems.
184.108.40.206_ An aircraft does not look right, or another aircraft looks like my aircraft or my control surfaces move wildly.
This can be caused by not having enough airplanes enabled in X-plane 7. Make sure all 10 airplanes enabled are enabled.
An airplane may also not look right if the user simply has not signed on as the right kind of airplane. The text files that configure online aircraft are not always correct. The XSB_Aircraft.txt file maps ICAO codes of aircraft to one of seven models. If the mapping isn't ideal or there is a typo or missing aircraft, please email me. But please remember, with only seven aircraft a lot of the matches are going to be poor.
If you want to trouble-shoot plane models, you can type:
The first command will cause XSquawkBox to show the ICAO code it has for incoming aircraft. If an incoming aircraft has the wrong ICAO code, that can cause its model to be wrong. The second command dumps a list of every plane's ICAO code and X-Plane model to the Error.out text file. If, upon inspecting this list, you are not happy with the matches, edit the XSB_Aircraft.txt file.
220.127.116.11_ Distorted audio while using integrated VATSIM voice
Sometimes this is caused by the sum of VATSIM voice and X-Plane sounds overloading your sound card. For X-Planes versions older than 7.10, try using the'wear headsets' option in the sound configuration dialog box to turn down X-Plane's sound effects. For X-Plane 7.10 and on, turn down the master volume slider for X-Plane (and for XSquawkBox in the Audio Setup dialog). If you have two sound output devices, put XSquawkBox on the sound output device X-Plane does not use to improve audio a lot.
18.104.22.168_ Macintosh Crashes while using integrated VATSIM voice
This is a known and unfortunate problem that often happens after 3-4 hours of flight. If you would like to use XSquawkBox for VATSIM without integrated voice support, open the XSquawkBox preferences file. Under the [debug[ section, change the line disable_audio=false to disable_audio=true. Restart X-Plane; XSquawkBox will not initialize voice support.
22.214.171.124_ Weather appears wrong
First let me clarify a few things:
- XSquawkBox does not use X-Plane's real weather system. XSquawkBox does not download or create a metar.rwx file, and it will disable RealWeather while you are connected to the network. You can use WeatherMe while flying XSquawkBox, but since RealWeather will be off, doing so will have no effect and simply wastes CPU cycles.
- You will see the local weather reflected in your weather configuration screen.
- XSquawkBox's weather is very much limited by the network; it can only get weather from a station that is reported on the network, and part of the METAR analysis is done by the servers. If the servers analyse the weather incorrectly, XSquawkBox will often show the wrong thing.
XSquawkBox will load the nearest weather station it can find (based on X-Plane's list of airports) every few minutes; this time can be set in the preferences. If you have filed a flight plan, your departure and arrival airports are preferred to the nearest one so you do not pick up the weather of a satelite airport you fly over on final approach. If X-Plane cannot find weather for an airport, it picks the next one and keeps trying.
You can view this process by using the .debug command to enable weather viewing:
to enable weather loading. You will see weather messages show up on the screen as XSquawkBox loads new weather.
If XSquawkBox ever says it loads a METAR but the weather does not reflect this (e.g. the METAR says rain but it is sunny out), email me the METAR and I wil investigate. There is a known bug right now (fixed on VATSIM, unknown for other networks). If a METAR is in the form:
EGNS 170620Z 09007KT 060V120 CAVOK 16/13 Q1015
You may see an outside air temperature of zero degrees Celsius.
If XSquawkBox does not find the weather for your favorite airport, but rather a nearby one, this is due to the network's set of reported weather, not an XSquawkBox issue. You can ask your favorite network administrator to try to find weather for this airport, but this is not an easy task and they may not be able to help you immediately. Some smaller airports do not have weather available online for networks to use.
In summary: what XSquawkBox says it loads in red is what you should see; if what it says it is loading is wrong, this is a network problem; if the loading doesn't match what it says it will load, this is either an XSquawkBox or network bug, but either way report it to me. You will see the latest weather in the weather setup dialog box, but no METAR.rwx will be created.
126.96.36.199_ Commands In the Text Radio
From the text radio you can use the following commands:
.msg <callsign> <msg>
This sends a private message to the specified callsign. Note: you do not get a warning if the message did not go through. You can message someone anywhere in the world even if you cannot see them (because they are out of range).
.msg N1975 Hey George, haven't seen you in a while!
This retrieves the "ATIS" of a controller. The "ATIS" is a personal message that each controller sets in his or her radar client. It is automatically displayed when you tune that controller's frequency.
This fetches a weather report for an airport.
This lets you tune your com1 radio to any radio frequency, including a 25 khz frequency like 134.125. Note: once you tune to a 25 khz frequency, X-Plane will jump from 25 to 75 khz instead of 0 to 50 khz. Tune to a 50 khz frequency using the // command to restore X-Plane to its normal operation mode.
This command allows you to debug various functions in XSquawkBox. For advanced users only.
188.8.131.52_ Connection Dialog
- Connect. Opens up the connection dialog to connect to the network.
- Disconnect. Disconnects you from the network when connected.
- Squawk Standby. Controls your transponder's mode. In standby mode radar controllers cannot see you.
- Send FlightPlan. Brings up the flight plan dialog box, which lets you edit your flight plan.
- Resend FlightPlan. Resends an already sent flight plan in case ATC did not receive it. This is usually not necessary but is provided as a fallback.
- Show Who's Online. This toggles a directory of online ATC in your area. Green = working, yellow = observers, red = supervisors.
- Update Weather. This immediately downloads new weather.
- Update Voice Room. This rechecks which voice room you should be in, in case a controller changed it.
- Setup Audio... Brings up the audio setup dialog, which lets you pick audio hardware.
- Preferences... Brings up the preferences dialog box, which lets you configure XSquawkBox.
184.108.40.206_ Flight Plan Dialog
- Callsign. The name you will use on the network for this flight.
- Model. The make and model of your aircraft; this is what other users will see you as. It should match the plane you are flying in X-Plane.
- Server. The IP address or DNS name of your server, e.g. 220.127.116.11.
- Port. The port to contact the server on. Should be 6809.
- ID. Your pilots ID or controller ID.
- Password. Your user password.
18.104.22.168_ Setup Audio Dialog
- Cancel. Dismisses the dialog box without filing.
- Send. Sends the flight plan and dismisses the dialog box.
22.214.171.124_ Preferences Dialog
- Input. Pick the device to use as a microphone with this.
- Output. Pick the speakers with which you want to hear ATC.
- Volume. Set the level of incoming ATC voice (relative to the rest of X-Plane). Use your sound control panel to set the overall volume of the computer.
- Test Mic. Press this button to run through the mic setup wizard. Do this once every time you pick new hardware!
- Push to talk key. This is the keyboard key to press to turn on your microphone when using voice extensions.
- Push to talk button. This is a button on a joystick or yoke to press to turn on your microphone when using voice extensions.
- Text Radio History. The number of lines the text radios remember.
- Text Window Size. The number of lines displayed in the text radio at any one time.
- Radio Transmission Hold Time. How long the text radio display stays visible after a transmission is received.
- Check Weather Every n Minutes. This is how often to recheck for weather. Five minutes provides a good balance of not missing important weather changes and still checking weather regularly.
- Maximum visibility. This is the maximum visibility that XSquawkBox will set X-Plane to when the weather is reported as perfectly clear (with no clouds, rain, etc.). You can reduce this to limit your total visibility to improve X-Plane's frame rate (e.g. set this to 3 miles).
- Show full planes at. This is how far a plane must be from you to be drawn as a full plane instead of landing lights. 2.5 - 3 miles provides a good transition to a full plane, but if too many planes are slowing down your frame rate, you can decrease this distance to draw planes as lights whhen closer. (You may see a series of lights with no plane body!) XSquawkBox does not draw planes that are offscreen, and it takes into account field of view settings and zoom when deciding how to draw a plane.
- Max number of full planes. This is the total number of full planes that XSquawkBox will ever draw. If too many planes are eligible to be drawn fully, the closest ones are drawn fully and farther ones are not. You can decrease this number to keep your frame rate from getting sluggish when taxiing with lots of other planes in sight.
- ` - talk via voice (configurable).
- return - start a new transmission, close transmission window (if nothing typed), or send a transmission.
- escape - abort the current typing.
- page up/down/end/home - scroll the text radio display.
- tab - toggle the text radio display.