Skip to main content

Material Overrides

Material overrides allow you to change the material (or material properties) for an individual actor, without having to change the material itself (which would affect all actors with the same model).

Material override properties can currently not be animated.

To add a material override, go to the actor editor and select the pfm_model component of the actor, then click on Edit materialOverrides. This will take you to the UDM Editor window, where you will have to set up the following structure:

  1. Right-click root and choose Add Property > Add Array > element, name it materialOverrides.
  2. Right-click materialOverrides and choose Add Item for every material you want to override.
  3. Right-click the ID for the material override and choose Add Property > string, name it srcMaterial.
  4. Double-click the empty field in the Data column to the right of the srcMaterial property and enter the path and filename (without extension) of the material you want to override (e.g. enter player/soldier/soldier_d, if the material is materials/player/soldier/soldier_d.pmat).
  5. Right-click the ID for the material override and choose Add Property > string, name it dstMaterial.
  6. Like in step 4., enter the material that you wish to replace srcMaterial with. If you only want to replace specific properties of srcMaterial, you can leave dstMaterial empty.
  7. Right-click the ID for the material override and choose Add Property > element, name it override.
  8. Right-click override and choose Add Property > element, name it pbr.
  9. Right-click pbr and choose Add Property > element, name it properties.
  10. Right-click pbr again and choose Add Property > element, name it textures.

The structure should now look like this:

udm_editor_mat_override_structure.png

You can now fill properties with the material properties you want to replace and textures for the textures accordingly. For instance, if you want to override the color_factor property, right-click properties, select Add Property > vec3 and name the property color_factor. On the right side you can now double-click the value to edit it:

material_override_color_factor.png

If you want to replace the albedo map, right-click textures, select Add Property > string, name the property albedo_map and input the texture you want to use as a replacement as the value.

Make sure to press Save to apply the changes you have made, and save the project afterwards.

 

Back to top