# effects.cfg<no value>

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

The `effects.cfg` is an *optional* file that can be used by all SimObject categories. The file is used to specify one or more fallback directories for lighting effects in case the effects folder of your SimObject or attachment does not have the referenced light effect, for example:

-   when sharing effects between similar SimObjects
-   when reusing an effect from a parent for a variation

These are two common use cases in which having fallback directories avoids copy-pasting lighting effects necessarily.

 

For more information on creating lighting effects, please see here:

-   [Implementing Lights](system/implementing-lights/)

 

 

### [Version]

The `[Version]` section provides version information for the configuration file. In Microsoft Flight Simulator 2024, major versions should *always* be at least equal to 1.

 

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

 

{{< table-wrapper >}}

| Parameter | Description                                                   | Type    | Required |
|-----------|---------------------------------------------------------------|---------|:--------:|
| major     | Major CFG file version number, values must be greater than 0. | Integer |    No    |
| minor     | Minor CFG file version number, values must be greater than 0. | Integer |    No    |

{{< /table-wrapper >}}


 

 

### [fltsim]

The `[fltsim]` section has the following parameter and is used to define one or more fallback folder for light effects.

 

{{< table-wrapper >}}

| Parameter                                 | Description                                                                                                                                                                                                                           | Type   | Required |
|-------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|:--------:|
| `fallback.N` | The relative path to the fallback folder to check for the effects. Note that the first fallback folder requires that *N* is 1, and subsequent fallbacks should be numbered consecutively. See the section below for more information. | String |    No    |

{{< /table-wrapper >}}


 

 

### Using The effects.cfg File

To specify fallback directories using the `effects.cfg` file, you would need to create the file inside inside your SimObject `effects` folder.

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

The folder may be named something other than "effects" if required, as long as the new folder name is specified in the `effects` parameter of the `aircraft.cfg`.

{{< /callout >}}

 

In the `effects.cfg` file you would write the different folders to fallback to, using the `[fltsim]` header. Inside this section, fallbacks are defined via the `fallback.[index]=<path>` syntax, where the index must start at 1 and must be incremented by 1 for each fallback directory, for example:

{{< image-center
    src="images/5_Content_Config/CFGs/effects/effects_cfg.png"
    alt="Example Of The effects.cfg file Contents" >}}

 

In this example, given the effect name "*LIGHT\_NavigationRed*", the game will attempt to load the effects at these locations, stopping at the first valid path for which the effect exists:

1.  `SimObjects/Airplanes/Asobo_T6_Reno/Common/effects/LIGHT_NavigationRed.fx`
2.  `SimObjects/Airplanes/Asobo/effects/LIGHT_NavigationRed.fx`
3.  `SimObjects/Airplanes/MyAircraft/common/effects/LIGHT_NavigationRed.fx`
4.  `SimObjects/Airplanes/Aobo_L39_Reno/common/effects/LIGHT_NavigationRed.fx`
5.  `effects/LIGHT_NavigationRed.fx`

 

The last path (`effects/LIGHT_NavigationRed.fx`) is implicitly added to fallback to the global effects folder in case the effect could not be found.  

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

If you define an `effects.cfg` file, the PackageTool will check that your folders exist, and having a fallback folder which does not exist will result in an error. The missing fallback folder will be specified in the error.

{{< /callout >}}

 

So, to sum up:

-   When loading an effect, the game will look inside your SimObject common/attachment.cfg/preset folder for the effects folder (or the appropriate folder name if you are working on a variation).
-   If the specified effect cannot be found, the game starts using fallback directories specified inside `effects.cfg`.
-   The global effects folder is implicitly used as a fallback directory if none of the provided fallback folders contained the effect.
-   The global effects folder is considered even if the `effects.cfg` is non-existent, to make sure older packages can still access their effects.

This behaviour provides a way to override a base effect from the global effects folder - or the base package if applicable - for your SimObject by giving it the same name as the base effect.