# attachment.cfg<no value>

{{< image-center
    src="images/2_DevMode/simobject_editor/cfg/cfg_tab_1_attachment.png"
    alt="The Attachment Tab In The SimObject Editor" >}}

The `attachment.cfg` is an *optional* file for all *modular* SimObjects, but should never be used for non-modular SimObjects. The file 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.

{{< table-wrapper "300px" "" "100px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="major" />}}`major` | Major CFG file version number, values must be greater than 0. | Integer | Yes |
| {{< anchor id="minor" />}}`minor` | Minor CFG file version number, values must be greater than 0. | Integer | Yes |

{{< /table-wrapper >}}


### [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.

{{< table-wrapper "300px" "" "100px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="base" />}}`base` | The path to the SimAttachment base files to inherit using the following format:<span></span>`base = "SimObj_Root/Airplanes/Aircraft_Name/Attachments/Company_Name/attachment_name"`<span></span>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](../../modular-simobjects/modular-simobject-merging/). | String | Yes |

{{< /table-wrapper >}}


### [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]`](../livery.cfg/#editable_colors) to specify a material in a livery for an attachment.

{{< callout context="caution" title="IMPORTANT!" icon="outline/alert-triangle" >}}

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

{{< /callout >}}

-   "**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:

{{< table-wrapper "300px" "" "100px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="Tag.N" />}}`Tag.N` | The tag to use to associate a livery with the attachment. | String | No |

{{< /table-wrapper >}}


For more information please see the following section:

-   [Liveries](../../modular-simobjects/modular-simobject-project-structure/#liveries)