Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Overview CONTENTS
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 2 of 30
Positions of aircraft components are given relative to the datum reference point for the aircraft, in the
order: longitudinal, lateral, vertical. The convention for positions is positive equals forward, to the right,
and vertically upward. Units are in feet.
The datum reference point itself is specified in the weight_and_balance section.
[fltsim.n]
Each [fltsim.n] section of an aircraft configuration file represents a different version (configuration) of the aircraft, and is known as a configuration
set. Configuration sets allow a single aircraft container to represent several aircraft, and allow those aircraft to share components.
If there is only one section (labeled [fltsim.0]), it is because there is only one configuration set in that aircraft container. If there is more than one
configuration set (labeled [fltsim.0], [fltsim.1], [fltsim.2], and so on), each one refers to a different version of the aircraft.
For instance, there are several versions of the Cessna 172, all housed in the same C172 aircraft container (folder). The various versions must vary
by their title, and may also vary other items such as the panel, description, and sounds.
While these configuration sets share many components, they can each use different panels. The panel= line in the respective fltsim sections thus
refer to the respective panel folder for each aircraft: For example, panel=ifr means that this version of the C172 uses the panel files in the panel.ifr
subfolder.
When creating and referencing multiple model, panel, sound, and texture directories, use the naming convention foldername for all common files
between all vehicle versions and foldername.extension for files unique to each vehicle version, where the extension is a unique identifier for that
configuration set (for example, .ifr). To refer to the folder from the relevant parameter in the aircraft.cfg file, just specify the extension (for example,
panel=ifr).
The parameters in each configuration set can refer to the same files, to different files, or to a mix of files. While using different panels, all Cessna
configurations use the same sounds, and thus the sound parameters in all the fltsim sections point to the single sound folder in the C172 folder.
Each aircraft defined by a configuration set will appear as a separate listing in the Select Vehicle dialog box. The fact that multiple aircraft share
some components is hidden from the user. From a user's perspective, they are distinct aircraft (just as if all the common files were duplicated and
included in three distinct aircraft containers). From a developer's perspective, the aircraft are really just different configuration sets of the same
aircraft. Because they share some files, they make much more efficient use of disk space.
Within each [fltsim.n] section are parameters that define the details of that particular configuration set:
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 3 of 30
Specifies, in RGB
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 4 of 30
[general]
In addition to the fltsim sections, the general section contains information related to all variations of the aircraft.
editable Unused.
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 5 of 30
[pitot_static]
The vertical_speed_time_constant parameter can be used to tune the lag of the Vertical Speed Indicator for the aircraft:
l Increasing the time constant decreases the lag, making the gauge react more quickly.
l Decreasing the time constant increases the lag, making the gauge react more slowly.
l A value of 0 effectively causes the indication to freeze. If an instantaneous indication is desired, use an excessively large value, such as 99.
l If the line is omitted, the default value is 2.0.
pitot_heat Scale of heat effectiveness, or 0 if not available. Mooney Bravo( pitot_heat = 1.0 )
[weight_and_balance]
The weight and center of gravity of the aircraft can be affected through the following parameters.
Note
In the stock aircraft, the station_load.0, 1, etc. parameters are enclosed in quotation marks. These are used by internal language translation
tools.
Moments of Inertia
A moment of inertia (MOI) defines the mass distribution about an axis of an aircraft. A moment of inertia for a particular axis is increased as mass is
increased and/or as the given mass is distributed farther from the axis. This is largely what determines the inertial characteristics of the aircraft.
The following weight and balance parameters define the MOIs of the empty aircraft, so the values should not reflect fuel, passengers or baggage.
The simulation engine determines the total MOIs with these additional, and variable, influences. The units are slugs per foot squared. Omission of a
parameter will result in the use of a default value set in the .air file, if one exists.
These values can be estimated with the following formula:
l MOI = EmptyWeight * (D^2 / K)
Where:
This formula yields only rough estimates. Actual values vary based on aircraft material, installed equipment, and number of engines and their
positions.
Offset (in feet) of the aircraft's reference datum from the standard
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 6 of 30
Beech Baron 58
Offset (in feet) of the center of gravity of the basic empty aircraft
empty_weight_cg_position ( empty_weight_CG_position = -
(no fuel, passengers, or baggage) from the datum reference point .
6.06, 0, 0 )
This field is the string name that is used in the Payload dialog (15
character limit). Omission of this will result in a generic station name Mooney Bravo( station_name.1 =
station_name.0
being used. "Front Passenger" )
to
station_name.n
Note that the station name can also follow the station_load
information.
Beech Baron 58
empty_weight_pitch_moi The moment of inertia (MOI) about the lateral axis. ( empty_weight_pitch_MOI =
3905.65 )
Beech Baron 58
empty_weight_roll_moi The moment of inertia (MOI) about the longitudinal axis. ( empty_weight_roll_MOI =
2718.64 )
Beech Baron 58
empty_weight_yaw_moi The moment of inertia (MOI) about the vertical axis. ( empty_weight_yaw_MOI =
5291.04 )
Beech Baron 58
( empty_weight_coupled_MOI=
The moment of inertia (MOI) about the roll and yaw axis (usually 0.0 )
empty_weight_coupled_moi
zero). Bombardier CRJ 700
( empty_weight_coupled_MOI =
0.0 )
[flight_tuning]
The elevator, aileron and elevator effectiveness parameters are multipliers on the default power of the control surfaces. For example, a value of 1.1
increases the effectiveness by 10 percent. Likewise, a value of 0.9 decreases the effectiveness by 10 percent. A negative number reverses the
normal effect of the control. Omission of a parameter results in the default value of 1.0.
Stability parameters
The pitch, roll and yaw parameters are multipliers on the default stability (damping effect) about the corresponding axis of the airplane. For
example, a value of 1.1 increases the damping by 10%. Likewise, a value of 0.9 decreases the damping by 10%. A negative number results in an
unstable characteristic about the axis. A positive damping effect is simply a moment in the direction opposite of the rotational velocity. Omission of a
parameter will result in the default value of 1.0.
Lift parameter
The cruise_lift_scalar parameter is a multiplier on the coefficient of lift at zero angle of attack Cruise lift in this context refers to the lift at relatively
small angles of attack, which is typical for an airplane in a cruise condition. This scaling is decreased linearly as angle of attack moves toward the
critical (stall) angle of attack, which prevents destabilizing low speed and stall characteristics at high angles of attack. Modify this value to set the
angle of attack (and thus pitch) for a cruise condition. A negative value is not advised, as this will result in extremely unnatural flight
characteristics. Omission of this parameter results in the default value of 1.0.
The hi_alpha_on_roll and hi_alpha_on_yaw parameters are multipliers on the effects on roll and yaw at high angles of attack. The default values
are 1.0.
The p_factor_on_yaw, torque_on_roll, gyro_precession_on_pitch and gyro_precession_on_yaw parameters are multipliers on the effects induced by
rotating propellers. These are often called "left turning tendencies" for clockwise rotating propellers. The simulation correctly handles counter-
clockwise rotating propellers. The default values are 1.0.
Drag parameters
Drag is the aerodynamic force that determines the aircraft speed and acceleration. There are two basic types of drag that the user can adjust here.
Parasitic drag is composed of two basic elements: form drag, which results from the interference of streamlined airflow, and skin friction. Parasite
drag increases as airspeed increases. Induced drag results from the production of lift. Induced drag increases as angle of attack increases.
The parasite_drag_scalar and induced_drag_scalar parameters are multipliers on the two respective drag coefficients. For example, a value of 1.1
increases the respective drag component by 10 percent. A value of 0.9 decreases the drag by 10 Percent. Negative values are not advised, as
extremely unnatural flight characteristics will result. The default values are 1.0.
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 7 of 30
hi_alpha_on_yaw
[generalenginedata]
Every type of aircraft, even a glider, should have this section in the aircraft.cfg file. Basically, this section describes the type of engine, the number
of engines, where the engines are located, and a fuel flow scalar to modify how much fuel the engine requires to produce the calculated power.
engine.0 Offset of the engine from the datum reference point. Each engine Beech Baron 58( Engine.0 = -1.4, -
to location specified increases the engine count (maximum of four 5.3, 0.0 )
engine.n engines allowed).
Scalar for modifying the fuel flow required by the engine(s). A value
of less than 1.0 causes a slower fuel consumption for a given power Beech Baron 58( fuel_flow_scalar=
fuel_flow_scalar
setting, a value greater than 1.0 causes the aircraft to burn more fuel 0.9 )
for a given power setting.
The default maximum rate that oil will leak when the malfunction is default_oil_leak_rate = 0.05 (20
default_oil_leak_rate
selected. This rate is specified as percent per second. seconds for total leak)
The percentage of max oil pressure in which the pressure will drop
pct_oil_pressure_on_failure =
pct_oil_pressure_on_failure with a 100% failure of the oil system. Default is 0. This may be useful
0.55
if it is desired that the pressure does not drop to zero under failure.
[turbineenginedata]
A turbine engine ignites fuel and compressed air to create thrust. These parameters define the power (thrust) output of a given jet turbine engine.
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 8 of 30
[jet_engine]
The thrust_scalar parameter scales the calculated thrust for jet engines (thrust taken from the [TurbineEngineData] section).
[electrical]
These parameters configure the characteristics of the aircraft's electrical system and its components. Each aircraft has a battery as well as an
alternator or generator for each engine.
Below is a table of electrical section parameters shown with default values for Bus Type, Max Amp Load and Min Voltage (the values applied if the
parameters are omitted). The default Min Voltage equals 0.7*Max Battery Voltage. The list of components also reflects all of the systems currently
linked to the electrical system. If a component is included in the list but the aircraft does not actually have that system, the component is simply
ignored.
Bus Type
Specifies which bus in the electrical system the component is connected to, according to the following bus type codes:
1 Avionics Bus
2 Battery Bus
Max Amp Load is the current required to power the component, and of course becomes the additional load on the electrical system.
Min Voltage
Min Voltage is the minimum voltage required from the specified bus for the component to function.
autopilot Bus type, max amp, min voltage Mooney Bravo( autopilot = 0, 5 , 17.0 )
pitot_heat Bus type, max amp, min voltage Mooney Bravo( pitot_heat = 0, 2 , 17.0 )
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 9 of 30
starter1 Bus type, max amp, min voltage Mooney Bravo( starter1 = 0, 20, 17.0 )
light_nav Bus type, max amp, min voltage Mooney Bravo( light_nav = 0, 5 , 17.0 )
light_taxi Bus type, max amp, min voltage Mooney Bravo( light_taxi = 0, 5 , 17.0 )
light_panel Bus type, max amp, min voltage Mooney Bravo( light_panel = 0, 5 , 17.0 )
Beech Baron 58
( generator_alternator_voltage = 28.0 )
Bombardier CRJ 700
generator_alternator_voltage Voltage of the generators or alternators.
( generator_alternator_voltage = 25.0 )
DeHavilland Beaver DHC2
( generator_alternator_voltage = 28 )
Beech Baron 58
( max_generator_alternator_amps =
60.0 )
Bombardier CRJ 700
max_generator_alternator_amps Maximum generator/alternator amps. ( max_generator_alternator_amps =
40.0 )
DeHavilland Beaver DHC2
( max_generator_alternator_amps =
50 )
[contact_points]
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 10 of 30
You can configure and adjust the way aircraft reacts to different kinds of contact, including landing gear contact and articulation, braking, steering,
and damage accrued through excessive speed. You can also configure each contact point independently for each aircraft, and there is no limit to the
number of points you can add. When importing an aircraft that does not contain this set of data, the program will generate the data from the .air file
the first time the aircraft is loaded, and then write it to the aircraft.cfg.
Each contact point contains a series of values that define the characteristics of the point, separated by commas. A contact point has 16 parameters,
described in the following table:
Contact Point
Parameter (and Element Description
example)
Integer defining the type of contact point: 0 = None, 1 = Wheel, 2 = Scrape, 3 = Skid, 4 = Float,
1 (1) Class
5 = Water Rudder
Longitudinal
2 (-18.0) The longitudinal distance of the point from the datum reference point.
Position
3 (0) Lateral Position The lateral distance of the point from the datum reference point.
4 (-3.35) Vertical Position The vertical distance of the point from the datum reference point.
Impact Damage
5 (3200) The speed at which an impact with the ground can cause damage (feet/min).
Threshold
8 (180) Steering Angle The maximum angle (positive and negative) that a wheel can pivot (degrees).
This is the distance a landing gear is compressed when the empty aircraft is at rest on the ground
9 (0.25) Static Compression (feet). This term defines the "strength" of the strut, where a smaller number will increase the
"stiffness" of the strut.
Ratio of Maximum
Ratio of the max dynamic compression available in the strut to the static value. Can be useful in
10 (2.5) Compression to
coordinating the "compression" of the strut when landing.
Static Compression
This ratio describes how well the ground reaction oscillations are damped. A value of 1.0 is
considered critically damped, meaning there will be little or no osciallation. A damping ratio of 0.0
11 (0.90) Damping Ratio is considered undamped, meaning that the oscillations will continue with a constant magnitude.
Negative values result in an unstable ground handling situation, and values greater than 1.0
might also cause instabilities by being "over" damped. Typical values range from 0.6 to 0.95.
The amount of time it takes the landing gear to fully extend under normal conditions (seconds). A
12 (1.0) Extension Time
value of zero indicates a fixed gear.
The amount of time it takes the landing gear to fully retract under normal conditions (seconds). A
13 (4.0) Retraction Time
value of zero indicates a fixed gear.
14 (0) Sound Type This integer value will map a point to a type of sound:
0 = Center Gear,
1 = Auxiliary Gear,
2 = Left Gear,
3 = Right Gear,
4 = Fuselage Scrape,
7 = Aux1 Scrape,
8 = Aux2 Scrape,
9 = Tail Scrape.
This is the speed at which landing gear extension becomes inhibited (knots). Not used for scrape
15 (0) Airspeed Limit
points or non-retractable gear.
Damage from The speed above which the landing gear accrues damage (knots). Not used for scrape points or
16 (200)
Airspeed non-retractable gear.
Each contact point's data set takes the form "point.n=", where "n" is the index to the particular point, followed by the data.
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 11 of 30
One of:
None = 0
Pump = 1 Bombardier CRJ 700
emergency_extension_type
Gravity = 2 ( emergency_extension_type=2 )
Hydraulic backup reserve = 3 (Needs
[hydraulic_system] backup_reserve = 1)
>
[gear_warning_system]
The following parameters define the functionality of the aircraft's gear warning system. This is generally a function of the throttle lever position and
the flap deflection.
The throttle limit, below which the gear warning will activate if the gear is not
down and locked while the flaps are deflected to at least the setting for Mooney Bravo
pct_throttle_limit
flap_limit_idle below. This flap limit can be 0 so that the warning effectively is a ( pct_throttle_limit = 0.1 )
function of the throttle. A value between: 0 (idle) and 1.0 (Max throttle).
In conjunction with the throttle limit specified above, this limit is the flap Mooney Bravo( flap_limit_idle
deflection, above which the warning will activate if the gear is not down and = 0.0 )
locked while the throttle is below the limit specified above. By setting this limit Beech Baron 58
flap_limit_idle
to a value greater than zero, the pilot can reduce the throttle to idle without ( flap_limit_idle = 0.0 )
activating the warning. This is often utilized in jets to decelerate/descend the Beech King Air 350
aircraft. ( flap_limit_idle = 15.0 )
Mooney Bravo
( flap_limit_power = 16.0 )
The flap limit, above which the warning will activate (regardless of throttle Beech Baron 58
flap_limit_power
position). ( flap_limit_power = 31.5 )
Beech King Air 350
( flap_limit_power = 30.0 )
[brakes]
The following parameters define the aircraft's braking system:
Sets the scaling of the braking effectiveness. 1.0 is Beech Baron 58( toe_brakes_scale =
toe_brakes_scale
the default. 0.0 scales the brakes to no effectiveness. 1.0 )
[hydraulic_system]
The following parameters define the aircraft's hydraulic system:
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 12 of 30
[views]
The following parameter define the pilot's viewpoint.
zoom Zoom the view in or out from the viewpoint. Default( zoom=1.0 )
[flaps.n]
For each flap set that is on the aircraft, a corresponding [flaps.n] section should exist. Most general aviation aircraft and smaller jets only have one
set of flaps (trailing edge), but it is typical for the larger commercial aircraft to have a set of leading edge flaps in addition to the trailing edge flaps.
The number of flap sets are determined by the number of [flaps.n] sections contained in the aircraft.cfg file.
flaps-
position.0
Each element of the flaps-position array indicates the deflection angle to which the flaps will Maule M7 260C( flaps-
to
deflect (in degrees). The largest deflection angle will be the one used for full flap deflection. position.0 = -7 )
flaps-
position.n
The percentage of total lift due to flap deflection that this flap set is responsible for at full Mooney Bravo( lift_scalar =
lift_scalar
deflection. 1.0 )
The percentage of total drag due to flap deflection that this flap set is responsible for at full Mooney Bravo( drag_scalar
drag_scalar
deflection. = 1.0 )
The percentage of total pitch due to flap deflection that this flap set is responsible for at full Mooney Bravo
pitch_scalar
deflection. ( pitch_scalar= 1.0 )
Integer value that indicates what type of system drives the flaps to deflect:, one of:
0 = Electric
Mooney Bravo( system_type
1 = Hydraulic
system_type =1)
2 = Pneumatic
3 = Manual
4 = None
[radios]
There should be a radio section in each aircraft.cfg. This section configures the radios for each individual aircraft. Each of the following keywords
has a flag or set of flags, that determine if the particular radio element is available in the aircraft. A "1" is used for true (or available), and 0 for
false (or not available).
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 13 of 30
Two flags, set the first to 1 if there is a Tacan 1 receiver and the second if it
tacan.1 Tacan.1 = 1, 1, 0
supports a standby frequency.
Two flags, set the first to 1 if there is a Tacan 2 receiver and the second if it
tacan.2 Tacan.2 = 1, 1, 0
supports a standby frequency. You cannot have Tacan2 without Tacan1.
Sets the min and max frequency, in MHz, in which the aircraft's COM radios are ComFrequencyRange =
ComFrequencyRange
limited. 118 - 137 is the default range. 118.000,137.000
[lights]
Each light that requires a special effect should be entered in this section. The following table gives the codes for the switches that will turn on the
lights.
Code Switch
1 Beacon
2 Strobe
3 Navigation or Position
4 Cockpit
5 Landing
6 Taxi
7 Recognition
8 Wing
9 Logo
10 Cabin
11 General
12 Headlight
13 Brake
[keyboard_response]
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 14 of 30
The aircraft flight controls can be manipulated by the keyboard. Because flight controls naturally become more sensitive as airspeed increases, it can
become quite difficult to control the aircraft via the keyboard at high speeds. To address this problem, the amount a single keypress increments a
flight control is decreased by a factor of 1/2 at the first airspeed (in knots) listed on the line for the control, and to 1/8 at the second airspeed, and
to a scale interpolated from these values for all airspeeds in between. The example below shows that an elevator will increment by one degree when
the airspeed is zero, by ¾ of one degree at 50 knots, ½ of one degree at 100 knots, 5/16 of one degree at 140 knots, and 1/8 of one degree at 180
knots or greater speed.
aileron Two breakpoint speeds for keypress increments. Mooney Bravo( aileron = 200, 1000 )
rudder Two breakpoint speeds for keypress increments. Mooney Bravo( rudder = 200, 1000 )
[direction_indicators]
This section is used to define the characteristics of the direction indicators on the instrument panels, but does not include the magnetic compass
(which has a separate section). The list of indicators should be listed in order: 0,1,2,…n.
[attitude_indicators]
This section is used to define the characteristics of the attitude indicators on the instrument panels. The list of indicators should be listed in order:
0,1,2,...n.
[altimeters]
[turn_indicators]
This section is used to define the characteristics of the turn indicators on the instrument panels. The list of indicators should be listed in order:
0,1,2,…n.
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 15 of 30
[vacuum_system]
The following parameters define the aircraft's vacuum system:
Beech Baron 58
( electric_backup_pressure=4.900000 )
electric_backup_pressure Backup pressure in psi.
Mooney Bravo
( electric_backup_pressure=4.9 )
[pneumatic_system]
The following parameters define the aircraft's pneumatic pressure system:
The ratio of bleed-air pressure from the engines to pneumatic air pressure in Beech Baron 58
bleed_air_scalar
the pneumatic system. ( bleed_air_scalar=0.00000 )
[exits]
The following parameters define the aircraft's exits:
[effects]
The effects section of the file refers to the visual effects that result from various systems or reactions of the aircraft. An effect file associated with a
keyword in this section will be used when the corresponding action is triggered. If no entry is made a default effect file will be used. The table below
outlines the aircraft effects currently supported, though of course not all effects are supported on all aircraft.
Each entry can be followed by a 1 if the effect is to be run for a single iteration. Set this number to zero or leave blank (the default), for the effect to
continue as long as the respective action is active. Make an entry in the configuration file to replace any of these effects with a new one. Or to turn
off the effect add an entry that references the fx_dummy effect (which does nothing).
Single
Property Description Default Examples
Iteration
wake The wake effect name. fx_wake False Mooney Bravo( wake=fx_wake )
Mooney Bravo
concrete Moving on concrete. fx_sparks False
( concrete=fx_sparks )
Piper Cub
startup Engine startup. fx_engstrt True
( startup=fx_engstrt_cub )
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 16 of 30
Similar to waterrotorwash,
the effect a propeller has on
WetEngineWash fx_WetEngineWash False
wet terrain when flying
below 20m.
Similar to waterrotorwash,
the effect a propeller has on
SnowEngineWash snow covered terrain, or fx_SnowEngineWash False
when it is snowing, when
flying below 20m.
[autopilot]
The following parameters determine the functionality of the aircraft's autopilot system, including the flight director.
Navigation Modes:
The navigation and glideslope controllers utilize standard proportional/integral /derivative feedback controllers (PID). The integrator and derivative
controllers have boundaries, which are the maximum error from the controlled parameter in which these are active. It is not necessary to have all
three components active. Setting the respective control constant to 0 effectively disables that component, allowing PI or PD controllers to be
utilized. Navigation mode parameters begin with nav_ or gs_.
autothrottle_max_rpm This sets the maximum engine speed, Bombardier CRJ 700( autothrottle_max_rpm = 90 )
in percent, that the autothrottle will
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 17 of 30
attempt to maintain.
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 18 of 30
The following flags are legacy, and were enabled to allow aircraft to be configured with no pitch and/or bank modes. While these flags are still
supported, the preferred flags are included above in the respective vertical and lateral sections.
Setting this flag to 1 will cause the default pitch mode to be "None". It will actually set
the variable default_pitch_mode to zero, so that there is no default pitch mode when the See examples for
use_no_default_pitch
autopilot logic is activated. default_bank_mode
The preferred method is to test the default_bank_mode directly.
[fuel]
This section defines the characteristics of the fuel system, including the tanks, fuel type, and the number of fuel selectors. The number of fuel
selectors is intended to match the number of visual selectors on the instrument panel.
One of:
fuel_type 1 = Avgas Beech Baron 58( fuel_type = 1 )
2 = JetA
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 19 of 30
[airplane_geometry]
This section has been added mainly for reference. Although you can edit these values by hand here in the aircraft.cfg file, modification of some of
these variables will have little to no effect on airplane performance, as the flight model aerodynamic coefficients are all located in the .air file.
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 20 of 30
rudder_area Area of the side surface of the entire rudder (ft2). Beech Baron 58( rudder_area = 10.5 )
Angular limit of the elevator when deflected down Beech Baron 58( elevator_down_limit =
elevator_down_limit
(degrees). 15.5 )
rudder_limit Angular limit of the rudder deflection (degrees). Beech Baron 58( rudder_limit = 30.0 )
elevator_trim_limit Angular limit of the elevator trim tab (degrees). Beech Baron 58( elevator_trim_limit = 15.0 )
This value indicates at what minimum flap handle Bombardier CRJ 700
min_flaps_for_spoilerons
position the spoilerons become active. ( min_flaps_for_spoilerons= 0.0 )
Mooney Bravo
positive_g_limit_flaps_down Design g load tolerance (flaps down). ( positive_g_limit_flaps_down=2.000000 )
Mooney Bravo
negative_g_limit_flaps_down Design g load tolerance (negative, flaps down).
( negative_g_limit_flaps_down= -1.5 )
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 21 of 30
[reference speeds]
The values given in this section are mainly for reference, as the performance of the aircraft is held in the .air file.
Stall speed of the aircraft in a dirty (flaps full down) configuration at Beech Baron 58
full_flaps_stall_speed
standard sea level conditions, (Knots True Airspeed, KTAS). ( full_flaps_stall_speed = 75.0 )
Typical cruise speed of the aircraft in a clean (flaps up) configuration at a Beech Baron 58( cruise_speed =
cruise_speed
typical cruise altitude, (Knots True Airspeed, KTAS). 180.0 )
Maximum design indicated airspeed. Also referred to as Never Exceed Beech Baron 58
max_indicated_speed
Speed or Red Line of the aircraft, (Knots Indicated Airspeed). ( max_indicated_speed = 223 )
[forcefeedback]
As detailed in the tables below, the parameters in this section of an aircraft.cfg file define the forces generated by that aircraft if the user is
operating a force feedback joystick.
These parameters define the simulated stick shaker force felt in the stick or yoke when flying an aircraft equipped with a stick shaker (such as the
Learjet 45).
These parameters define the simulated forces transferred from the airframe and gear drag to the stick or yoke when the aircraft's nose and main
landing gear is raised or lowered (cycled). In fixed-gear aircraft this effect won't be felt because, by definition, the landing gear doesn't move.
Different aircraft have different gear geometries that result in each of the gear mechanisms starting and ending its cycle at a different time. The
timing deltas are brief, typically less than a second between the time that each gear starts and ends its cycle.
These parameters collectively define a composite force that simulates the forces felt through an aircraft's ground steering controls as the aircraft
travels over an uneven surface. The parameters are divided into two subgroups (numbered 1 and 2), and define the behavior of two distinct forces.
The combination of the two forces define a composite force that is transferred to the stick or yoke. The two forces are both sinusoidal periodic forces,
with frequencies determined by the following linear equation:
l frequency = (ground_bumps_slope * aircraft_ground_speed) + ground_bumps_intercept
The ground_bumps_magnitude parameters set the magnitude of the force. The ground_bumps_angle parameters set the direction from which the
force is felt.
Crash parameters
These parameters define the simulated forces felt in the stick or yoke when the aircraft crashes. The parameters are divided into two subgroups
(numbered 1 and 2), and define the behavior of two distinct crash-induced forces. The first force is a constant force that lasts for 0.5 seconds. After
0.5 seconds, it stops and the second force starts. The second force is a periodic square wave force; its amplitude declines linearly to 0.
Mooney Bravo
gear_bump_nose_direction Integer from 0 - 35999 degrees.
( gear_bump_nose_direction=18000 )
Mooney Bravo
gear_bump_nose_duration Integer, microseconds.
( gear_bump_nose_duration=250000 )
Mooney Bravo
gear_bump_left_magnitude Integer from 0 - 10000.
( gear_bump_left_magnitude=2700 )
Mooney Bravo
( gear_bump_left_direction=35500 )
gear_bump_left_direction Integer from 0 - 35999 degrees.
Beech Baron 58
( gear_bump_left_direction=9000 )
Mooney Bravo
gear_bump_left_duration Integer, microseconds.
( gear_bump_left_duration=250000 )
Mooney Bravo
gear_bump_right_magnitude Integer from 0 - 10000.
( gear_bump_right_magnitude=2700 )
Mooney Bravo
( gear_bump_right_direction=00500 )
gear_bump_right_direction Integer from 0 - 35999 degrees.
Beech Baron 58
( gear_bump_right_direction=27000 )
Mooney Bravo
gear_bump_right_duration Integer, microseconds.
( gear_bump_right_duration=250000 )
Mooney Bravo
ground_bumps_magnitude1 Integer from 0 - 10000.
( ground_bumps_magnitude1=1300 )
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 22 of 30
Mooney Bravo
ground_bumps_magnitude2 Integer from 0 - 10000.
( ground_bumps_magnitude2=200 )
Floating point number, from 0 to 1,000,000 cycles per Bombardier CRJ 700( ground_bumps_intercept2
ground_bumps_intercept2
second. =1.075 )
crash_magnitude1 Sets the magnitude of the first force, from 0 to 10000. Mooney Bravo( crash_magnitude1=10000 )
Beech Baron 58
stick_shaker_magnitude Integer from 0 - 10000.
( stick_shaker_magnitude=5000 )
[stall_warning]
This section defines the stall warning system of the aircraft.
stick_shaker Set to 1 if the aircraft has a stick shaker. Mooney Bravo( stick_shaker=0 )
[deice_system]
This section defines the deice system of the aircraft.
[piston_engine]
A piston engine's power can be determined through a series of equations that represent the Otto cycle of a four-stroke piston engine, multiplied by
the number of pistons available. This section contains all the information needed to be able to determine how much power the engines are capable of
producing. Power can also be scaled from the calculated values generated for piston engines with the "power_scalar" property.
supercharged On/off.
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 23 of 30
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 24 of 30
[propeller]
The thrust generated by a given propeller is a function of the power delivered through the propeller shaft, rpm, blade angle, airplane speed, and
ambient density.
Integer value indicating the number of blades on Beech Baron 58( propeller_blades= 3 )
propeller_blades
the propeller (2, 3 or 4). Beech King Air 350( propeller_blades = 4 )
Minimum blade pitch angle for constant speed Beech Baron 58( beta_min= 15.2 )
beta_min
prop (degrees). (Not used if fixed pitch.). Beech King Air 350( beta_min = 15.2 )
Blade pitch angle for fixed pitch prop (degrees). Beech Baron 58( fixed_pitch_beta= 0.0 )
fixed_pitch_beta
(Not used if constant speed.). Beech King Air 350( fixed_pitch_beta = 0 )
Mooney Bravo
Boolean to indicate if de-feathering accumulators
defeathering_accumulators_available ( defeathering_accumulators_available=
are available; 0 = FALSE, 1 = TRUE.
0)
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 25 of 30
Beech Baron 58
Minimum blade pitch angle when the aircraft is on ( minimum_on_ground_beta= 0.0 )
minimum_on_ground_beta
the ground (degrees). Beech King Air 350
( minimum_on_ground_beta = 1.0 )
Parameter that scales the calculated thrust Beech Baron 58( thrust_scalar = 1.0 )
thrust_scalar
provided by the propeller. Beech King Air 350( thrust_scalar = 1.0 )
[magneticcompass]
This section defines the magnetic compass characteristics of the aircraft.
[gpws]
This section sepcifies the details of the ground proximity warning system.
If an aircraft starts to descend during takeoff, and exceeds this rate of descent, a warning is
climbout_sink_rate_fpm
activated.
If an aircraft is landing, and exceeds this rate of descent without flaps or gear extended, a
flap_and_gear_sink_rate_fpm
warning is activated.
[cameraconfiguration]
This section shows the global camera configuration properties that can be set on a per object basis.
[cameradefinition.n]
This section shows the camera properties most used by aircraft. An aircraft can have multiple cameradefinition sections, which should be numbered
from 0 to n. For a full definition of all the properties that can be set for a camera definition, refer to the Camera Configuration document. All of the
properties described in that document can be used in an aircraft camera definition in an aircraft configuration file.
Property Examples
title DeHavilland Beaver DHC2( title = "Right Float" )
description DeHavilland Beaver DHC2( Description = "View from the aft end of the right float looking forward" )
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 26 of 30
snappbhreturn
panpbhreturn
track
showweather
xyzadjust
category
clipmode
[turboprop_engine]
The amount of power generated by an engine and the power required for a propeller to turn through the air determine the increase and decrease of
the rpm. A turboprop engine is really a combination of a turbine engine and a propeller. The values in this section are included to modify values
specific to the turboprop.
Brake power specific fuel consumption (turboprop Beech King Air 350 Paint1
powerspecificfuelconsumption
only). ( PowerSpecificFuelConsumption = 0.55 )
[airspeed_indicators]
This section is used to define the characteristics of the airspeed indicators on the instrument panels. The list of indicators should be listed in order:
0,1,2,…n. These characteristics define the calibration between calibrated airspeed and indicated airspeed.
[pressurization]
This section defines the pressurization characteristics of the aircraft.
max_pressure_differential
[variometers]
This section defines the variometers characteristics of the aircraft.
[yaw_string]
This section defines the yaw string characteristics of the aircraft.
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 27 of 30
[smokesystem]
The section describes how to configure a smoke system for an aircraft. You can set multiple smoke points on an aircraft.
[folding_wings]
This section describes the folding wing characteristics of the aircraft. Note that these are folding wings used to store an aircraft more compactly
when on the ground, or on deck, and not the variable sweep wings used on some supersonic aircraft. Variable sweep wings are not supported.
fold_rates Two values (for left and right), giving the percentage per second, to fully extend and retract.
[anemometers]
This section describes the positions of the anemometers in the aircraft.
[realismconstants]
This section describes some realism constraints, dealing in particular with early aircraft. The values entered are used to make an aircraft more
stable.
rollmomentfromailerons Scale and offset applied to the roll moment from the ailerons.
[antidetonation system.n]
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 28 of 30
reservoir_size Gallons.
Manifold pressure above which AntiDetonation system cannot compensate for. Units are inches of
max_mp_compensate
mercury.
[nitrous system.n]
[tailhook]
If a tailhook entry is made, it will override the attachpt_tailhook_pivot and attachpt_tailhook_hook entries for the aircraft, if these attach
points exist.
A scalar value applied to the arrestor cable forces acting upon the aircraft when
cable_force_adjust cable_force_adjust = 1.0
hooked.
A scalar value applied to the arrestor cable moment of force acting upon the aircraft cable_moment_adjust =
cable_moment_adjust
when hooked. 0.2
[launch_assistance]
If a launch_assistance entry is made, it will override the attachpt_Launch_Bar_Pivot and attachpt_Launch_Bar_Lug entries for the aircraft, if
these attach points exist.
launch_bar_lug Launch bar lug point relative to datum reference point. launch_bar_lug = 5.0, 0.0, -4.5
[voicealerts]
overglimit High G limit, check above (1) or below (-1), and check every N seconds.
The following sections are specific to helicopters only. The implementation of the Bell 206 helicopter is a legacy implementation that cannot be
configured by changing data in the configuration file. The [helicopter] section is the only helicopter-specific section that is used by the Bell 206.
Other helicopter models do use the data in the configuration file to determine their aerodynamic performance, and utilize all the following helicopter-
specific sections.
[helicopter]
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 29 of 30
The cross section area of the fuselage, in feet squared, as Robinson R22( reference_frontal_area
reference_frontal_area
viewed from head on to the helicopter. = 17.7 )
Total side area of the fuselage, in feet squared, as viewed Robinson R22( reference_side_area =
reference_side_area
from directly abeam of the helicopter. 44.5 )
The longitudinal position, in feet, from the datum of the Robinson R22( side_aero_center = -
side_aero_center
helicopter that represents the lateral aerodynamic center. 12.5 )
Scalar on the amount of roll control authority from lateral Robinson R22
cyclic_roll_control_scalar
movement of the cyclic. ( cyclic_roll_control_scalar =1.0 )
Scalar on the amount of yaw control authority from Robinson R22( pedal_control_scalar
pedal_control_scalar
movement of the anti-torque pedals. =1.0 )
[fuselage_aerodynamics]
pitch_damp_cf Pitch damping coefficient (resistance to pitch velocity). Robinson R22( pitch_damp_cf = -2.0 )
roll_damp_cf Roll damping coefficient (resistance to roll velocity). Robinson R22( roll_damp_cf = -2.0 )
yaw_damp_cf Yaw damping coefficient (resistance to yaw velocity). Robinson R22( yaw_damp_cf = -0.1 )
yaw_stability_cf Yaw stability coefficient. This is the weathervane effect. Robinson R22( yaw_stability_cf = 0.27 )
[mainrotor]
static_pitch_angle When the stick is centered, the pitch angle of the rotor disk, in degrees.
static_bank_angle When the stick is centered, the bank angle of the rotor disk, in degrees.
Position relative to datum reference point. This position should be the center of Robinson R22( Position = -8.5,
position
the main rotor. 0, 4.91 )
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017
Aircraft Configuration Files Page 30 of 30
The maximum absolute deflection angle up or down, in degrees, that the rotor Robinson R22( max_disc_angle
max_disc_angle
disc can move with the cyclic. = 5.0 )
Robinson R22
number_of_blades The number of blades in the rotor.
( Number_of_blades = 2 )
Robinson R22
weight_per_blade Approximate weight, in pounds, of each rotor blade.
( Weight_per_blade = 26.0 )
The constant used in calculating the moment of inertia of the rotor disc. The MOI Robinson R22
weight_to_moi_factor algorithm is a function of the number of blades, their weight, and this constant. ( Weight_to_moi_factor =
Increasing this constant will increase the inertia of the disc. 0.58 )
Robinson R22
The reference inflow velocity of the air mass moving through the rotor disc.
inflow_vel_reference ( inflow_vel_reference =
Increasing this value will result in more thrust being generated.
34.0 )
[secondaryrotor]
tailrotor This flag, if set to 1, configures the secondary rotor as a tail rotor, or anti-torque. Robinson R22( TailRotor = 1 )
radius The radius of the rotor, in feet. Robinson R22( Radius = 1.75 )
[sling.n]
There can be multiple sling positions on an aircraft, each with its own set of the following properties.
hoist_payload_station Payload station in which the hoist will load in and out of. 1 is first station.
[turboshaft_engine]
A turboshaft engine on a helicopter is very similar to a turboprop engine on a fixed wing aircraft.
- top -
mk:@MSITStore:H:\Prepar3D%20v4\Learning%20Center.chm::/sdk/simulation_obje... 09/12/2017