This page lists warnings and error messages which may be triggered by dependencies in Substance 3D Designer, and offers common troubleshooting steps for each.

Dependencies are other files referenced by a Substance 3D file (SBS). They include resources and other Substance 3D files referenced by graph instance nodes.

 Invalid dependent package

A dependency package cannot be loaded, because it is missing, corrupted or incompatible with the version of Designer being used.

 Solution

There are two main ways of correcting this issue:

 Check the alias 'X' is defined in your project

One of the package's dependencies or resources is being loaded from a location which is aliased in the Substance 3D file (SBS) data under the alias reported in the warning, although that alias is not defined in the current project files.

 Solution

At least one of the project files should define the alias that which is reported in the warning.

 No file that matches this resource can be found

The files matching the UDIM template for a Bitmap resource cannot be found.

 Solution

When a Bitmap resource is linked and Designer detects a UDIM naming taxonomy in its filename – e.g. 0x1 in my_texture_0x1.png, it offers to link it as a UDIM template, so that Bitmap nodes can automatically switch to other bitmaps in a UDIM set using that taxonomy, when using a UDIM workflow in Designer. In that case, Designer links the Bitmap resource in a different way which takes the UDIM numbering template into account.

There are two main ways of correcting this issue:

 Linked file not found

The file referenced by a linked resource does not exist at the location specified by its File Path attribute.

 Solution

There are two main ways of correcting this issue:

 Color space not found

A Bitmap resource references a color space which cannot be found in the current color management environment. This may be an ICC profile or a color space in an OCIO configuration.

 Solution

The list of options for the Color space attribute is automatically populated with available valid color space. Change the color space value for that resource to any other entry in the list.

Alternatively, add that color space to the current color management environment, then restart Designer. This may be an ICC profile or a color space in an OCIO configuration.

 Reference resource not found

The graph assigned to the UV tile of a 3D mesh resource cannot be found at the location reported in the warning.

 Solution

There are two main ways of correcting this issue:

 UV tiles are assigned multiple times

A UV tile for a 3D mesh resource is assigned more than once to a Substance graph.

 Solution

For each UV set of a 3D mesh resource, make sure no UDIM index is present more than once in the UV Tiles list.

 Invalid UV tiles

A UV tile listed for a 3D mesh resource is not defined in the mesh or corrupted.

 Solution

For each UV set of a 3D mesh resource, make sure all items in the UV Tiles list refer to UDIMs which exist in the linked resource.