You can translate this page in any language! Look in the footer widget Google Translate
Before we dive into the aircraft.cfg, we will refresh your memory with the standard layout of an airplane folder.
- Press Windows 10 -Start,
- Select File Explorer,
- Select the installation folder of your sim, i.e. : F:\P3D4\SimObjects\Airplanes and there select the folder DeHavilland_Beaver_DHC2.
- This is what you [could] see >>
In a standard airplane folder you will find the folders:
- Texture.1 (up to Texture.n or Texture.named)
- the file aircraft.cfg
- the related .air file: in this case DeHavilland_Beaver_DHC2.air
Note: In each ‘flyable’ aircraft you must have a panel folder and sound folder, else this aircraft is only used for AI traffic. Without panel folder, the aircraft will not show in the (P3D4) Select Vehicle screen.
TIP: if you want to make this aircraft 'flyable' just copy|paste the related panel folder and sound folder from your FSX sim to this location. Works in most cases for stock aircraft. TIP: if you have a mirad of planes, do a pre selection in the search field, in the right upper corner of Select Vehicle screen. REMEMBER: Search box, VEHICLE TITLE, VEHICLE TYPE, PUBLISHER and MANUFACTURER
The File aircraft.cfg
REMEMBER: Before you start hacking around in cfg files, make a copy of the original one ... I only tell you once ...
What you should know before editing an aircraft.cfg or any text file:
- Use the text editor program Notepad++ to make move, add or changes in cfg or txt files. Reason for not using Windows Notepad (works anyway) is that you don’t have line numbers as a reference. Download Notepad++ here: https://notepad-plus-plus.org/
- An aircraft.cfg file is just a plain text file with ‘statement lines’ to be executed by the sim.
- A statement can have ‘a comment out’ by placing a semicolon or double-forward slashes before a line.
- Make a description of important changes in the top of the text-file also showing the source, your contact name and dates, etc. i.e.:
- //Date: yyy-mm-dd | Compatibility changes for Prepar3Dv4 version by [firstname.lastname@example.org]
- About Sections: in an aircraft.cfg you will see [sections] between [square brackets] as i.e. [fltsim.o]
- The last statement line in a section is closed with a ‘hard return’ thus creating a space line.
- If you want to separate sections visually, create a (79) character line as below.
- When changing a file, do not make a mess of it … and don’t forget to save changes during your work in progress.
- Adding more liveries to the airplane folder: read the chapter Add a Texture below.
TIP: create a last line in the aircraft.cfg named //EOF nnn where nnn equals this last line number. Reason: comparison with previous aircraft.cfg TIP: if you want to compare 2 aircraft.cfg's from the same airplane, use WINMERGE. Download this program here: http://winmerge.org/?lang=en
In the standard layout of an aircraft.cfg you will read [Sections] in the following sequence:
Further information, if there is, can be found using the available [Section]-hyperlink.
- [fltsim.0] up to [fltsim.n] >> must start with [fltsim.0] when counting
- [CameraDefinition.0] up to [CameraDefinition.n]
- [CameraDefinition.001] up to [CameraDefinition.nnn]
- [Reference Speeds]
The Airplanes folder.
This is the first screen that opens when you start P3D4. This screen contains the 4 main file parts to create a “scenario”. Here you choose the aircraft, the airport / location, determine the weather and season settings and time of day. Once you want to choose another vehicle with [Change Vehicle …], the screen changes with an overview of the currently loaded vehicles and with 5 columns indicating:
• VEHICLE TITLE
• VEHICLE TYPE
You can group the summary or sort the columns by pressing the header.
Make it easy for you to mark the airplanes that fly the best with a yellow star in the FAVORITE column and then highlight Show Only Favorites.
The [Hide Details] button hides or shows the
• AIR TRAFFIC CONTROL and
This data is derived from the aircraft.cfg file that is present in any folder of an aircraft. In the first scenario screen, change to VEHICLE TITLE Beech Baron 58 Paint1
Then open the folder of this default aircraft: F: \ P3D4 \ SimObjects \ Airplanes \ beech_baron_58
Note: The disk name F: \ and the folder name P3D4 may be different.
Base data of an aircraft.
Open the folder of the chosen aircraft. The basic data of an aircraft are in the aircraft.cfg
Line 1: Each individual model has a section beginning with [fltsim.n], where .n represents the model number that is defined by a figure.
Line 2: Each model has a “title”. The content of the text “title =” must be unique, otherwise the model will not be displayed.
Line 3: Specifies the filename of the “.air” file of the aircraft.
Line 4.5, 6 and 7: Any variation on the model, panel, sound or texture indicated by the aircraft under [fltsim.n] can be found in the folder structure, for example, tetxture.g1000 at [fltsim.3].
Line 8 and 9 refer to the contents of the htm file. This information is read in the kneeboard.
Line 10: is the default Tail Number; (can be overwritten)
Line 11: ui_manufacturer is an indentification of the “manufacturer”
Line 12: ui_type is an indication of the type of aircraft. It is better to make a selection criterion here as Single Prop, Twin Engine Prop, Twin Engine Jet, etc.
Line 13: ui_variation gives a color indication or otherwise
Line 14: ui_typerole (as mentioned in 12; does not appear in overview)
Line 15: ui_createdby = “Lockheed Martin” is the Publisher
Line 16: description = “With … is informative text
This sequence repeats itself for each model in this aircraft.cfg
Rule 110: performance = “Cruise … is informative text
The information under AIR TRAFFIC CONTROL is per [fltsim.n] in the state.cfg file in C: \ Usersname \ AppData \ Roaming \ Lockheed Martin \ Prepar3D v4 \ SimObjects \ aircraft name.
How to add a new texture.
To add a new texture folder to an existing aircraft, this is how you do it:
- Make a backup of the entire folder of the aircraft you are going to handle.
- Add the new texture folder to the aircraft folder and rename it with a umber or name.
- The folder name should differ from other texture.n folder names.
- Open the aircraft.cfg with Notepad ++ and scroll to the line in the file where the [General] section begins.
- Enter an entry above this line to create an additional blank line.
- Often, a [fltsim.n] section of text file is supplied in a new texture download.
- Cut and paste the new [fltsim.n] text here.
- Change [fltsim.n] to [fltsim.number= highest number +1].
- Enter the line texture = the number of the new texture folder name (texture.name or texture.number).
- Make an empty line before and after each [fltsim.n] section.
- Save the file, start sim and check.
- title=Beech Baron 58 w G1000 << unique title
- sim=Beech_Baron_58 << same .air file in use
- model=g1000 << using another model folder model.g1000
- panel=g1000 << using another panel folder panel.g1000
- sound= << using the default sound folder
- texture=g1000 << using another texture.g1000 folder
- ui_type=”Baron 58 G1000″
- ui_variation=”Glass Cockpit”
- ui_typerole=”Twin Engine Prop”
- ui_createdby=”Lockheed Martin”
- description=”With the ……
Including clues or excluding line statements
You can include textual clues in cfg files without being read as an instruction. Use two forward slashes or a semicolon. Example:
max_gross_weight = 5524 // (pounds)
; Moments of Inertia
About model, panels, sound, soundai and texture.
Each aircraft has a folder containing one or more sub folders model, panel, sound, soundai and texture. In each sub folder like: model, model.name, panel, panel.name, sound, soundai, texture or texture.name, there are files including a .cfg file or there is no contents except only a .cfg file.
The instruction in a cfg file indicates what needs to be done to show (or hear) the model, panel, sound, or texture when no executable files are present in sub folders. If for some reason, we cannot read information, a fallback to another existing location is foreseen.
If there are any executable files, then the corresponding cfg file contains the instructions that these files serve for. An example of a reference for a soundai.cfg for Commercial airliner is shown next to it. Here we use the soundai files of a CRJ700 for the Commercial airliner aircraft as an alias.
normal = Beech_Baron_58.mdl
interior = Beech_Baron_58_interior.mdl
fallback.1 = .. \ texture
fallback.2 = .. \ .. \ .. \ .. \ Scenery \ Global \ Texture
fallback.3 = .. \ .. \ .. \ .. \ .. \ .. \ Scenery \ Global \ Texture
fallback.4 = .. \ .. \ .. \ .. \ .. \ .. \ Content \ Scenery \ Global \ Texture
In a sound.cfg
alias = beech_baron_58 \ sound \
// Date: 170924-Airplanes explained-Version 1
Next Version: t.b.d.