UnityRef is currently in early development. Some features may be incomplete and/or not functioning.

UNITYREF

Your Pit Stop For Solving ANYTHING in Unity

graphics

[Cloud Build] Fix TextMeshPro Visual Glitches in Automated Builds

Solution

graphicscloud servicesuguishadersrendering

Unity 2021.x - Unity 6.3.x

Published Thu, Mar 26

Issue

TextMeshPro text elements appear correctly within the Unity Editor and local builds but exhibit visual inconsistencies when processed through Unity Cloud Build. Previous attempts to rectify this, such as explicitly including TMP shaders or modifying text component settings, have not resolved the discrepancy.

Resolve TextMeshPro display inconsistencies in Unity Cloud Build by aligning Unity editor versions and adjusting Anisotropic Textures to Per Texture in the Quality Settings.

Explanation

Align the local Unity Editor version precisely with the Unity Cloud Build target version. Version discrepancies often lead to divergent asset processing, Shader compilation, and runtime behaviors. Cloud Build utilizes a specific editor version; if this differs from your local environment, TextMeshPro assets, particularly font atlases and materials, may be processed inconsistently, causing visual glitches. Ensure all team members operate on the identical editor version to prevent further variations.

  1. Open the Unity Cloud Build dashboard and confirm the Unity Version matches your ProjectVersion.txt precisely.
  2. Navigate to Edit > Project Settings > Quality to access global texture overrides.
  3. Locate the Anisotropic Textures setting and set it to Per Texture so individual font assets control their own sampling.
  4. Verify that your TMP Essential Resources are correctly tracked in version control and not excluded by a .gitignore or unitycloudbuildsettings file.

Additional Tips

  • Force-include the TextMeshPro/Mobile/Distance Field shader in Project Settings > Graphics if text disappears entirely in cloud artifacts.
  • Ensure the Anisotropic Textures level on the specific TextMeshPro atlas texture is set to a value greater than 1 to maintain clarity at oblique angles.

Related Posts Haven't quite found a solution to your problem? We think these posts might help you.

Content inspired by a Unity discussion post.