Skip to main content

Common Issues

This page will cover common issues when using the Genies Avatar SDK and how to solve them.

SDK Package is not Working after Update​

If the package is having weird issues after an update, then it may need a hard reset.

Follow these steps:

  • Open the Preferences window under the Edit dropdown in the top menu.
  • Select the Package Manager section in the left menu.
  • Open the file directory under Cache Location.
  • Delete the npm.genies.com folder under the cache/npm folder.
  • Delete the npm.genies.com folder under the cache/packages folder.
  • Close Unity.
  • Open the root folder for the Unity project.
  • Delete the Library folder.
  • Reopen Unity.

Package Cache

Nothing Works on Mac​

If there is no Avatar displaying and you are using a Mac computer, then you may be experiencing a common issue that your macOS is below the prerequisite (macOS 15+).

You can update macOS by following this guide: https://support.apple.com/en-us/108382

Avatar and Avatar Editor are Missing Textures​

If the Avatar has reflective material and the Avatar Editor is missing icons, then this means you are experiencing a common issue (especially for Windows machines).

Windows Issue

To solve this:

  • Open Project Settings window in the Edit menu at the top.
  • Select the Player tab on the left sidebar.
  • Make sure the Windows tab is selected.
  • Go to Other Settings section and uncheck the box for Auto Graphics API for Windows.
  • Add Vulkan and remove DirectX as the default Graphic APIs for Windows.
  • Restart Editor.

Windows Solution

TextMeshPro is not Working​

If using TextMeshPro objects like Text or Buttons is not displaying the text, then you may need to import the TextMeshPro resources package.

To solve this:

  • Click Windows tab at the top.
  • Select TextMeshPro and click Import TMP Essential Resources.
  • Once installed, restart Unity and it should work.

Import TMP

Unity Crash when Loading Avatars​

Rapidly spawning or despawning Avatars can cause Unity to crash. Try to limit the amount of Avatars being spawned at the same time. Reopen Unity and try pressing Play again.

Unity Crash

Metadata Not Found Error​

If you see this error:

error CS0006: Metadata file 'System.ComponentModel.DataAnnotations.dll' could not be found

Then you will need to follow these steps to fix the API compatibility issues:

  • In the top menu, click Edit > Project Setting.
  • Click the Player option in the left side menu.
  • Open the Dedicated Server Settings tab.
  • Set the API Compatibility Level to .NET Framework.
  • Restart Unity.

API Compatibility

Bootstrap Wizard Not Working​

Here are a couple errors you may encounter with the Genies Avatar SDK Bootstrap Wizard.

"Please install Newtonsoft.Json package first"​

This message appears when the Newtonsoft.Json package is not installed. Click Fix next to the Newtonsoft.Json prerequisite, then wait for Unity to recompile before proceeding.

Installation Fails​

If package installation fails:

  1. Verify your internet connection
  2. Check that the Genies registry was added correctly
  3. Review the Unity Console for detailed error messages
  4. Click Refresh Status to ensure all prerequisites are still met

Wizard Not Updating​

If the wizard doesn't reflect recent changes:

  1. Click the Refresh Status button
  2. Close and reopen the wizard window
  3. Check the Unity Console for any errors