Getting Started Building
This doc goes over the steps to creating your first space in Mona!
If this is your first time in Mona, either as a beginner or an experienced developer, this page is your starting point to building a Mona Space!
There are just three parts to the building process :
- Setting up your project in Unity
- Creating your Space
- Testing and sharing your Space
After that you can submit and mint your space to sell! Let’s dive in step-by-step!
We currently require all builders to use Unity version 2022.3.6f1.
When installing, make sure to add Build support for WebGL. If not installed, you’ll run into a WebGL related error when building.
Download Mona SDK from Github
- Unzip the Mona SDK into the preferred location on your computer. This folder is the project.
- Open the Mona SDK folder to your Unity Projects using the 'Open' Button in Unity Hub.
Load Mona SDK Project in Unity
- If the Space is not opened automatically, click on the project to open it. Note that this may take up to 5 minutes to import.
Remember to backup often. To do this, you can simply make a copy of your project folder (Ctrl + C, then Ctrl + V works) and then open the duplicate folder in Unity to continue.
- After opening the project, load the template scenes using 'Mona > Load Space Scenes' in the Mona menu at the top. This will open three scenes: Space, Artifacts, & Portals.
- Make sure to delete the 'Untitled' scene in the Hierarchy window by right clicking it, and selecting 'Remove Scene'.
Load Mona Spaces into Project and remove 'Untitled' Scene
- Mona projects should have 3 Scenes loaded in your Hierarchy - Space, Portals, and Artifacts.
- Do NOT rename or delete any of these scenes.
- Make sure to remove any other scenes before exporting.
- Each scene will have an object in its root. Do not delete or rename these objects either.
- Each root object has a specific tag, 'Space,' 'PortalLayer,' and 'ArtifactLayer.' These are the only objects that use these tags.
- If you collapse your hierarchy, it should always look like the following:Collapsed scenes should look like this...
Now it’s time to start creating. Because Mona is based on WebGL in a browser, you must consider limitations when building. Keep note of the polygon count, material count, and texture size to start.
If you are coming from a non-game background such as architecture, fashion design, or similar, it will be important to optimize your assets considerably before using them in your space. You’ll want your space to run on as many devices as possible, so make sure to check out our tips on Space Limitations. We consistently add resources to the docs and YouTube channel to give you the best results possible.
- Import your assets such as 3D assets, textures and sound from your preferred creation tools (i.e., Blender, Maya, photoshop, etc.) into Unity. To import, you can use any of the following :
We recommend using the _AddYourArtHere folder located inside the Assets folder in the Project window to store your assets, but this is not compulsory.
- Drag and drop your assets from your desktop into the Unity Project window directly.
- Right mouse click in the Project tab window and use 'Import New Asset' and select your assets to import.
- Use the 'Assets > Import New Asset' menu item in the top toolbar to import your assets.
Supported file formats:
- Supported 3D file formats: .fbx (recommended), .obj
- Supported 2D file formats: .png (recommended), .jpg
- Supported Audio file formats: .mp3
Once your assets are imported into the Project folder, you can add them to your Space by dragging them directly into the Hierarchy window or the Scene itself.
There are 3 locations in which you can import your objects depending on what that asset is for:
This scene is your main environment. You will spend of your time creating assets within this scene. If you mint your space, these assets will not be able to be modified.
For example, if you built a Gallery space, you'd add the assets for the walls, ceiling, and floor into the Space scene.
Mona spaces have a certain hierarchy required to make it work, these include :
- All Space assets must be under, or a child of, the 'Space' gameobject under the Space scene. This object has the 'Space' tag.
- If the Space scene or Space GameObject is deleted or renamed, the space will not work in Mona.
- If the Space gameobject tag is removed or changed, the space will not work in Mona.
Adding portals to your space allows the user to travel to other minted Mona spaces. The creator, or owner of a space once minted, can decide which minted space the user can go to.
- Each Portal asset must be under, or a child of, the 'Portals' object under the 'Portals' scene. This object has the 'PortalsLayer' tag.
- If the Portals scene or Portals GameObject is deleted or renamed, the Space will not work in Mona.
- If the Portal tags are removed or changed, the portal will not work in Mona.
Artifacts are Canvases that can be used to display images or live streams and assets that link to external websites and can be modified by the creator or owner of the space once minted in the future.
- Each Artifact asset must be under, or a child of, the 'Artifacts' object under the 'Artifacts' scene. This object has the 'ArtifactsLayer' tag.
- If the Artifacts scene or Artifacts GameObject is deleted or renamed, the Space will not work in Mona.
- If the Artifact tags are removed or changed, the Artifact will not work in Mona.
- Once your space is to your liking, click on the 'Playground' button at the top of Unity - It's that easy!
- This will open your project 'Exports' folder and the Mona Playground URL for you to drag your playground files into the field in the middle of the page. You can also use the 'Mona > Build Playground Files' menu option.
- If you need to locate the Playground Folder, it can be found in the 'Exports' folder in your Unity project folder. If you need to find the playground website, you can find it at https://monaverse.com/playground.
- You will need a digital wallet to upload the space onto your wallet drafts. This allows you to share the space with others, create a hangout space for others to join you, and/or allow the space to be minted.
- Next, go to the 'Drafts' section and select '+ Create' to start a new space draft.
- This next page will ask for the following information:
- Artist Name (required)
- Space Title (required)
- Space Short Summary (required)
- Space Long Summary (optional)
- Properties (recommended)
- On the next page, you will see a number of categories to upload files. The two you need to be able to send to others are :
- Playable Files - This is used for the Playable Files you have used when testing. These must be less than 250Mb.
- Preview Image (optional) - This is the image that is used when loading the space. 1920x1080 screenshot of the space without an Avatar or Mona UI.
- Once you’ve uploaded the Playground Files, use the 'Preview' button to share the URL of your space and/or create a Hangout link (on the UI navigation bar) to send to others.
To mint your space, you’ll need to submit it for Quality Assurance (QA).
The QA process takes up to 72 hours for the first review. You will be notified of any adjustments that need to be made by email.
You must make the updates and reply to the QA email directly.
Do not resubmit the QA Submission form otherwise tracking your space will become more difficult for the QA Team.
To go through QA, you’ll need a few more things:
- Portals - This links all the Portals to their destinations.
- Canvases - This adds what images and links are used with canvases.
- Preview Render - This is the video used for promotion of your space on the Mona site. 1920x1080 video of your space without an Avatar or Mona UI.
- Mintable File - This is required when minting your space. Select “Build Mintable File” in the Unity Mona menu, it must be less than 2Gb)
- Note that after you mint your space, the Space scene assets cannot be updated. The space owner can update the destination of portals and edit Artifacts and Canvas links.
- After your space has been cleared, we’ll notify you by email. Use the Mint button to upload your space to the Mona marketplace to sell.
And that's how you get started in Mona!