Search…
⌃K

Troubleshooting

Check out this page to see if any common issues can be resolved. With numbers for easy referencing!

WebGL not installed / Playground files not being built

One of the most common issues when starting is that the playground files won't build. This is usually because the WebGL module was not installed when you installed Unity.
If you look at the console when trying to build the playground files, you will get an error similar to the following :
Example WebGL error
It is easy to add the WebGL module after you have installed Unity by going to the Unity Hub Installs section, selecting the Settings button, and then go 'Add Module'.
Select the Add Module option
After that all you need to do is make sure the WebGL module is installed.
Installed WebGL Module
Another approach, perhaps if you are not using Unity Hub, is go to File / Build Settings and then switch the Platform to WebGL. This should install the WebGL module as well.

Tags + Space Hierarchy

A lot of issues are caused by Scenes or tags being used incorrectly or not at all. Mona needs the following applied exactly like this in order to function correctly, so make sure to keep the following in mind.
Space Summary
The next image is a summary of the object types and the applicable states of each. Some of these are compulsory as well, so make sure these are set accordingly.
Other considerations to make in your hierarchy

'More than one root object' error!

This means that there is probably an object outside of the Space Scene/object hierarchy. If you reduce all your folders to the top gameobject layer you should get something like this :
Reduced hierarchy should look like this
If there are any objects under the Space/Portals/Artifacts scene, then make sure to add them under the Space/Portals/Artifacts gameobject.

The camera is stuck/doesn't move in Mona!

Make sure that your space doesn't have a camera in the scene. Either delete or disable the camera before building your Space to Playground Files.

'There is a problem with the Collider on one of your Canvases'

Canvases MUST have a mesh collider on the Unique Name Gameobject that has the Canvas tag (Not the CanvasPrefab parent object). If it has any other collider type, or no collider at all, it will throw an error on uploading to the playground files on your wallet.

My space doesn't update when I build to Playground!

Make sure to delete your Playground Files after testing. Sometimes it will not overwrite the files when you build them.

'You're missing a Space/Portals/Artifacts Layer' error!

The first object under each scene is the 'layer' in which all your objects need to be under. The Tags (in green) should be as follows :
Object tag in hierarchy
Make sure that there is only one of each green tag in the space. Any duplicates will throw an error. Other tags (Portals/Artifacts/Canvases) use different tags.

My avatar can't 'see' my Portal/Artifact/Canvas!

You may have deleted the Collider on the gameobject under the PortalPrefab that has the Unique Name and Portal/Artifact/Canvas tag attached (as per the documentation) .
Make sure there is a collider for Mona to see that it is a Portal/Artifact/Canvas.

'Duplicate Portal/Artifact/Canvas' Error in my build!

This means that that two or more UniqueName gameobjects (with their respective tag) under different Portal/Artifact/Canvas Prefabs has the same name. Use the QA button to give you hints to which ones inside Unity.

There is a very specific pink material on some/all of my objects!

This is a shader issue usually related to render pipelines. You may be using a shader on your material that the inbuilt render pipeline (URP and HDRP are not compatible with Mona) is not compatible with.
If you are porting your space from either URP or HDRP, played with these settings by mistake, or added an incompatible shader type from the asset store then you will need to reset the material or render pipeline to the Inbuilt Pipeline.

My artifacts / canvases / dynamic objects are really dark!

This could be that your light probes do not have enough light information in them to make them the right brightness level.

My Avatar falls through the ground!

You will need to add colliders to all objects you want the avatar to walk on, or not walk through. Box Colliders are most performant, but if you need a mesh collider make sure to optimise the mesh and use that instead of the base mesh.

Playground Files won't upload (with no error)!

First thing is to check the web console for errors : - Edge > Settings in top right / More Tools / Developer Tools - Chrome > Settings in top right / More Tools / Developer Tools
If an error is 'Nullreference : Object Reference not set to an instance of an object' then there may be a broken connection between objects.
A common issue is that Artifacts, Portals or Canvases (the Unique name object with the respective tag) does not have a collider and it needs it.
It could be by deleting prefabs without unpacking/deleting the references in the scene, renaming or importing a object that is different in some way to what Unity is expecting, references to objects in Unity Animation, or a reactor reference perhaps.
Basically, something in your scene is looking for something else in you scene, and not finding it.

dataOffset !=file.GetPosition() Error in Unity!

This happens sometimes when your hard drive that unity uses for temp files is full. Check your main drive and make sure there is enough space.

My mesh collider mesh looks different from what I exported!

Make sure to close your mesh before export. Mesh colliders should be closed objects (in that there are no 'holes' in the object). Otherwise there may be differences in your mesh in your 3D asset creation tool and what imports into unity.
Also make sure to apply all transforms before exporting.

My space works in playground but has trouble uploading to the Wallet!

It could be that your internet connection times out before it can upload, resulting in the following error. Make sure that you have a fast enough internet connection to upload your space without issue. Sometimes this may just be a temporary issue, and may work in an hour or two.
Example issue

I have a 'Looks like the "Space' file is missing' error when I upload my Playable files!

This error will happen when you have moved or renamed your space scene in the project file outside of the original location, breaking a lot of the internal references that Mona is looking for. Unity will not fix this if you rename it back in some cases.
Error in question
This can be fixed by copying the Space.unity.meta file from an alternative build (found in the Space location) and copying it to the same location once you have sent the Space file to it's original location.
An alternative approach is building the Mintable file of your space using the Mona Menu, and then importing that into a new Template. This process is shown Testing the Mintable File. You may need to copy any other assets across, but this should solve this problem.

I can't seem to sign into or install Unity Hub!

Occasionally, the Unity Hub can be a little problematic for some uses. One thread that may help is the following, as it has links to earlier version of the Unity Hub.
Other approaches may be make sure that your VPN is turned off and that Unity is allowed through the firewall on your computer. These may limit your ability to sign in with the Personal license, and if you can't sign in you won't be able to open Unity.

Spaces don't load on the website

If the Spaces don't load on the website you can always check the Browser settings > More Tools > Developer Tools window and see if that offers any errors to help troubleshoot. If it is anything like the following it could be related to your Antivirus software.
Website spaces don't load...