THE SIMOBJECT EDITOR
The SimObject Editor allows to you to edit and debug any modular SimObject that has been loaded as part of a package into The Project Editor. To see an example of a simple modular SimObject package you should look at the SimpleAircraft sample project, or - for a complete and detailed modular SimObject - look at the DA62 sample project.
NOTE: For more information on modular SimObjects, please see here: Modular SimObjects
Once you have loaded a package with a SimObject into the Project Editor, you should build the package and then - when it's built - start a flight. Once the flight has started, you can select the SimObject in the Project Editor and then in the Inspector click on the Load In Editor
button. This will open the SimObject in the editor:
The different sections of the editor are as follows:
-
Menu Items
The main menu items for the editor. See here for more information: Menus
-
Package Details
Here you have the currently selected package. TheSelect
button can be used to switch between different packages that you may have loaded in the project editor or built in the VFS.
-
Parameter Search
Clicking the
Search
button will open up the Search Parameter window:Here you give a search term to use then press
Enter
and the window will be populated with a list of parameters that contain the term you gave. You can then use the↑
and↓
buttons to move between the parameters in the list, and the SimObject Editor will automatically expand the sections and highlight the parameters as they are selected. You may also filter the list of parameters by changing the "All tabs" option to the tab that you want to filter for, and you can clear the filter and search term by clicking on theX
button. For a full list of the SimObject Parameters available please see here: The SimObject Editor Parameter Index
-
Node Selection
From this menu you can select a different node of the modular SimObject to edit. For more information please see here: Modular SimObject Nodes
NOTE: If you are loading a legacy SimObject this section will not be present
-
Edition Tabs
These are the main edition options of the editor, and each tab will change the editor contents to show different information. The edition tabs available are as follows:
-
Content Edition
This section is where the actual edition of the SimObject will be done. The contents of this section of the editor will depend on the currently selected Edition Tab. When editing the information here, it is not immediately written to files but instead it is held in memory. You can then use the Resync option to apply any changes that you make to the SimObject that is currently selected, without saving. This will simply rebuild the package using the modified values from the editor without editing the source files themselves. If the changes you make are all correct, then you can use the Save or the Save And Resync options to permanently write the changes to the files.
Modular SimObject Nodes
In previous versions of Microsoft Flight Simulator 2024, SimObjects were "monolithic", meaning that they were created as single entities and if you wanted to have variations on the object (for example: an aircraft with floats, with wheels, etc... or a car with the same wheelbase but different bodies) then you would have to create the entire object multiple times, with each version having just those differences. This meant that a single SimObject package could have in reality multiple objects within it, which bloated the file size, and was harder to optimise within the simulation. To resolve this, SimObjects are now created as Modular SimObjects. You can find all the relevant information related to the files required by modular SimObjects as well as how the different files are all merged together on the following page:
With reference to the SimObject Editor, when you create a new modular SimObject, the default edition will be done on the Common files (the "base" files), and at the top of the editor you now have the option to select between the different nodes (parts) of the aircraft - the common files, the attachment files, and the preset files:
When you click on this, you will be presented with the available modular SimObj nodes:
From this sub-window you can expand on any of the main categories (Common, Preset, SimAttachment or Livery) and then select from the any of the existing modules listed underneath. You can also filter the listed modules by adding text into the filter box at the top, and clear the filter using the Clear
button. Selecting any of the listed module will then update the editor so you can edit the various files associated with the selected module.
NOTE: You can see the hierarchy and connections between modular nodes from the The Modular SimObject Graph window.
Within the editor, after selecting any node from the list, the various sections will be colour coded to show at a glance which sections/parameters/configurations are inherited or changed by the various other nodes. For example, this image shows a preset and the CFG sections/parameters inherited from the common files:
The following key colours are used:
- Green - The section/parameter comes from the common files
- Purple - The section/parameter has come from an attachment.
- Aqua - The section/parameter has come from a preset.
- White - The section/parameter comes from the node that is currently being edited, and has had its values changed/edited.
- Default - the section/parameter has not been edited and is either set to it's default value for all nodes, or is not included in any nodes.
- Red - The section/parameter has been mis-configured and should be fixed before saving. Note that a misconfigured parameter may also be one that is missing since any required parameter that is not defined in the common files or an attachment will be flagged in red in the associated preset.
- Yellow - This colour is only used for "focused" parameters. For example if you use the
Ctrl
+F
Search Parameter window to find a parameter, it will be shown in yellow, or if you select a node in the navigation graph, all the associated parameters will be highlighted in yellow.
Parameter Hierarchy
As explained in the section above, some parameters will be coloured to show what part of the aircraft they come from. However, it's possible to have - for example - multiple attachments that contain the same files and parameters, and the final value of any specific parameter will be determined by the merge process (as explained here: Merge Rules). If you hover over the parameter name in the SimObject editor, you will be able to see the file that the parameter value comes from:
If you want to see the full file hierarchy for the parameter, then you can click on it to open the Override Hierarchy window for it. IN this window you will be able to see all the files that have the clicked-on parameter, and how those files are connected within the modular SimObject hierarchy. Essentially this window is a smaller version of The Modular SimObject Graph and its contents cannot be edited (except to move the nodes around if required for clarity):
Creating Attachments and Presets
When creating any new SimObject, you will have gone through The Project Editor and have a used a template to start with. This will usually include the common files, an attachment, and one or two presets. These can then be edited as normal, however you may need more attachments or presets and these can be added through the SimObject Editor.
Presets
To add a new preset to your SimObject you need to go to the File menu and select the New > Preset option. This will open a sub-window requesting that you give the Company Name and the Preset Name, and then - after clicking on the Create
button - the preset will be added into the SimObject node list.
Selecting the preset will load the preset files into the editor, and colour any common or attachment parameters appropriately. You can then go ahead and edit the preset files the same as you would edit any other object files.
Attachments
To add a new attachment to your SimObject you need to go to the File menu and select the New > Attachment option. This will open a sub-window requesting that you give the Attachment Name, and then - after clicking on the Create
button - the attachment will be added into the SimObject node list.
Selecting the attachment will load the associated files into the editor, and colour any common or preset parameters appropriately. You can then go ahead and edit the attachment files the same as you would edit any other object files.
It should be noted that you are not limited to creating your own attachments. There are a number of "pre-made" attachments that can be included within your projects. These attachments are available from the attached_objects.cfg
tab of the editor, where you can add a new SimAttachment, and then in the attachment_root
parameter you can click the ...
button to open the file explorer which will list all the attachments you have created for the project, as well as all the "pre-made" attachments included as part of the Microsoft Flight Simulator 2024 SDK.
Once you have selected the attachment to use, click on the ...
button for the attachment_file
parameter and browse to the model directory and select the model.xml
file for the attachment. For more information on these attachments, please see here:
The Modular SimObject Graph
This window will open automatically when you open or create a modular SimObject. This window shows the hierarchy of nodes and how they will be compiled together when one of the SimObject presets is loaded into the simulation. If this window is not visible, you can open it from the View menu of the SimObject Editor.
Within this window you can left-click on any node then drag it around to re-position it, or you can left-click in the window and drag to select multiple nodes at once. You may left-click on any of them and drag to move them all together. If you right-click anywhere in the window you will find the option to reset layout which will reset the nodes and paths to their default positions. If you rright-click on a node, you will get the reset layout option, but you also have the option to Open In Explorer, which will open the file explorer on the folders and files associated with the node that was clicked on.
Custom Parameters
The SimObject editor may show an additional tab, depending on the contents of the SimObject being edited. This tab is the Custom Parameters tab:
The sections and parameters shown here will vary depending on the SimObject, and also depending on the version of the SDK that is being used. For more information please see here: