Fgfsrc
Jump to navigation
Jump to search
The .fgfsrc file is an rc-file that contain command line options that are read by FlightGear at startup. This is useful if you often start FlightGear using the same command line options.
Creating the file
It is very likely that this file does not exist on your system yet, and therefore has to be created by you. The contents of the file are handled the same way by FlightGear on all operating systems, but the name and location is not:
- on GNU/Linux the file is called
.fgfsrc. Note the leading period! FlightGear is looking for it inside the $HOME directory of the user. To figure out where this is on your system, open a terminal window (shell) and entercd $HOME. - On Mac OS X, the same as GNU/Linux. A Terminal window is placed on
/Applications/Utilities/Terminal.app - On Windows systems the file is called
fgfsrcand lives in $FG_HOME which can be found underC:\Users\{username}\AppData\Roaming\flightgear.org.
Rules for file contents
- The file is plain text (ASCII), like saving a
.txtfile with Wordpad. - Each line only contains one option.
- Lines with a leading
#are treated as a comment and will be ignored by FlightGear. - Use comments following an option (like
--some-option # Some comment) with care. At least with strings containing--prop=options this will cause FlightGear to fail. - Variables, such as
$HOMEor $FG_HOME in paths are not resolved.
Example files
Have in mind, that at least the local paths (like fg-root and fg-scenery) and the multiplayer options have to be altered to work on your system!
# $HOME/.fgfsrc ### Aircraft # --aircraft=ec135 ## Catalina, dhc3[A/F], p47d-30, F1-156-de, ZivkoEdge540 ## MPcarrier: nimitz, nimitz-ATC, nimitz_observer, foch, vinson, eisenhower ### Initial position # --airport=LOWI #--runway=08L #--parkpos=A11 # # In air: #--offset-distance=1.5 #--altitude=6000 #--vc=70 #--enable-freeze # # Coordinates: ## Oilrig Lennox: #--lon=-3.17547 #--lat=53.63305 #--altitude=205 ### Environment # --timeofday=noon #--enable-real-weather-fetch --enable-horizon-effect --enable-specular-highlight --enable-ai-models --enable-clouds3d --shading-flat --fog-nicest --enable-random-objects --prop:/sim/rendering/random-vegetation=true ## limit fps to 30: --prop:/sim/frame-rate-throttle-hz=30 ## rain/snow: --prop:/sim/rendering/precipitation-enable=true --ai-scenario=nimitz_demo --ai-scenario=clemenceau_demo #--ai-scenario=aircraft_demo ### Network # --callsign=I-FLY #--prop:/sim/remote/pilot-callsign=U-FLY --multiplay=out,10,mpserverXX.flightgear.org,5000 #--multiplay=in,10,localhost,5000 --httpd=5500 ## nice terrasync -p 5505 -S -d /opt/fgfs/scenery.terrasync : --atlas=socket,out,1,localhost,5505,udp ## fgcom -Sfgcom.flightgear.org.uk [-f910] : --generic=socket,out,10,localhost,16661,udp,fgcom ### System # #--log-level=info ## alert,warn,info,debug --fg-root=/opt/fgfs/data --fg-scenery=/opt/fgfs/data/Scenery:/opt/fgfs/scenery.1.0.1:/opt/fgfs/scenery.terrasync --geometry=1280x1024 --bpp=24 --control=joystick --prop:/sim/traffic-manager/enabled=0 ## disable mouse mode 'fly': --prop:/input/mice/mouse/mode/button[2]/binding/value=2
Using fgfsrc for debugging
For debugging purposes, like when using gdb, it might be easier for you to arrange a .fgfsrc with minimal options enabled. See troubleshooting crashes for further info. A template for a debug .fgfsrc file could for example be:
Note You will have to direct --fg-root towards your $FGDATA folder.
|
--fg-root=
--ignore-autosave
--airport=ksfo
--offset-distance=4000
--offset-azimuth=90
--altitude=500
--heading=0
--model-hz=60
--disable-random-objects
--prop:/sim/rendering/texture-compression=off
--prop:/sim/rendering/quality-level=0
--prop:/sim/rendering/shaders/quality-level=0
--disable-ai-traffic
--prop:/sim/ai/enabled=0
--aircraft=ufo
--disable-sound
--prop:/sim/rendering/random-vegetation=0
--prop:/sim/rendering/random-buildings=0
--disable-specular-highlight
--disable-ai-models
--timeofday=noon
--disable-clouds
--disable-clouds3d
--fog-fastest
--visibility=5000
--disable-distance-attenuation
--disable-enhanced-lighting
--disable-real-weather-fetch
--prop:/sim/rendering/particles=0
--prop:/sim/rendering/multi-sample-buffers=0
--prop:/sim/rendering/multi-samples=1
--prop:/sim/sceneryloaded-override=1
--prop:/sim/rendering/draw-mask/aircraft=0
--prop:/sim/rendering/draw-mask/models=0
--prop:/sim/rendering/draw-mask/clouds=0
--prop:/sim/rendering/draw-mask/terrain=0
Please feel free to add other useful options to the temporary and basic ones!!!