Common errors and known issues.

Common errors

Avatar not loading on application build

If avatar loading is working in the Unity Editor but not a in the built application, the GLTFUtility shaders are likely missing. You need to add them to the Always Include Shaders list in the graphics settings to fix this.
Inside the Unity Editor, go to Edit > Project Settings > Graphics and find the Always Include Shaders list. Add the 4 GLTFUtlility shaders as shown below:

Known issues

Newtonsoft JSON conflict/errors

This can happen if you are using a newer version of Unity that comes with one of the packages that depend on the Newtonsoft JSON package (such as the Version Control package). When you import the SDK, you will see a DLL file duplication error. If you already have Newtonsoft JSON or a package that depends on it, uncheck the folder in the import window or remove it if you already imported it.

iOS WebView Not Loaded

WebView is supported by iOS 14.3 and newer versions. If you are using any version before 14.3, then it may not work.

Cannot Load an Avatar in Unity 2018

We no longer actively test or develop features for Unity 2018. If your package import is interrupted, try a reimport of the package to avoid any errors. If you have issues with avatars not loading in built applications, make sure to add the GLTF Utility shaders to the "Always Include Shaders" list in Unity's Graphics Settings.

Cannot Build for WebGL on Unity 2021

In Unity 2021, WebGL builds that include Newtonsoft JSON may encounter build issues. One of the suggested solutions is to change the "Regional format" in your build device's OS to English.
If you require further support, you can contact us at [email protected].