Aircraft.cfg

The Aircraft.cfg file represents the highest level of organization within an aircraft container. This file specifies the aircraft that are included in the aircraft container, as well as what the attributes (name, color, sound, panels, gauges, and so on) are for each aircraft and where to find the files that specify those attributes. The following example shows the contents of an Aircraft.cfg file.

Note: If a parameter isn't explicitly set, it automatically refers to the default directory. If you want multiple aircraft, texture, sound, panel, and model directories, use the directory naming convention directoryname.extension. To refer to the directory, just specify extension for the parameter.

[fltsim.0]

title=Cessna Skylane 182R RG

sim=Cessna182RRG

model=rg

panel=rg

sound=

texture=rg

checklists=Cessna182RRG_check

[fltsim.1]

title=Cessna Skylane 182S

sim=Cessna182S

model=

panel=

sound=

texture=

checklists=Cessna182S_check

[forcefeedback]

gear_bump_nose_magnitude=6000; 0–10000

gear_bump_nose_direction=18000; 0–35999 degrees

gear_bump_nose_duration=250000; in microseconds

gear_bump_left_magnitude=6000; 0–10000

gear_bump_left_direction=35500; 0–35999 degrees

gear_bump_left_duration=250000; in microseconds

gear_bump_right_magnitude=6000; 0–10000

gear_bump_right_direction=00500; 0–35999 degrees

gear_bump_right_duration=250000; in microseconds

ground_bumps_magnitude1=3250; 0–10000

ground_bumps_angle1=8900; 0–35999 degrees

ground_bumps_intercept1=5.0

ground_bumps_slope1=0.48

ground_bumps_magnitude2=750; 0–10000

ground_bumps_angle2=9100; 0–35999 degrees

ground_bumps_intercept2=0.075

ground_bumps_slope2=1.0

crash_magnitude1=10000; 0–10000

crash_direction1=01000; 0–35999 degrees

crash_magnitude2=10000; 0–10000

crash_direction2=9000; 0–35999 degrees

crash_period2=75000; in microseconds

crash_duration2=2500000; in microseconds

You can edit the parameters in the [forcefeedback] section of an Aircraft.cfg file to adjust the forces generated by Flight Simulator so that different aircraft can have different force effects, a different "feel" at the stick.

Note: The values and usage of the force feedback parameters are strongly tied to the ForceFeedBack feature of the DirectInput API (DirectX, version 5.0). It's strongly recommended that you refer to the DirectX, version 5.0 SDK to help you understand the use and effects of many of these parameters. You can download the DirectX, version 5.0 SDK from http://www.microsoft.com/directx.

The following table includes the data type and range for each parameter in the [forcefeedback] section of the Aircraft.cfg file.

Parameter

Data type

Range

stick_shaker_magnitude

Integer

0–10000

stick_shaker_direction

Integer

0–35999 degrees

stick_shaker_period

Integer

0–2^32-1 microseconds

gear_bump_nose_magnitude

Integer

0–10000

gear_bump_nose_direction

Integer

0–35999 degrees

gear_bump_nose_duration

Integer

0–2^32-1 microseconds

gear_bump_left_magnitude

Integer

0–10000

gear_bump_left_direction

Integer

0–35999 degrees

gear_bump_left_duration

Integer

0–2^32-1 microseconds

gear_bump_right_magnitude

Integer

0–10000

gear_bump_right_direction

Integer

0–35999 degrees

gear_bump_right_duration

Integer

0–2^32-1 microseconds

ground_bumps_magnitude1

Integer

0–10000

ground_bumps_angle1

Integer

0–35999 degrees

ground_bumps_intercept1

Floating-point

0–1000000.0 cycles per second

ground_bumps_slope1

Floating-point

0–1000000.0 cycles per second

ground_bumps_magnitude2

Integer

0–10000

ground_bumps_angle2

Integer

0–35999 degrees

ground_bumps_intercept2

Floating-point

0–1000000.0 cycles per second

ground_bumps_slope2

Floating-point

0–1000000.0 cycles per second

crash_magnitude1

Integer

0–10000

crash_direction1

Integer

0–35999 degrees

crash_magnitude2

Integer

0–10000

crash_direction2

Integer

0–35999 degrees

crash_period2

Integer

0–2^32-1 microseconds

crash_duration2

Integer

0–2^32-1 microseconds

The following table describes the parameters included in the [forcefeedback] section of the Aircraft.cfg file.

Parameters

Description

stick_shaker_magnitude,

stick_shaker_direction,

stick_shaker_period

Define the behavior of the Stick Shaker force-feedback (FFB) effect: magnitude sets the amplitude of the force, direction specifies the angular direction of the force, and period sets the time period of the force's cycle.

gear_bump_nose_magnitude,

gear_bump_nose_direction,

gear_bump_nose_duration

Define the FFB behavior when the aircraft's nose gear is raised or lowered (cycled). Simulates the force felt through the aircraft's control stick/yoke, primarily as a result of forces felt through the aircraft's airframe and secondary forces resulting from the drag of the gear when it's exposed to the air moving around the aircraft. In fixed-gear aircraft, this FFB effect won't be felt because, by definition, the landing gear doesn't move. The magnitude, direction, and duration parameters are very similar to the stick shaker parameters described earlier in this table.

gear_bump_left_magnitude

gear_bump_left_direction,

gear_bump_left_duration

Identical to the gear_bump_nose parameters, described in the preceding entry, except that the force is triggered when the left landing gear is cycled. 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.

gear_bump_right_magnitude,

gear_bump_right_direction,

gear_bump_right_duration

Identical to the gear_bump_nose parameters, described earlier in this table, except that the force is triggered when the right landing gear is cycled.

The following parameters are divided into two subgroups:

ground_bumps_magnitude1,

ground_bumps_angle1,

ground_bumps_intercept1,

ground_bumps_slope1

and

ground_bumps_magnitude2,

ground_bumps_angle2,

ground_bumps_intercept2,

ground_bumps_slope2

Each of the parameters in the subgroups defines the behavior of a distinct force. The combination of the two forces (1 and 2) together, define a composite force behavior that simulates the forces felt through an aircraft's ground steering controls. The two forces are both sinusoidal periodic forces. The frequency of each of these forces is determined by the following linear equation:

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.

The crash_ parameters are divided into 2 subgroups:

crash_magnitude1, crash_direction1

and

crash_magnitude2, crash_direction2, crash_period2, crash_duration2

When a plane crashes two different forces are generated. 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.

crash_magnitude1

Sets the magnitude of the first force.

crash_direction1

Sets the direction from which first force is felt.

crash_magnitude2

Sets the initial magnitude of the second force.

crash_direction2

Sets the direction from which the second force is felt.

crash_period2

Determines the frequency (frequency = 1/period) of the second crash force.

crash_duration2

Sets the amount of time that the second crash force is felt.