THE MATERIAL EDITOR

Materials are used to describe how light should behave when it hits a surface and is reflected towards the camera. This is done by combining one or more textures and a specific "code", with the textures defining things like the albedo and the roughness, while the code tells the Microsoft Flight Simulator 2024 engine how the material should be rendered. For examples of elements that use materials, you can see the pages on Polygon Objects, Apron Objects, or Runway Objects, although there are others. You can also see a custom material being used in the SimpleAirport example project.

 

You may also find further information about this editor from the following pages:

 

 

Overview

The Materials Editor can be opened directly from the Tools menu, or - and this is the more common method for opening it - it'll be opened from The Project Editor when you create or edit a package (as explained below). The editor itself looks like this:

The Material Editor Window

At the top of the window you have the various menu items (explained on the Menus page), and then underneath that you have the different Content Controls:

  • Package
    The name of the package that you are currently exploring

 

  • Asset Group
    The Asset Group within the package that the current MaterialLib is assigned to.

 

  • Select...
    With this button you may change the asset group (and package) which is being explored. This will open the Asset Selector window: The Asset Selector Window

 

  • Delete
    Selecting this will delete the currently selected material. When you click this button you will be shown a confirmation window that also explains that when you delete the material any texture images (bitmaps) that are no longer referenced will be removed as well from the package.

 

  • Edit
    This will open The Material Inspector so that you can edit the selected material properties.

 

  • Apply
    This button is only applicable if the materials you have in the package are used in some element within the project packages. It will re-apply all the materials, updating them in the simulation if they have been changed in the editor previously.

 

  • Filter
    This input field lets you filter the list of materials based on some input text. This is cumulative with the tags, and so you can do an initial filter using the tags to only show the materials tagged with "Concrete" (for example), and then add "Grey" to the filter to only show those concrete tagged materials with "Grey" in the title.

 

  • Bitmap Preview
    This checkbox will - when enabled - show the different bitmaps (textures) used by the material when you mouse over them in the materials list:
    The Bitmap Preview Option In The Material Editor

 

The rest of the material editor is taken up with the Materials List, on the left, and the Tags List, on the right. Materials in the material list will be colored depending the factors listed below:

  • Brown: These materials are locked and cannot be modified unless you have the original package for it (these are usually the ones that are part of Microsoft Flight Simulator 2024), but they can still be used in your own packages.
  • White: These are materials that have been loaded correctly and can be used and edited.
  • Grey: These materials can be modified but have not yet been loaded.
  • Yellow: Materials that are this color are currently being loaded.
  • Red: Any material that is this color is one that has suffered a load failure or some other kind of error, and cannot be used or edited.

The tags list is used to filter the materials shown in the Materials list, and selecting any tags on the right, will filter the list of materials on the left to show only those that have the selected tag. Note that the top of the tags list will always have at least two default "macro" tags (that cannot be removed or edited) for the User and All, and usually another for the package being edited. Tags can be added from the Tag section of The Material Inspector.

 

 

Creating A New Material

Normally you woud be adding a MaterialLib asset group to a project that already has another asset group that will be using the materials you are creating, for example a Scenery asset, or a VFX asset. So, for this example, we'll be adding a material library to a simple airport and using a custom material for a runway. You'll also need to have previously created the textures that you want to use for the material (you will need at least an albedo texture, although you may require others) as we'll be adding them to the project folder. Note that textures should be authored as PNG , BMP or DDS files, and should always be powers of two in size eg: 512x512px, or 2048x2048px, etc...). So, before going any further, you should create a new airport, and add a runway to it. You can find a tutorial for that from the following page:

When finished, you should have a project that looks something like this:

The Test Project For Making A Material Asset Group

At this point we need to add a new asset group to the package for our materials. For that you'd click the Add Asset Group button at the bottom of the project inspector window, in the Asset groups section. This will open up the Package Wizard where you should select the Custom option:

The Main Package Wizard Window

Clicking on the Next button will take you to the following window:

The Add Asset Group Window For Adding A MaterialLib

Here you need to give the new material asset group a name, and select the MaterialLib asset type before clicking the Create button. Once the asset group has been created, the main Material Editor window should open. If it does not open then you can open it from the Tools menu.

IMPORTANT! When giving an Asset Group name, this needs to be unique otherwise you face conflicts with libraries from other packages. For example, just calling it "MaterialLib" is not enough, and you should instead be using something like the following schema:
mycompany-packagename-materiallibname

 

The main editor shows a list of materials on the left, and a number of pre-created tags on the right that can be used to filter the list of materials. Currently there will only be materials that are used in the actual simulation listed here (these are colored brown and cannot be edited), so let's add a new material of our own to this list. For that, follow these steps:

 

  • Go to the File menu and select the New option. You should then select the material context, which for this example should be Ground Surface:
    Selecting A Material Context

 

 

  • Here you need to give the new material a name and a type (you do not need to change the context if you already set it to Ground Surface). The name can be anything, but should be unique and easily identifiable, and the type should be "CODE_DIFFUSE" for now. This option is used to set how the material will be used by the engine and the type of textures it will require.

 

  • You should also select a Surface for the material. In this case we will use the ASPHALT surface. This option is for adding detail maps to the surface, as well as for editing how certain kinds of surface interact with the base scenery. If this option is not visible, then you may need to open the Scenery Editor, as the setting is specific only for materials being used by that tool. Note that if the surface is set to UNDEFINED, whatever is being drawn with this material will not override the surface material of whatever lies below it. This can be very useful for decals, for tire marks, etc...

 

  • Now you need to add the textures that are required by the material. By default , all available texture slots will be shown, but - depending on the type of material being created - you may only be required to use one or two of them. In this case we will be using the Albedo texture and the Normal Roughness Metal texture.
    NOTE: Only the Albedo texture is obligatory. All others are optional and can be omitted.

 

  • The textures themselves need to be added to the project folder before they can be added to the material, so you will need to browse to the Asset Directory in an explorer window, create a "textures" folder, and then copy the necessary textures there. To find the correct base directory, simply click on the asset group in the Project Editor, and then in the Project Inspector, you can see the asset directory "AssetDir", which has a button - Show In Explorer. Clicking this will open the file explorer on the location to add the textures:
    The Asset Directory For A Material In The Project InspectorIf you wish, you can download and use the two textures that we prepared for this example by clicking the following images:
    Albedo Texture Normal/Roughness/Metal

 

  • Once you have the textures in the correct directory, you can then go back to the simulation and add them to the material in the Material Inspector. For that, simply mouse over the texture slot and click on the Load Texture button, then select the texture bitmap from the explorer window that opens. Add both textures in this way, and make sure to give the material a Name, and also to set the Surface to Asphalt:
    The Material Inspector Showing Added Textures

 

  • The final step is to save the material so that it's added to the Material List in the main editor window. This is done by clicking the Save button at the bottom of the Material Inspector window. You can quickly find the material by selecting the Package on the right, then the Material itself from the left:
    A New Material In The Material Editor

 

Now that we have created a new material it can be applied to something. In this case, we'll apply it to the runway that belongs to the airport that is part of the package. You can quickly move the camera to the runway object by double clicking on it in The Scenery Contents List. It should currently look something like this:

An Airport Runway Using The Default Material

The next step requires you to expand the Materials section of the Scenery Editor Properties window, and you'll see the material that is currently applied to the runway:

Finding The Material In the Properties

To apply the new material that we've just created, simply click (and hold) on it in the Material Editor, then drag it onto the material button in the runway Properties window:

 

Applying A Material

 

When you've done that, the button will update to show the name of the material you've just added, and if you look at the runway in the scene, it too will have updated to use the new texture:

An Airport Runway Using A Custom Material