# Quick Start

### 1. Download Unity 2020 LTS version <a href="#download" id="download"></a>

We recommend version 2020.3.18f from the [Download Archive](https://unity3d.com/get-unity/download/archive). Or get get latest 2020 LTS version with [Unity Hub](https://unity3d.com/get-unity/download).

![](/files/anrfHnsAKMYfBRkY82Hd)

### 2. Setup URP Unity project. <a href="#setup" id="setup"></a>

See official [Unity documentation](https://docs.unity3d.com/Packages/com.unity.render-pipelines.universal@7.1/manual/InstallingAndConfiguringURP.html). Easiest way to start testing is choosing 3D Sample Scene (URP). We strongly advice to create a brand new project and importing assets (for example from exported .unitypackage) instead of converting the whole project.

![Creating a new URP project in unity](/files/yiVuW7MpkC6Ax6WCYM7Q)

### 3. Download Dreem Creator Plugin <a href="#plugin" id="plugin"></a>

Download and import latest [Dreem.Creator](/metaverse-creator-manual/05OugTkVduc9hQ7Ajmqc/reference/dreem-creator-plugin.md) plugin.

Place the file in your unity `Plugins` folder.

![Proper placement of the Dreem Creator plugin](/files/jjmDfwo95VFO3PwTnPND)

### 4. Create your world <a href="#create" id="create"></a>

![Example world created with the Dreem Creator plugin](/files/fb2b1xzwqGStlfAQioIu)

#### <mark style="color:green;">Be creative & Have Fun!</mark>

Your unity scene is your world, you can build almost anything, with only some restrictions.

Make sure your spawn point is at 0,0,0

#### <mark style="color:red;">Not Allowed</mark>

* Using custom scripts.
* Scene should not contain:
  * [Camera](https://docs.unity3d.com/ScriptReference/Camera.html)
  * [Canvas](https://docs.unity3d.com/ScriptReference/Canvas.html), [EventSystem](https://docs.unity3d.com/2018.2/Documentation/ScriptReference/EventSystems.EventSystem.html), [BaseInputModule](https://docs.unity3d.com/2018.2/Documentation/ScriptReference/EventSystems.BaseInputModule.html)
  * [AudioListener](https://docs.unity3d.com/ScriptReference/AudioListener.html)
* Custom tags or layers.

#### <mark style="color:green;">Allowed</mark>

* Using any built in unity component.
* Only unity [Components](/metaverse-creator-manual/05OugTkVduc9hQ7Ajmqc/reference/dreem-creator-plugin.md) provided by Metaverse are allowed.

### 5. Export your world <a href="#export" id="export"></a>

1. Create [Dreem World](/metaverse-creator-manual/05OugTkVduc9hQ7Ajmqc/reference/dreemworldbuilder.md) by right clicking in project window Dreem->World.

![Creating a Dreem World object](/files/mkIGxkfNbTmPYrcbg4gp)

* Name your file.
* Drag and drop your unity scene into `scene`.
* Click **Build** button.

![Naming your level and buidling it](/files/XYugMydhNGQ1ucfP9Vfm)

* Your build files will be located under newly created sub folder with name *yourfilename*.dreemworld and yourfilename.dreemworld.data

![](/files/X0r5G5gTSr7CZbD6fbNT)

### 6. Upload your file to Dreem <a href="#upload" id="upload"></a>

Your world can be both new realm and extension of existing one. To upload a new realm:&#x20;

1. Visit Dreem [Create subpage](https://dreem.xyz/#/create)
2. Sign in with your Metamask wallet
3. Choose option Create Realm
4. Input world information, upload both *yourfilename*.dreemworld and *yourfilename*.dreemworld.data files and click *Save Draft*

![Uploading a new realm](/files/ec3GwZKgbYPrxv8uOlFR)

To create a realm extension go to [Realms webpage](https://dreem.xyz/#/realms), select the realm you want to extend, go to extension tab and click create extension

![Browsing realm extensions](/files/2nAivPRweVTzP9TCJKXR)

![Creating a realm extension](/files/RyyuYc53WMIfnMNC86X0)

Please read the explanation of fields included in creating realm/extension form&#x20;

<table><thead><tr><th width="179.33665835411472">Name</th><th width="178.6153846153846">Format</th><th width="156.15464507496705">Required</th><th>Description</th></tr></thead><tbody><tr><td>World/Extension name</td><td><code>Text</code></td><td>✓</td><td>Name of the world/extension. Should contain from 3 to 160 alphanumeric characters.</td></tr><tr><td>Description</td><td><code>Text</code></td><td>✓</td><td>Description of the world/extension. Should contain from 3 to 5000 alphanumeric characters.</td></tr><tr><td>Preview image</td><td><code>jpg</code>, <code>png</code>, <code>jpeg</code></td><td>✓</td><td>Preview image of the world which will be shown on the website. Maximum file size is 3MB. Dimensions are 4 x 4 - 2048 x 2048</td></tr><tr><td>Preview video</td><td><code>mp4</code>, <code>mov</code>, <code>avi</code>, <code>wmv</code></td><td>X</td><td>Preview video of the world which will be shown on the website. Maximum file size is 30MB.</td></tr><tr><td>World file</td><td><code>dreemworld</code> </td><td>✓</td><td>File containing world data (meshes, textures). Maximum file size is 50MB.</td></tr><tr><td>Data file</td><td>dreemworld.data</td><td>✓</td><td>File containing world metadata. Maximum file size is 10MB.</td></tr><tr><td>Make your file Public</td><td>Toggle</td><td>✓</td><td>If <code>true</code>, world will be visible to all players and creators. If <code>false</code> world will be visible and playable only by you (the creator). We advice test every level before publishing.</td></tr></tbody></table>

### 7. Play and share <a href="#play" id="play"></a>

You are all done! [Download and play ](https://dreem.xyz/#/)Dreem to test your creations!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dreem.gitbook.io/metaverse-creator-manual/05OugTkVduc9hQ7Ajmqc/quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.