attachment.cfg

The Attachment Tab In The SimObject Editor

The attachment.cfg file is an optional aircraft file for SimAttachments that is used to tell the attachment whether to inherit from base files or not, as well as add "tags" to facilitate the implementation of liveries. Below you can find information on the different sections used in the attachment.cfg as well as what parameters and values are expected within them.

[Version]

The [Version] section for the attachment.cfg is used to provide version information for the configuration file. In Microsoft Flight Simulator 2024, major versions should always be at least equal to 1.

Note that this section information is mandatory and should always be included.

Parameter	Description	Type	Required
`major`	Major CFG file version number, values must be greater than 0.	Integer	Yes
`minor`	Minor CFG file version number, values must be greater than 0.	Integer	Yes

[Inherit]

This section controls the CFG file inheritance, so that you can inherit base files and make some changes to them without duplicating any of the data.

Parameter Description Type Required

Parameter	Description	Type	Required
`base`	The path to the SimAttachment base files to inherit using the following format: `base = "SimObj_Root/Airplanes/Aircraft_Name/Attachments/Company_Name/attachment_name"` Note that the target folder must be an attachment root folder. Specifying a base folder in this way will add the base CFG and XML files for merging before this attachment and the base texture folder and texture fallbacks after this attachment (to allow for overrides). For more information, please see the section on Modular Aircraft Merging.	String	Yes

base

The path to the SimAttachment base files to inherit using the following format:

base = "SimObj_Root/Airplanes/Aircraft_Name/Attachments/Company_Name/attachment_name"

Note that the target folder must be an attachment root folder. Specifying a base folder in this way will add the base CFG and XML files for merging before this attachment and the base texture folder and texture fallbacks after this attachment (to allow for overrides). For more information, please see the section on Modular Aircraft Merging.

String

Yes

[Tags]

This section defines the Tags associated with the attachment. Tags are used to selectively load part of a livery. By associating a list of tags to an attachment the related texture.[tag_name] and model.[tag_name] folders of the livery will be loaded when instancing this attachment. The models in model.[tag_name] will be merged to the attachment and the texture.[tag_name] will be listed first in the list of texture directory fallbacks. Tags can also be used in the definition of [EDITABLE_COLORS] to specify a material in a livery for an attachment.

IMPORTANT! The tags "interior" and "exterior" cannot be declared in any attachment.cfg as their usage is slightly different:

"model.interior" and "model.exterior" are reserved for liveries targeting the models from the common / preset folder
"texture.interior" and "texture.exterior" are reserved for liveries targeting the textures from the common / preset folder

Available parameters are:

Parameter	Description	Type	Required
`Tag.N`	The tag to use to associate a livery with the attachment.	String	No

For more information please see the following section:

Liveries