# Download the Editor

## System Requirements <a href="#system-requirements" id="system-requirements"></a>

Currently, the Morpheus Platform editor only supports Windows 10 and 11.

## Hardware Requirements

Our editor is built on Unreal Editor, and has the same [hardware and software requirements](https://dev.epicgames.com/documentation/en-us/unreal-engine/hardware-and-software-specifications-for-unreal-engine).

{% hint style="info" %}
The exact hardware necessary will depend on the scale of your project.
{% endhint %}

## Prerequisites

* If you haven't installed Unreal before, you might need Microsoft's [Visual C++ Redistributable](https://aka.ms/vs/17/release/vc_redist.x64.exe).
* You need to have been given `Developer` access to your metaverse - see [Access Control](https://docs.msquared.io/admins/access-control).

## Steps

From your [dashboard](https://docs.msquared.io/morpheus-platform/glossary#dashboard), click the **`⬇ Download the editor`** button.

In the modal dialog that appears, first click the **`⬇ Install the Launcher`** button.

<figure><img src="https://1456550285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoWTlPaoHd1McSakqMigu%2Fuploads%2Fgit-blob-62c74e77f0a1cbe2b10a504f025b7bab47d4349e%2Fimage.png?alt=media" alt=""><figcaption><p>Note: Your <a href="../../../../morpheus-platform/glossary#projects">project</a> probably won't be called Staging. If you're not sure which project's editor to download, speak to your colleagues.</p></figcaption></figure>

{% hint style="info" %}
M² Launcher is our thin desktop app for Unreal editor & client downloading. It caches downloads so that subsequent launches happen fast.

i.e. The second time you click ⬇ **`Download`** for the same editor or client version, it should run immediately.
{% endhint %}

{% hint style="warning" %}
To change the editor download location (e.g. drive) - see the [M2 Launcher](https://docs.msquared.io/apis-and-tooling/launcher) page.
{% endhint %}

After installing the launcher, click the bigger ⬇ **`Download`** button to get the editor.

The launcher should automatically appear and start the editor download.

<figure><img src="https://1456550285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoWTlPaoHd1McSakqMigu%2Fuploads%2Fgit-blob-5688078b0f9c413faf87a5f8acd46bfc8e88be12%2Flauncher.webp?alt=media" alt=""><figcaption><p>Downloading an editor</p></figcaption></figure>

Once the download finishes, it should automatically open the Unreal Engine project modal.

If it doesn't, you can click the ⬇ **`Download editor`** button in the dashboard again, and now the launcher will immediately open Unreal.

To create a new project:

* Click the `MSquared` tab
* Configure the Project Location and Project Name as you like
* Click the `Create` button

{% hint style="info" %}
For further details on how to use the template project, see [using-the-template-project](https://docs.msquared.io/creation/unreal-development/getting-started/using-the-template-project "mention")
{% endhint %}

<figure><img src="https://1456550285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoWTlPaoHd1McSakqMigu%2Fuploads%2Fgit-blob-677b2bdb8ea4b8871f5f372de6bcf6c0afd96d58%2Fimage.png?alt=media" alt=""><figcaption><p>Creating a project</p></figcaption></figure>

Alternatively, you may want to [open an existing project with this editor](https://docs.msquared.io/creation/unreal-development/tutorials/upgrade-the-editor).

{% hint style="info" %}
In future, you can open your project just by clicking the `uproject` file in your project folder. You should only need to use the download path when if you need to update the editor version you're using. [More on that later](https://docs.msquared.io/creation/unreal-development/tutorials/upgrade-the-editor).
{% endhint %}

## Wait for the Editor to Open

Lastly, wait for the Unreal Editor to open your project.

<figure><img src="https://1456550285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoWTlPaoHd1McSakqMigu%2Fuploads%2Fgit-blob-25c3475c95cf429cf7cfe390c1da0ce342c6125c%2Fimage.png?alt=media" alt=""><figcaption><p>The editor opening a project</p></figcaption></figure>

<figure><img src="https://1456550285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoWTlPaoHd1McSakqMigu%2Fuploads%2Fgit-blob-1895f8e359a6bd812f787a986a4f61d1b564f320%2FScreenshot%202025-01-09%20122113.png?alt=media" alt=""><figcaption><p>Your first MSquared project</p></figcaption></figure>

## Known Issues

#### Editor downloads but errors when trying to open

You may need to install the Unreal Engine prerequisites. You can do this by:

1. Navigating to`%LocalAppdata%/M2Launcher/Editors`
2. Sort this directory by Date modified and open the most recently modified directory (this is the Editor that you most recently downloaded).
3. From here, navigate to`Windows/Engine/Extras/Redist/en-us`
4. and run the `UEPrereqSetup_x64.exe` file.
