Skip to main content
Version: 21 Aug 2024

Creating a New MRTK3 Project

This guide provides instructions on how to create a new Magic Leap 2 project that uses MRTK 3. See the Magic Leap MRTK 3 Overview page for information on which features are currently supported on Magic Leap 2.

Prerequisites

Before starting, download and install the following packages from the Magic Leap Hub:

  • Magic Leap SDK v1.2.0 (or later)
  • Magic Leap Unity SDK v1.8.0 (or later)
  • Unity Editor v2022.2.17f1 (or later)

Create a Magic Leap 2 Project

Ensure that you have a Unity project configured for Magic Leap 2 development. If you have not configure a project for Magic Leap 2, follow the Configure Unity Settings instructions.

Import Standard MRTK 3 Packages

Before importing the Magic Leap MRTK3 Integration Package, make sure to configure your project for MRTK3. This section offers general guidance on downloading and installing MRTK3 packages using the Mixed Reality Feature tool or microsoft's NPM web portal.

Use these instructions to install MRTK3 dependencies into your existing Magic Leap 2 project using the Mixed Reality Feature tool. Note that the Mixed Reality Feature Tool is only available for Windows.

Mixed Reality Feature Tool Welcome Screen
caution

Close the Unity project before using the Mixed Reality Feature tool.

  1. Open the Mixed Reality Feature Tool.
  2. Target your Unity project and select Discover Features
  3. At a minimum, install the following required packages:
    - MRTK3 / MRTK Input
    - MRTK3 / MRTK UX Components
    Note: If you do not see MRTK3, you may need to select the Show preview releases option located at the bottom of the window.
  4. After choosing the packages to install, click Get Features. This will display the package dependencies.
  5. Add the packages to your project by pressing Import then Approve.
  6. Finally, select Exit to close the Mixed Reality Feature Tool. ​ For more information, see Microsoft's Starting from a new project guide.

Open the Unity project

  1. Open the Unity project and wait for Unity to finish importing newly added packages.
  2. Clear any errors that appear due to missing dependencies from a prefab or XR provider.