Skip to main content

Common Issues

This will cover warnings and errors reported by the forge pipeline. Search for the error that is reported on the forge create page.

Warnings​

Model has too many materials​

  • There were more materials than what we want for the specific item type you created.
  • We will combine them as much as we can to reduce the total number.

Model is too large in some dimension​

  • The model was too large and we will scale it down to best fit the size limits.

Model is too small in some dimension​

  • The model was too small and we will scale it up to best fit the size limits.

Model has too many meshes​

  • There were more materials than what we want for the specific item type you created.
  • We will combine the meshes to reduce the total count.

Model has too many triangles​

  • There were more triangles in the asset than what we want for the specific item type you created.
  • This can cause the asset to not look like the original since we will reduce the asset to fit our guidelines.
  • Recommended Action: You should reduce the model in your prefered 3D software of choice until the tri count is within the guidelines.

Your model has UVs out of bounds​

  • A mesh has UVs that extend past the 0-1 box of the UV.
  • This can occur on tileable type materials for a mesh. If not tileable then we recommend correcting.
  • Recommended Action: You should correct UVs to fit within the 0-1 UV space.

Your model has negative scaled objects​

  • There are meshes that have a negative scale.
  • We will attempt to inverse the scale and preserve normals, but there can be issues.
  • Recommended Action: You should correct the mesh and its normals in your 3D software and try again.

Your model has hidden objects​

  • There are meshes or objects that are marked as hidden or do not show.
  • We will remove them.
  • Recommended Action: You should remove these hidden objects for your file.

Your model has more than 20 snap points​

  • The asset has more snap points than allowed. All excess will be ignored.
  • Recommended Action: You should reduce the overall snap points assigned to be under the limit.
  • Snap Locations Restrictions

Your model has snap points too close​

  • The asset has snap points that are closer than 0.5m. This can cause possible snap jittering in game.
  • Recommended Action: You should space the snap points to be a distance of 0.5m or more from each other.
  • Snap Locations Restrictions

Errors​

Your model has unknown material type​

Model has empty textures references​

  • This occurs when an asset doesn't have the texture files properly embedded.
  • Recommended Action: You should export the model again from your 3D software and ensure to embed media/textures.
  • How to Export 3D Model

Avatar has no armature​

  • This occurs when an avatar asset doesn't have a rig.
  • Recommended Action: You need to rig and skin your avatar.

Avatar has too many armatures​

  • This occurs when an avatar asset has more than 1 rig in the file.
  • Recommended Action: You need to either combine or remove the extra rigs. There can only be one rig for an avatar.

Avatar has mesh(es) on root​

  • This occurs when an avatar asset has meshes that are not children of the rig.
  • Recommended Action: You need to either make the meshes children of the rig or remove them from your file.

Avatar has no skin weights​

  • This occurs when an avatar asset has a rig, but none of the bones are weighted on the meshes.
  • Recommended Action: You need to skin and weight the meshes to the rig.

Only humanoid rigs are supported​

  • This occurs when an avatar assets rig is not able to be mapped to a humanoid definition.
  • Recommended Action: Check and update the rig to have a humanoid setup and clear naming.
  • Example Humanoid Rig Layout.