Diese Website verwendet Cookies. Wenn Sie die Website weiterverwenden, erklären Sie sich damit einverstanden und akzeptieren außerdem die Datenschutzrichtlinie.

FlyAgi Tweak Utility - Manual

Site Admin
Beiträge: 520
Registriert: Sa 29. Apr 2017, 01:42

FlyAgi Tweak Utility - Manual

Beitrag von Agi » Mi 10. Okt 2018, 19:02

The manual is matching FTU version 1.09f.

Main Menu

The utility main menu can be opened by clicking on the menu helper 'Tweak Utility Options' on the lower right corner of the screen or by using the FlyWithLua macros menu (X-Plane menu bar > Plugins > FlyWithLua > Macros > FlyAgi Tweak Utility). The main page gives access to the essential performance and visual tweaks and links to submenus if configuration items are more complex - I will explain the different submenus and what they can do later.

The utility will always store the menu page last opened for quick access to submenus so you will get back to the menu page you have been in before closing the main menu. The menu can be closed by clicking on the button 'Save + Close Menu' or by clicking on the helper again. In both cases everything will get saved.



There are two preset buttons available, Utility Defaults and X-Plane Defaults. The first one activates all static tweaks and optimizes for better performance, the second one resets all those tweaks to X-Plane's default values.

The presets don't control all the stuff the utility can handle, they only set the most important static performance tweaks:
  • Water Effects
  • Clouds
  • Clouds white out
  • Road Traffic


LOD ist the range for objects to be visible, higher range will decrease performance and lower range will increase performance. The LOD button can be used to set up a specified LOD value or to activate an automatic LOD control. The automatic LOD control will increase or decrease the LOD depending on frame rate.

FPS Target

The FPS target defines the target frame rate for the automatic LOD control. If the frame rate is higher than this value the LOD will increase slowly, if the frame rate is lower the LOD will decrease slowly - this way you can get stable frame rates within the capability of your hardware. If you want to fly at stable 30 FPS you should set the FPS target to 30, if you want to maintain 60 FPS you should set it to 60.

This item is only available if LOD is set to auto.

Extended DSFs

This button is more or less for testing. You can switch off the extended DSFs by pressing this button but this will cause a scenery reload to have an effect. If X-Plane does not seem to react any more just be patient and don't click around - this could cause Windows to suspect X-Plane to be crashed and then really cause a crash. If you want to disable extended DSFs permanently I recommend doing this in the Settings.txt as this value will not be saved by the utility (saving and restoring this tweak would increase loading times drastically).


The clouds button switches between default X-Plane clouds and significantly faster modified clouds. The fast clouds are looking more natural in most situations and don't result in excessive GPU load when flying near, in or above clouds. Further, there is a second button for disabling the white or grey out effect when flying trough clouds.

If X-Visibility is installed and active the white out effect is always disabled as X-Visibility handles this tweak itself.

Water Effects

You can switch on and off the water effects for getting a significant boost in frame rates.

Road Traffic

The X-Plane road traffic still has a significant impact on performance so it can be disabled using this setting.


The fog button allows to increase or decrease the thickness of the fog. If X-Visibility is installed it will be replaced with a submenu for X-Visibility fog control. X-Visibility can be disabled there as well if you need manual fog control.

Shadow Options

Opens the shadow options submenu.

Aicraft Persistance

Turns per aircraft saving for many additional items on and off. If you enable this option many aircraft settings will get saved and restored for the current aircraft so you will find it in the state your left it after your last flight. Please have in mind that not every aircraft can be restored completely as the utility can't access many custom coded systems in more complex third party aircraft. Radio and advanced avionics setting (eg the settings for the G1000 or GNS 530) are not included currently.

The following aircraft are tested and can be restored completely so far (possibly others as well but I don't know):
  • Laminar C172
  • Laminar Stinson L5
  • Vskylabs EuroFox
  • Vskylabs SF-25C Falke
  • Vskylabs Phoenix Ultralight
  • Dmax3d Tecnam P2002

Fuel Tank Selector

The fuel tank selector can automatically switch fuel tanks for aircraft without a fuel tank lever both position.

Auto Baro + Gyro

If on, the barometric pressure and the gyro compass will be set up and readjusted automatically.

Sound Options

Opens the sound menu. The second button allows to enable or disable the sounds completely without opening the sound menu.

View Options

Opens the view options submenu. The view options let you configure an aircraft's default view.

Controller Calibration

Opens the controller calibration submenu.

Weight & Balance

Opens the weight and balance menu. The button can be configured to access some third party payload managers instead of the X-Plane default weight and balance menu.

XPrealistic Pro Options

If you are using XPrealistic Pro the utility will give you a quick access button for the XPR main menu and a helper next to the utility's main menu helper at the bottom of the screen. You can enable the helper with the XPrealistic helper option.

Bird Strikes

Opens the bird strikes submenu.

Mission Generator

If you have the Mission generator add on installed the utility can give you acces to some of the Mission Generator options in a dedicated submenu.

Reset User Interface

Resets the interface configuration: FPS display, menu helper, status info state and status info position will be set to default values.

Info + Credits

Opens the info and credits submenu.


Opens the launcher submenu.


This button creates a synchronization file containing most of your settings. You should set this up once you have setup everything to your liking if you want to use the same setup in other aircraft as well. If you want to synchronize a new aircraft just load the aircraft and click on 'Synchronize Aircraft' and your settings from the original one will be loaded into the new aircraft.

FPS Display

Turns the FPS display on and off.

Status Info

You can change the position of the status report for avoiding conflicts with some third party aircraft configuration menu helpers and, if needed, make the status report permanently visible and adjust the time frame it is displayed after closing the main menu and on startup.

Menu Helper

Switches the menu helper on or off.

X-Visibility Menu

The X-Visibility Menu allows configuring the X-Visibility plugin on the fly, there is no need to restart X-Plane or reload lua scripts.


X-Visbility On/Off

Enables and disables the X-Visibility plugin. If X-Visibility is disabled you will get a normal fog intensity button instead of the X-Visibility options.

Max Visibility Alt

Defines the altitude at which the maximum visibility is applied. This is the altitude at which the haze gets reduced drastically for higher visibility.

Max Visbility Fog

Defines the haze density at maximum visbility altitude.

Low Alt Fog

Defines the haze density at very low altitude.

High Alt Fog

Defines the haze density at higher altidtudes (above low and below max visibility altitude).

Reset X-Visbility

Sets the default values for the X-Visibility plugin.

Regenerate Weather

Regenerates the clouds rendering. This is useful to check if your settings look good in different cloud arrangements.

Shadow Options

The shadow options menu lets you set up some useful shadow parameters. Be careful as some of these options can affect your performance negatively.


Cockpit Shadows Quality

Adjust the basic cockpit shadows quality. Values below 3 reduce the quality but possibly can help you get better performance with older or less powerful graphics cards but this also decrases visual quality drastically.

Cockpit Shadow Distance

This value defines at which distance the aircraft shadows are treated as cockpit shadows. Increasing this value will possibly give you better quality shadows inside the cockpit and outside on the ground, if you set values high enough.

Cloud Shadows Intensity

Sets the darkness of the cloud shadows. This can be setup the way it looks right for you and should not have any influence on performance.

Cloud Shadows Resolution

Sets the resolution for the cloud shadows. Higher values can reduce cloud flickering but also have a massive impact on performance.

Aicraft And Scenery Shadows Quality

Adjusts the basic quality for aircraft and scenery shadows. This may have an impact on performance.

Aicraft And Scenery Shadows Resolution

Sets the resolution for aircraft and scenery shadows. This setting can help you get much sharper shadows inside the cockpit but can have an impact on performance when used on low or mid level graphics cards.

Aicraft And Scenery Shadows Distance

Defines the distance for aircraft and scenery shadows to be visibly. Higher values will result in less performance.

Aicraft And Scenery Shadows Minimum Angle

Used together with Aicraft And Scenery Shadows Maximum Angle you can optimize the low angled shadows and improve the visual quality of shadows on the aircraft at dawn or dusk.

Aicraft And Scenery Shadows Maximum Angle

Used together with Aicraft And Scenery Shadows Minimum Angle you can optimize the low angled shadows and improve the visual quality of shadows on the aircraft at dawn or dusk.

Reset Shadows

Rests all shadows to X-Plane default values or those found on utility startup if altered by other scripts.

Regenerate Weather

Regenerates the clouds rendering. This is useful to check if your settings look good in different cloud arrangements.

Scenery Shadows On/Off

Indicates if scenery shadows ar enabled or disbaled in the X-Plane graphics menu. Clicking the button will open X-Plane settings.

Sound Options

The sounds menu lets you manage the sounds coming with the tweak utility.


Sounds On/Off

Enables or disables all tweak utility sounds.

Master Volume

Defines the sound engines master volume. This option affects all sounds at once.

Wind Sounds On/Off

Enables or disables the wind sound.

Wind Volume

Sets the wind sound maximum volume.

Wind Pitch

Sets the wind sound pitch. This is useful to modify the wind sound so it gets more or less agressive. Adjust this until the sound is enjoyable to you.

Wind Max Volume Speed

The wind sound is depending on airspeed. This option sets the speed at which the wind sound is at maximum volume.

Rain Sounds On/Off

Enables and disables the rain sound.

Rain Volume

Sets the rain sound volume.

Heavy Rain Threshold

Sets the threshold for the heavy rain sound to activate.

Rattle Sounds On/Off

Enables and disables the rattle sounds. The button also allows setting the rattle sound to activate on ground, by turbulence or in both situations. The turbulence rattle depends on some X-Plane native weather parameters so it will possibly not work with some third party weather injectors not setting the needed datarefs.

Rattle Volume

Sets the rattle sound maximum volume.

Rattle Pitch

Sets the rattle sound pitch. This is useful to modify the rattle sound. Adjust this until the sound is enjoyable to you.

Rattle Max Volume Turbulence

Sets the turbulence value at which the rattle sound maximum volume is applied for turbulence rattle effects.

Rattle Max Volume Speed

Sets the speed at which the rattle sound maximum volume is applied for ground rattle effects.

Reset Sounds

Resets all sounds to the utility's default values.

Save Volume Sliders On/Off

This enables the per aircraft saving for X-Plane's own volume control sliders so you can setup different volume configurations for every aircraft. This is a global setting and is either on or off for all aircraft.

View Options

View options allow customization of your aircraft's default view. If you modify the default view please also assign the corresponding command to your default view key (usually W on the keyboard) in the X-Plane keyboard or controller assignment menu. All view options are store per aircraft so the view options allow to set different field of views on different aircraft.


Screen Center

Sets the screen center position vertically. This value allow to change the view's angle up and downwards.

Lat Position

Changes the lateral position of the camera.

Vert Position

Changes the vertical position of the camera.

Long Position

Changes the longitudinal position of the camera.

Field Of View

Changes the field of view.

Non Proportional FOV On/Off

Enables and disables the adjustment of non proportional field of view.

Controller Options

The controller options add a simple way to create null or dead zones and adjust center zones for the pitch, roll and yaw axes. The center zone adjustment is useful if the automatic calibration does not result in a really neutral ceneter position so the controls feel asymetrical and weird. The null zone adjusment allows to get simple null zones just as in FSX or P3D without the need of complex response curve editing.

For completeness the menu also gives access to the sensitivity and stability setting you also find in the X-Plane controller calibration and adds the ability to adjust trim time (trim speed) for all three axes.


Pitch/Roll/Yaw Nullzone

Sets the nullzone for the corresponding axis.

Pitch/Roll/Yaw Center

Sets the center/neutral position for the corresponding axis.

Pitch/Roll/Yaw Sensitivity

Sets the sensitivity for the corresponding axis.

Pitch/Roll/Yaw Stability

Sets the stability for the corresponding axis.

Pitch/Roll/Yaw Trim Time

Sets the trim time for the corresponding axis. This can be used for modification of aircraft behaving unconveniently fast or slow when trimming.

Pitch/Roll/Yaw Trim

Shows and sets the current trim position. This is more or less useless in most cases but if you have troubles with aircraft behaving weird you can check the trim states here and possibly find an issue (eg when aircraft persistance is on, trim settings are restored and not in the default position after startinga flight).

Further, you can try to correct unwanted roll/bank behaviour with the roll trim setting on aircraft without roll trim equiped. Enable the roll correction feature and set the roll trim value so your aircraft does roll the way you like it.

Roll Correction On/Off

If this is option is enabled you can use the roll trim button to correct unwanted roll behaviour for your aircraft.

Reset Trim Time

Resets the trim time values to the aircraft's default values.

Center Trim

Centers all trim values.

Launcher Options

The launcher configures some global settings (nothing in this menu is saved per aircraft) and can shut down and restart the tweak utility without the need of restarting X-Plane. It further shows the state of the loaded files and modules for simple diagnostic purposes.


Tweak Utility On/Off

Enables and disables the tweak utility. There are further options depending on the tweak utility state (on or off):
  • Active/Inactive indicate if the utility is running or not
  • Restart allows to relaunch the main script and all save files
  • Session only starts the utility for this flight session only. The utility will be disabled on the next flight and after changing the airport or the aircraft.

For Unconfigured Aircraft

Defines how the utility deals with aircraft which are not yet configured. Default value is 'auto open menu' but you can also set it up to do nothing or automatically synchronize with your sync settings (you have to create a sync file in the main menu first).

3rd Party WX Protection

For a smoother integration and less interferences the utility disables some options if either SkyMaxx Pro, UltraWeather XP or xEnviro is installed. Disabling the protection gives you access to all the utility options regardless of possibly occuring interferences or problems.

Sound Engine On/Off

The sound engine can be turned off completely if you don't need it at all. If you do so the sounds menu will disappear from the main menu.

Save Volume Sliders On/Off

This enables the per aircraft saving for X-Plane's own volume control sliders so you can setup different volume configurations for every aircraft.

Reset Launcher

Resets the launcher to default values.

Bird Strikes Menu

This menu lets you configure if, how often and under which circumstances bird strikes should occur. There is also a damage handling system so you can see survive bird strikes or just use the birds as some kind of decoration.

Don't use the bird strikes and especially the damage control system if you want to use the default X-Plane failures - the damage control system resets other failures as well.


Bird Strikes On/Off

Enables and disables bird strikes.


Sets the time intervall for bird strikes to occur.

Min Alt AGL

Sets the minimum altitude above ground level for bird strikes to occur.

Max Alt AGL

Sets the maximum altitude above ground level for bird strikes to occur.

Damage Controls On/Off

Enables and disables the damage handling system. Technically you will always recieve damage but the damage control, if enabled, will repair your aircraft instantly. On some aircraft with build in bird strikes effects this result in inconsistant situations where you see for example a damaged windshield for some seconds but technically your aircraft is not damaged.

Damage On

Specifies if you will recieve damage from bird strikes.

Damage On Ground On/Off

Specifies if you will recieve damage from bird strikes if your aircraft is on ground.

Min Damage Speed

Sets the minimum speed for bird strikes to damage your aircraft. This is useful if you want to see birds on ground but don't want to get damaged when standing still or rolling very slowly.

Damage By Chance On/Off

Enables and disables damage recieving by chance.

Chance To Be Hit

Defines the chance for bird strikes to damage your aircraft.

Reset Bird Strikes

Resets the bird strikes configuration to the utility's default values.

Force Bird Strike

Forces a bird strike to happen immediately.

Aircraft Hit Message On/Off

Enables and disables the onscreen notice telling you if you got damaged by a bird strike. This message can be used to instantly repair your aircraft if you click on it as long as it shows up. The message will disappear after some seconds, if you want to repair after this period of time you can do so opening the bird strikes menu, which will tell you if you got hit with a message button as well.