Check out this page for solutions to common issues.

Getting started with Mona

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 :

  • Go to the Unity Hub Installs section, selecting the Settings button, and then go 'Add Module'.

  • Make sure the WebGL module is selected and select 'Install' at the bottom.

  • Another approach, 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.

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.

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. For more information go to Colliders.

'More than one root object' error

This means that there is probably an object outside of the Space/Portals/Artifacts Scenes or parent gameobject hierarchy. If you collapse all your folders to the top gameobject layer you should get something like this :

If there are any other objects under the Space/Portals/Artifacts scene, then make sure to add them under the Space/Portals/Artifacts gameobject.

'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 :

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.

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.

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.

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

This is the best way to help figure out what may be happening. Common issues include :

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.

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.

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.

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.

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.

Portals / Canvases / Artifacts

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

You may have covered the Portal, Artifact, or Canvas collider with another collider (usually for physical collision on the assets themselves). If there is a collider in front of, or surrounding, the collider on the Unique###Name gameobject then that will get priority, meaning the asset will not be able to be seen in Mona. As the portal, artifact, or canvas collider is also a physical collider it's best to remove all other colliders on your assets.

Another reason is that you may have deleted the Collider on the gameobject that has the Unique###Name and Portal/Artifact/Canvas tag attached (as per the documentation).

Javascript error when loading

The following error appears when loading the space :

A common reason for this is when the canvas images are to numerous, or too large, for the browser memory. Make sure your images are as small as possible if you have many images. we recommend no bigger than 1000x1000 if possible as all these images will need to be loaded before a user can explore the space without lag.

Another reason is that you are using too many animated GIF images. Reduce the number of gifs and see if that works. The filesize of the animated gifs may not be a deciding factor on this.

'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.

'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 have the same name. Use the QA button to give you hints to which ones inside Unity.

Asset Appearance

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 is not compatible with. URP and HDRP are not compatible with Mona.

If you are porting your assets 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 Standard Render Pipeline.

My artifacts / canvases / dynamic objects are really dark!

This is most likely due to your space not having Lightprobes. For more information go to Light Probes.


My mesh collider mesh looks different from what I exported!

It is recommended to close your mesh before export. Although the collision is based on the normal, or the polygon facing direction, of the mesh. Also make sure to apply all transforms before exporting.

Deleting the Mesh Collider component and reapplying it will sometimes fix this issue.

Mona spaces

Spaces don't load on the Mona website

If the Spaces don't load on the website you can always check the 'Browser settings > More Tools > Developer Tools' window, make sure the 'Console' tab is selected, and see if that offers any errors to help troubleshoot. This helps troubleshoot the issue in the Support channel on Discord.

'Blocked the loading of a resource' error

If the following error is shown it could be related to your Antivirus software.

Unity Errors

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.

Last updated