Frequently asked questions
- 1 Distribution
- 1.1 Where can I get FlightGear?
- 1.2 How do I install FlightGear on Linux?
- 1.3 Where can I find the latest development source code?
- 1.4 Where do I get the scenery? What is available?
- 1.5 Where can I get different 3D models for my plane?
- 1.6 Why are the aircraft at FlightGear.org out of date?
- 1.7 How current is the data in FlightGear compared to the real world?
- 1.8 Why don't you charge money for this?
- 1.9 How can I get started with FlightGear?
- 2 Compiling
- 3 Configuring and running
- 4 Flying
- 4.1 Why won't my engine(s) start?
- 4.2 Where is the moving map?
- 4.3 Where can I learn about instrument flying and navigation?
- 4.4 What is the difference between Aileron and Rudder?
- 4.5 Is there support for multi-player flying?
- 4.6 Where are the best places to fly in FlightGear?
- 4.7 Where can I find airport info and aeronautical charts online?
- 4.8 Is there support for any military scenarios like dog fighting or bomb dropping?
- 4.9 Flying issues
- 5 Contributing
- 5.1 What language is FlightGear written in?
- 5.2 How do I design a flight dynamics model for a new aircraft?
- 5.3 How do I design or modify a 2D panel?
- 5.4 How do I place objects, like buildings, into FlightGear?
- 5.5 Where can I learn 3D programming and how do I get involved?
- 5.6 How do I add an airport?
- 5.7 Can I generate my own scenery?
- 6 Problems
- 6.1 X doesn't work / is broken / is wrong / won't run
- 6.2 Unable to execute file: bin/Win32/fgrun.exe during installation
- 6.3 What happened to the panel, keyboard, etc?
- 6.4 Why is FlightGear so slow?
- 6.5 How do I see the Frame Rate?
- 6.6 How do I toggle 2D cockpit settings?
- 6.7 Stuck upside down after "crash"?
- 6.8 Why won't the latest versions of some aircraft work in my (older) version of FlightGear?
- 6.9 When I start FlightGear I see an error mentioning "SQLite". What do I do?
- 6.10 My aircraft has grey windows?
- 7 The FAQ
Where can I get FlightGear?
The official download page is http://www.flightgear.org/download/. Precompiled binaries are available for Windows, and most Linux users will find that most distributions have a packaged version of FlightGear (the package name could be fgfs or flightgear.)
How do I install FlightGear on Linux?
Many distributions include FlightGear in their repositories. If you can't find a packaged version for you, consider downloading and compiling from sources.
Where can I find the latest development source code?
The latest development code is available for everyone through our Git repository.
Where do I get the scenery? What is available?
While the base package only comes with scenery for the San Francisco Bay area, you can currently fly just about anywhere in the world. Currently Terrasync is the best option: it downloads the latest scenery while flying. See its page for usage information.
However the latest scenery could be too demanding if you have a low end computer or not much RAM, so consider instead to manually install the old scenery from the "graphical interface" available at the scenery download page.
Where can I get different 3D models for my plane?
Official FlightGear aircraft can be found at Download central. Other aircraft in development can be found in the official FGAddon aircraft repository, and some other aircraft can be found in 3rd party FlightGear hangars.
Why are the aircraft at FlightGear.org out of date?
The official aircraft downloads are only updated at the time of a new release of FlightGear. This is done because aircraft that are currently in development are usually developed on development/unreleased versions of FlightGear. Those development versions have lots of features that are not supported by the (older) stable release. Would we update the aircraft downloads more often, most aircraft wouldn't work on the stable release of FlightGear.
How current is the data in FlightGear compared to the real world?
We use the same navaid and airport dataset that X-Plane uses. The current dataset can be found in the $FG ROOT/Navaids/ and $FG ROOT/Airports/ directories. The maintainer can be found at X-Plane Airport & Navigation Data.
Why don't you charge money for this?
FlightGear can be downloaded for free from many locations including the FlightGear website, but can also be bought on a CD. Although we offer that service (see the website), we encourage other groups to redistribute it for their users, especially within an operating system distribution which makes installation even faster and easier for new users.
Occasionally you may see FlightGear for sale on auction sites or commercial websites under some other name. This can be done quite legitimately as long as the terms of the license are upheld and might be worth the cost if some value-added features such as additional scenery, aircraft or after-sale support are included. Unfortunately, most cases seen to date appear to be just someone trying to make money selling something that is free and providing no real added value.
How can I get started with FlightGear?
There's no better place than the page New to FlightGear!
How do I compile FlightGear from source?
See Building FlightGear. There are explanations to compile in Windows, Linux and even scripts to automatically download and compile the whole thing.
Why won't FlightGear compile?
Well, that depends. First make sure you are using the appropriate versions of FlightGear, SimGear, plib, zlib. If any of the packages are out of sync with the others, compilation may fail. See also Building FlightGear
The FlightGear Downloads page should tell you what versions you need if you are trying to compile the latest stable release. If you are using a development snapshot, make sure all three packages are up-to-date.
Also ensure that you have some implementation of OpenGL with glut support with the appropriate header files. Linux users with nVidia cards should make sure you have the latest drivers from nVidia. Other Linux users make sure you have Mesa3D (http://mesa3d.org/) and your X server installed correctly.
What is SimGear, and why do I need it?
SimGear is a library of supporting code. SimGear is only needed if you plan on compiling FlightGear — it is not needed to run precompiled binaries. For more information see http://www.simgear.org/. Note: When compiling FlightGear it is very important to have the matching version of SimGear.
Configuring and running
How do I start FlightGear?
How do I install new scenery?
If you really don't want to/can't use Terrasync, the scenery archive files (ie. w100n30.tar.gz) should be decompressed into the Scenery/Terrain directory in your $FG_ROOT. More at Howto: Install scenery.
How do I setup my joystick(s)?
FlightGear supports wonderfully many joysticks/yokes out of the box. However if you're having problems see Input device.
What is fgfsrc? What format should my personal .fgfsrc file be in?
How do I get to see options, help etc?
You probably can not see the main menu. To make it show press F10.
Why won't my engine(s) start?
Aircraft vary in their starting procedure. Some may have an auto-start sequence menu entry or instructions in the aircraft help menu (Press "?") and/or at the aircraft's wiki. Please consider reading the FlightGear Manual, or see this quick small guide.
Where is the moving map?
In game, you can go into the menu "Equipment > Map", but there won't be any aeronautical chart. A popular moving map display is available under a separate project called Atlas. Also, MPmap is an online map for multiplayer.
- http://www.navfltsm.addr.com/ is a very good site for learning techniques for navigation.
- See How It Flies a very nice book by John S. Denker, freely accessible online
What is the difference between Aileron and Rudder?
There is a bit of info on aileron vs. rudder in the very same book...
Is there support for multi-player flying?
Yes, sure we have it! See Howto: Multiplayer. Both the Windows and *nix versions of FlightGear are capable of multi-player flying on FlightGear servers. Also voice communication is supported, with FGCom.
A map showing players aircraft online in real time is available as MPmap.
Where are the best places to fly in FlightGear?
FlightGear scenery covers the whole world, but thanks to the FlightGear user community, certain airports and areas are more detailed than others. As a general idea:
- There are a lot of high-quality scenery models around Paris, France.
- EHAM Amsterdam Schiphol, EGKK London Gatwick and LFPG Paris Charles de Gaulle are some of the highest quality airports.
- LOWI Innsbruck is both developed in scenery and airport.
- TNCM St. Maarten is a popular destination, and the surrounding islands (Anguilla, St. Eustatius, Saba, St. Barthélemy, St. Kitts, and Nevis) are all well-modeled.
Where can I find airport info and aeronautical charts online?
Is there support for any military scenarios like dog fighting or bomb dropping?
Yes. Check out the Bombable add on and Bombable's forum thread. There are also third-party bombing scenarios for the A-10 and other aircraft with armament, like the North American OV-10A Bronco, General Dynamics F-16 and F-117 Nighthawk.
Why are my controls returning to a particular position?
There are several possibilities that can lead to this:
- If your aircraft's autopilot is enabled, it will take over (some of) your controls. Switch the autopilot off to regain control.
- Some laptops have an onboard gravity sensor that might be detected as a joystick. See how to solve that at Troubleshooting input devices.
Why does my cockpit disappear when looking around?
Probably you're using a 2D-panel version of an aircraft. Be sure to pick the one with a 3D cockpit. Most of the aircraft now have it!
There are lots of other aircraft flying around
FlightGear has a so-called AI-traffic system. This system generates other, computer-controlled aircraft based on real flight plans to make the FlightGear world look more alive. To disable it, uncheck the proper option in FGrun.
If on the contrary you can't see any aircraft other than yours, consider contributing to add traffic to your favourite place!
I can't make this plane fly straight, it keeps turning left!
Yes, FlightGear is a real flight simulator and simulates that too. Exactly, that's how real propeller aircraft behave. See Understanding Propeller Torque and P-Factor.
What language is FlightGear written in?
Mostly C++ with some supporting C code that's primarily contained within SimGear. For more details on the used languages:
As you seem to be interested in core development, you should really check out Howto:Start core development.
How do I design a flight dynamics model for a new aircraft?
FlightGear supports various flight dynamics models (FDMs), but just two of them are commonly used:
- JSBSim: see http://jsbsim.sf.net/.
- YASim: if you want a simpler FDM to work with, try your hand at YASim. For a guide on creating YASim aircraft, look in the FlightGear base package for $FG_ROOT/Docs/README.yasim.
See the Aircraft development portal.
How do I design or modify a 2D panel?
See the $FG_ROOT/Docs/README.xmlpanel file on your computer.
How do I place objects, like buildings, into FlightGear?
The most up to date solution is using the UFO. See Howto:Place 3D objects with the UFO. The UFO will give you the interface to choose one of the available objects and place it to some grade of precision into FG world, and then export that data to be uploaded to the official scenery, or for personal use. For more, see the Scenery development portal.
Where can I learn 3D programming and how do I get involved?
If you'd like to create a 3D cockpit for FlightGear, or to create buildings, external aircraft models, etc., your help is desperately needed. Try to go easy on the triangles, so that your work will be enjoyed by as many people as possible. The most commonly used tools here are Blender, AC3D, Gimp.
If, on the other hand, you really want to get your hands dirty with C++ coding, you'll have to buy a good OpenGL book eventually. However, FlightGear uses OSG, a high performance 3D graphics toolkit. To get started with 3D C++ coding, you can take a look at the OSG documentation and learn only as much OpenGL as you need, when you need it.
How do I add an airport?
This process includes creating the airport layout in WorldEditor, testing it (you might want to generate part of the scenery, but this is not mandatory) and then, if your data sources are GPL compatible, send it to Robin for inclusion in the shared airport database. The airport will be available in the next full rebuild of the scenery, unless you want to generate your own scenery. More at Howto:Make an airport.
Can I generate my own scenery?
Yes, though it can be a difficult task. FlightGear's scenery generation is handled by a sister project, TerraGear. The good news, though, is that once you have set everything up it's quite easy (although might be time consuming), and above all that you can easily share it.
X doesn't work / is broken / is wrong / won't run
If your problem is instead software crashes, you're getting errors, etc..., please consider following the indications in Troubleshooting problems.
Some of the most common issues are however listed below. If you can't solve the problem on your own and need the help of someone, please remember that we're all here for fun, developers included, and that any help is an act of generosity. So try to be nice, even if the problem is frustrating you.
Unable to execute file: bin/Win32/fgrun.exe during installation
| This section contains out-of-date information
Your system is missing the MSVC runtime libraries required by FlightGear. Download and install the following vcredist_x86.exe:
- MSVC9 for FG2.4.0 (and earlier): http://www.microsoft.com/download/en/details.aspx?id=26368
- MSVC10 for FG2.6.0 (and later): http://www.microsoft.com/download/en/details.aspx?id=5555
What happened to the panel, keyboard, etc?
The problem is almost certainly that your base package is out of sync with FlightGear. Many configurable parts of FlightGear are defined in XML files contained in the base package.
Why is FlightGear so slow?
If it seems just slow, see if you can fiddle with graphics settings here: Howto: Improve Framerates.
If things are pathologically slow (i.e. ~1 frame per second), maybe 3D hardware acceleration is not activated. Make sure you have OpenGL libraries installed and configured properly and make sure you have the latest drivers for your video card. Also, be ready because some cards are not well supported.
How do I see the Frame Rate?
On the in-sim menu select View > Display Options, then check the box that says "Show frame rate".
How do I toggle 2D cockpit settings?
There are two ways. One way is to hide the panel without the HUD showing. To hide the panel, use Shift+P; To make the HUD disappear, use H. The second way is to use the alternative HUD by Shift+I (Use I to switch back).
Stuck upside down after "crash"?
In his infinite wisdom the FlightGear Grand Master decided that planes were too valuable to allow them to be destroyed by novice pilots who seemed to crash a lot. The fact that nobody has bothered to model crashes may have something to do with it too. :-)
The result of this as you have noticed is that with a little practice an ingenuity you can trim the ship to fly inverted along the ground. The quick answer is to reset the sim, via the File > Reset menu. This will place your aircraft back at its starting location.
For the stubborn people out there: The trick to learn is to roll back to normal (non inverted) do this by nursing the elevator to get to about 500 feet or so and use the ailerons to snap roll 180*. This is all good avionics except for the plane not destroying itself. Remember the controls work in reverse when you are inverted and keep that airspeed up!!!
Why won't the latest versions of some aircraft work in my (older) version of FlightGear?
Often new aircraft development keeps pace with the latest FlightGear code development. New or newly modified aircraft may rely on files (such as new instrument files) or features, only available with newer versions of FlightGear. If you are stuck with an older version of FlightGear, you can try downloading an earlier version of the aircraft from the corresponding official FlightGear aircraft hangar.
When I start FlightGear I see an error mentioning "SQLite". What do I do?
Since FlightGear v2.10 (released in February 2013), the navdata cache was introduced to improve the FlightGear start times. This cache is a SQLite database that is a little fragile at times. If the database is corrupted FlightGear will refuse to start.
To fix this you simply need to delete the
$FG_HOME/navdata.cache file. The first time FlightGear starts after deletion of the file the navdata cache will be rebuild. As this process is time consuming, FlightGear will take more time to start.
Some will resort to delete the entire
$FG_HOME directory or even reinstall FlightGear. However neither is needed and may cause you to lose any custom preferences you have set up.
My aircraft has grey windows?
The problem of opaque grey/gray windows that cannot be seen through is most often due to a version mismatch between the FlightGear program and the aircraft. Or it could be due to a window effect that is not compatible with the Rembrandt or ALS rendering systems. The technical cause is that the renderer and declared effect for the window are incompatible. Some solutions include:
- If you are using a stable FlightGear release, please download the aircraft from the official FlightGear hangars matching your FlightGear version.
- If you are using a cutting-edge nightly build or a version controlled copy of FlightGear, or you wish to use a cutting-edge aircraft, please see FGAddon#Obtaining aircraft.
- If you are using an aircraft from one of the 3rd party hangars, it is best to contact the original aircraft author or the person in charge of the 3rd party hangar.
- If you are using Rembrandt, try turning this rendering system off. Aircraft that use
model-default.efffor the windows (at the simple expense of doing nothing) rather than
glass.eff(which instruct Rembrandt to not use deferred rendering for the glass) will have grey windows when using Rembrandt.
Where can I get the latest version of this FAQ?
Who do I contact if I have comments about this FAQ?
Add your comment to this FAQ's discussion page.
How old is this document?