Rework MRFT references

keveleigh · keveleigh · commit a1269868ca33 · 2025-12-04T20:14:52.000-08:00
diff --git a/UnityProjects/MRTKDevTemplate/ProjectSettings/MultiplayerManager.asset b/UnityProjects/MRTKDevTemplate/ProjectSettings/MultiplayerManager.asset
@@ -0,0 +1,7 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!655991488 &1
+MultiplayerManager:
+  m_ObjectHideFlags: 0
+  m_EnableMultiplayerRoles: 0
+  m_StrippingTypes: {}
diff --git a/docs/mrtk3-overview/getting-started/exploring-features/mrtk3-sample-scenes.md b/docs/mrtk3-overview/getting-started/exploring-features/mrtk3-sample-scenes.md
@@ -6,7 +6,7 @@ nav_order: 5
 
 # Exploring MRTK3 sample scenes
 
-Unlike MRTK2, MRTK3 isn't distributed as a Unity project. Instead, MRTK3 consists of a loosely coupled collection of individual UPM packages distributed through the [Mixed Reality Feature Tool](https://learn.microsoft.com/windows/mixed-reality/develop/unity/welcome-to-mr-feature-tool), as well as through our official GitHub repository.
+Unlike MRTK2, MRTK3 isn't distributed as a Unity project. Instead, MRTK3 consists of a loosely coupled collection of individual UPM packages distributed through our official GitHub repository.
 
 As a result, we no longer ship our sample scenes inside the MRTK library/package itself. Instead, we maintain the `UnityProjects` folder at the top level of the [GitHub repository](https://github.com/MixedRealityToolkit/MixedRealityToolkit-Unity), which contains any Unity projects we want to ship. Currently, this folder includes the `MRTKDevTemplate` project, which contains all of our example scenes and is configured to align with our recommended best settings.
 
diff --git a/docs/mrtk3-overview/getting-started/setting-up/mixed-reality-feature-tool.md b/docs/mrtk3-overview/getting-started/setting-up/mixed-reality-feature-tool.md
@@ -0,0 +1,41 @@
+---
+title: Mixed Reality Feature Tool (Deprecated)
+parent: Setting up the development environment
+---
+
+# Mixed Reality Feature Tool (Deprecated)
+
+| Software | Version | Notes |
+| --- | --- | --- |
+| [Mixed Reality Feature Tool for Unity](https://aka.ms/mrfeaturetool) | | Used to acquire MR packages |
+
+> [!WARNING]
+> Older versions of MRTK3 can be found on the Mixed Reality Feature Tool for Unity. The feed that backs the tool and the publishing infrastructure around it have been decommissioned, and new versions will not be published here.
+
+## Import required dependencies and MRTK3 packages with Mixed Reality Feature Tool
+
+There are a handful of packages that MRTK3 uses that aren't part of this toolkit. To obtain these packages, use the [Mixed Reality Feature Tool](https://learn.microsoft.com/windows/mixed-reality/develop/unity/welcome-to-mr-feature-tool) and select the latest versions of the following in the **Discover Features** step.
+
+To run on **HoloLens 2** or to visualize controller models on a **Quest device**, an additional package is required:
+
+- **Platform Support → Mixed Reality OpenXR Plugin**
+
+To spatialize audio in your scene, an additional package is required:
+
+- **Spatial Audio → Microsoft Spatializer** (Optional)
+
+For MRTK3 packages, we recommend the following two packages to help you get started quickly:
+
+- **MRTK3 → MRTK Input** (Required for this setup)
+- **MRTK3 → MRTK UX Components**
+
+These two packages, along with their dependencies (automatically added by the Feature Tool), will enable you to explore most of our UX offerings and create projects ready to be deployed to various XR devices. You can always come back to the Feature Tool and add more packages to your project later.
+
+Be sure to select the `org.mixedrealitytoolkit.*` packages, and not the deprecated packages. The `com.microsoft.mrtk.*` packages have been deprecated and are no longer supported.
+
+![Selecting the default MRTK3 packages in Microsoft's Mixed Reality Feature Tool](../../images/mrtk3-featuretool-setup-packages.png)
+
+> [!NOTE]
+> For more information on MRTK3 packages, see the [package overview page](../../packages/packages-overview.md).
+
+When you're finished selecting packages, click **Get Features**, and then follow the instructions in the Mixed Reality Feature Tool to import the selected packages into your Unity project.
diff --git a/docs/mrtk3-overview/getting-started/setting-up/setup-dev-env.md b/docs/mrtk3-overview/getting-started/setting-up/setup-dev-env.md
@@ -11,10 +11,12 @@ Before setting up a Unity Project with MRTK3, make sure you have the following s
 | Software | Version | Notes |
 | --- | --- | --- |
 | Unity | 2022.3 LTS or newer | Recommend using an LTS release <br> See [Additional tools](#additional-tools) below for recommended modules |
-| [Mixed Reality Feature Tool for Unity](https://aka.ms/mrfeaturetool) | | Used to acquire MRTK3 packages |
 
 ## Additional tools
 
+> [!WARNING]
+> Older versions of MRTK3 can be found on the [Mixed Reality Feature Tool for Unity](./mixed-reality-feature-tool.md). The feed that backs the tool and the publishing infrastructure around it have been decommissioned, and new versions will not be published here.
+
 ### Android
 
 If your target platform is an [AOSP-based](https://source.android.com/) device, like Android XR or Quest, your Unity installation needs to include the Android Build Support module and its submodules.
diff --git a/docs/mrtk3-overview/getting-started/setting-up/setup-new-project.md b/docs/mrtk3-overview/getting-started/setting-up/setup-new-project.md
@@ -16,33 +16,49 @@ You're not expected to consume every MRTK package. See [which features are usefu
 
 Create a new Unity project with Unity 2021.3.21f1 or newer. Close the Unity project before proceeding to the next step.
 
-### Import required dependencies and MRTK3 packages with Mixed Reality Feature Tool
+### Import MRTK3 packages
 
-There are a handful of packages that MRTK3 uses that aren't part of this toolkit. To obtain these packages, use the [Mixed Reality Feature Tool](https://learn.microsoft.com/windows/mixed-reality/develop/unity/welcome-to-mr-feature-tool) and select the latest versions of the following in the **Discover Features** step.
+For MRTK3 packages, we recommend checking for the [latest release on the GitHub repo](https://github.com/MixedRealityToolkit/MixedRealityToolkit-Unity/releases). The package tarballs can be found under the changelogs, under **Assets**:
 
-To run on **HoloLens 2** or to visualize controller models on a **Quest device**, an additional package is required:
-
-- **Platform Support → Mixed Reality OpenXR Plugin**
-
-To spatialize audio in your scene, an additional package is required:
+![GitHub release assets](../../images/github-release.png)
 
-- **Spatial Audio → Microsoft Spatializer** (Optional)
+- org.mixedrealitytoolkit.core
+- org.mixedrealitytoolkit.uxcore
+- org.mixedrealitytoolkit.standardassets
+- org.mixedrealitytoolkit.spatialmanipulation
+- org.mixedrealitytoolkit.uxcomponents
+- org.mixedrealitytoolkit.input
 
-For MRTK3 packages, we recommend the following two packages to help you get started quickly:
+We'll also need the latest Mixed Reality Graphics Tools package from [its GitHub repo](https://github.com/microsoft/MixedReality-GraphicsTools-Unity/releases), also under **Assets**.
 
-- **MRTK3 → MRTK Input** (Required for this setup)
-- **MRTK3 → MRTK UX Components**
+- com.microsoft.mrtk.graphicstools.unity
 
-These two packages, along with their dependencies (automatically added by the Feature Tool), will enable you to explore most of our UX offerings and create projects ready to be deployed to various XR devices. You can always come back to the Feature Tool and add more packages to your project later.
+Using UPM's ability to [import local tarball files](https://docs.unity3d.com/6000.0/Documentation/Manual/upm-ui-tarball.html), we'll import the above packages in the following order, to correctly resolve dependencies:
 
-Be sure to select the `org.mixedrealitytoolkit.*` packages, and not the deprecated packages. The `com.microsoft.mrtk.*` packages have been deprecated and are no longer supported.
+- com.microsoft.mrtk.graphicstools.unity
+- org.mixedrealitytoolkit.core
+- org.mixedrealitytoolkit.uxcore
+- org.mixedrealitytoolkit.standardassets
+- org.mixedrealitytoolkit.spatialmanipulation
+- org.mixedrealitytoolkit.uxcomponents
+- org.mixedrealitytoolkit.input
 
-![Selecting the default MRTK3 packages in Microsoft's Mixed Reality Feature Tool](../../images/mrtk3-featuretool-setup-packages.png)
+These packages, along with their Unity dependencies, will enable you to explore most of our UX offerings and create projects ready to be deployed to various XR devices. You can always come back and add more packages to your project later.
 
 > [!NOTE]
 > For more information on MRTK3 packages, see the [package overview page](../../packages/packages-overview.md).
 
-When you're finished selecting packages, click **Get Features**, and then follow the instructions in the Mixed Reality Feature Tool to import the selected packages into your Unity project.
+#### Additional dependencies
+
+There are a handful of optional packages that MRTK3 uses that aren't part of this toolkit. To obtain these packages, use the [Mixed Reality Feature Tool](./mixed-reality-feature-tool.md) and select the latest versions of the following in the **Discover Features** step.
+
+To run on **HoloLens 2** or to visualize controller models on a **Quest device**, an additional package is required:
+
+- **Platform Support → Mixed Reality OpenXR Plugin**
+
+To spatialize audio in your scene, an additional package is required:
+
+- **Spatial Audio → Microsoft Spatializer** (Optional)
 
 ### Open the Unity project
 
diff --git a/docs/mrtk3-overview/images/github-release.png b/docs/mrtk3-overview/images/github-release.png
diff --git a/docs/mrtk3-overview/packages/packages-overview.md b/docs/mrtk3-overview/packages/packages-overview.md
@@ -5,19 +5,16 @@ nav_order: 4
 
 # Using MRTK3 packages
 
-Microsoft MRTK3 is distributed as a set of packages that are imported into Unity using the Mixed Reality Feature Tool for Unity and the Unity Package Manager (UPM). These packages enable developers to customize the MRTK within their projects.
+Microsoft MRTK3 is distributed as a set of packages that are imported into Unity using the Unity Package Manager (UPM). These packages enable developers to customize the MRTK within their projects.
 
 ## Dependencies
 
-Some MRTK3 packages require additional packages, provided by Microsoft and/or Unity, in order to correctly function. Some of these packages are optional and will enable additional functionality.
+Some MRTK3 packages require additional packages, some provided by Unity and some by other platform vendors, in order to correctly function. Some of these packages are optional and will enable additional functionality.
 
 The following diagram illustrates the relationship between MRTK packages and some of the Unity dependencies.
 
 ![MRTK3 Package Graph](../images/MRTK3_Packages.png)
 
-> [!NOTE]
-> When importing packages using the Mixed Reality Feature Tool, dependency management is automatically performed.
-
 The following table describes the Mixed Reality Toolkit package dependencies.
 
 | Display name | Package name | Description | Required  | Optional  |
