MODULAR SIMOBJECT PROJECT SETUP
Modular aircraft SimObj have a very specific package and folder structure that must be adhered to. This structure will be created for you automatically when you create the initial package from The SimObject Editor with the following path:
../<Package_Name>/SimObjects/Airplanes/<Airplane_Name>/
The image below shows the essential contents of the folder for a modular aircraft package before being compiled by the Microsoft Flight Simulator 2024 package manager:
Here you can see that there are 4 sub-folders within the modular aircraft package. Each of these folders is required for the aircraft package to be valid. Each folder has a very specific purpose, and can contain a specific selection of sub-folders and files - each of which is outlined in the sections below - and you can click on the schema below to expand an outline of the folder structure.
+ Project_Name |---+ attachments | |---+ Company_Name | |---+ Function_[NAME] | | |---- <various files and folders> | |---+ Function_[NAME] | |---- <various files and folders> | |---+ common | |---+ checklist | | |---- <checklist XML file(s)> | |---+ config | | |---- <various CFG file(s)> | |<further folders and files> | |---+ liveries | |---+ Company_Name | |---+ Livery_Name | | |---+ model.[TAG] | | | |---- <model files> | | |---+ texture.[TAG] | | | |---- <texture files> | | |---+ panel.[TAG] | | |---- panel.cfg | |---+ <further_liverires> | |---+ presets |---+ Company_Name |---+ Preset_Name_1 | |---+ checklist | | |---- <checklist XML file(s)> | |---+ config | | |---- <various CFG file(s)> | |<further folders and files> |---+ Preset_Name_2 |---+ checklist | |---- <checklist XML file(s)> |---+ config | |---- <various CFG file(s)> |<further folders and files>
To see how all these files and folders are merged together to create a final aircraft, please see here:
Your package may also contain an Inputs folder at the top level if you wish to include an input profile to map specific controls/buttons/keys for the aircraft. You may also provide further Inputs folder within the common, preset or attachments folders to further modify this base input mapping for the aircraft. You can find more information on all this from the following page:
Attachments
The attachments
folder defines all the different attachments that can be added to the base aircraft to create the different configurations available. An attachment can be something as simple as a seat, or something much more complex like a landing gear assembly or an engine. The actual files and folders that are required by the attachment will be based on its functionality, with the most basic having simply a model and a texture folder, while the most complex can have all the functionality of any other SimObject, with sound, animations, effects, etc... as well as their own attachments.
Within the attachment folder you will have various sub-folders, one for each of the attachments that you wish to be available to the aircraft. Within these attachment sub-folders you can then have the following folders and files (the exact ones will depend on the overall functionality of the attachment):
Folder | Files |
---|---|
checklist |
See here for details: Checklist XML Properties |
config |
|
effects |
|
flt |
See here for details: FLT Files |
input |
See here for details: Input Configuration XML Properties |
interactions |
See here for details: Service Interaction XML Properties |
localization |
See here for details: Localization (LOC Files) |
model[.TAG] |
See here for details: Models |
panel[.TAG] |
|
navigation_graph |
See here for details: Cabin Services |
rtc |
See here for details: RTC XML Properties |
sound |
sound.xml and PC.PCK . For more information please see Audio In Modular Sim Objects. |
soundai |
soundai.xml and PC.PCK . For more information please see Audio In Modular Sim Objects. |
texture[.TAG] |
See here for details: Textures |
thumbnail |
This folder contains a thumbnail relevant to the SimAttachment being defined. This file is optional and is what will be used as part of the attachment preview in the Attachments window:
|
attachment.cfg |
Additional file that goes beside the attachment folders. Only required if the attachment is a modification of another existing attachment function. |
Common
The common
folder contains all the base files for the aircraft that will be shared to all variations. These files (CFG, XML, FLT, glTF, Textures, etc...) will form the common base that is then built upon to create each one of the different aircraft variations that you want to be available to the user to fly. If you are only creating a single aircraft, or porting over a legacy aircraft, then this is the folder where all the files will go. Files and folders for the aircraft should be placed in here directly without a company name folder:
Within the common folder you can have the following folders and files:
Folder | Files |
---|---|
checklist |
See here for details: Checklist XML Properties |
config |
|
effects |
|
flt |
See here for details: FLT Files |
input |
See here for details: Input Configuration XML Properties |
interactions |
See here for details: Service Interaction XML Properties |
localization |
See here for details: Localization (LOC Files) |
model[.TAG] |
See here for details: Models |
panel[.TAG] |
|
navigation_graph |
See here for details: Cabin Services |
rtc |
See here for details: RTC XML Properties |
sound |
sound.xml and PC.PCK . For more information please see Audio In Modular Sim Objects. |
soundai |
soundai.xml and PC.PCK . For more information please see Audio In Modular Sim Objects. |
texture[.TAG] |
See here for details: Textures |
Liveries
The liveries
folder is exclusively for liveries, and as such will contain model and texture folders only. The model and texture folders should be nested in appropriately named folders within the company name folder, where each nested folder is named after the livery name, for example:
Within each livery folder you will have the model and texture folders, which should be appended with a tag name (airframe, in the image above). This name is then used in the [Tags]
section of the attachment.cfg
to specify which livery is applied to which attachments (you can have the same "tag" in multiple attachments so they all share the same livery files).
Within the liveries folder you can have the following folders and files:
Folder | Files |
---|---|
model[.TAG] |
See here for details: Models |
texture[.TAG] |
See here for details: Textures |
panel[.TAG] |
|
navigation_graph[.TAG] |
See here for details: Navigation Services |
thumbnail |
This folder contains the thumbnails relevant to the livery being defined. There are three thumbnail files which are obligatory:
See The Aircraft Capture Tool for more information on how to generate these. |
livery.lbl |
This file is used to link the different liveries with geographic regions and packages. For more information, please see here: Liveries |
Note that a livery can override the base texture reference in the glTF, which means that for a given texture name, the livery name should be used instead of the base one, and that the base one exists purely as a fallback.
For information on how liveries are merged with the rest of the aircraft geometry and textures, please see the following section:
Presets
The presets
folder contains the "glue" that holds everything else together. The idea here is that each variation of your aircraft has a "preset" which is a selection of additional CFG/XML/FLT files, and a special attached_objects.cfg
, which is the file that tells the simulation which attachments should be merged with the base files to create the final aircraft. The different preset folders should be nested within the company name folder, where each nested folder is named after the preset name, for example:
Within the preset folder you can have the following folders and files:
Folder | Files |
---|---|
checklist |
See here for details: Checklist XML Properties |
config |
|
effects |
Only used for lighting effects. See here for details: Implementing Lights |
flt |
See here for details: FLT Files |
input |
See here for details: Input Configuration XML Properties |
interactions |
See here for details: Service Interaction XML Properties |
localization |
See here for details: Localization (LOC Files) |
model |
See here for details: Models |
panel |
|
navigation_graph |
See here for details: Cabin Services |
rtc |
See here for details: RTC XML Properties |
sound |
sound.xml and PC.PCK . For more information please see Audio In Modular Sim Objects. |
soundai |
soundai.xml and PC.PCK . For more information please see Audio In Modular Sim Objects. |
texture |
See here for details: Textures |
thumbnail |
This folder contains the thumbnails relevant to the preset being defined. There are three thumbnail files which are obligatory:
There is also an optional thumbnail file which should be included to highlight a specific aspect of any preset variation:
See The Aircraft Capture Tool for more information on how to generate these. |