This repository is for the legacy Mixed Reality Toolkit (MRTK) v2. For the latest version of the MRTK please visit https://github.com/MixedRealityToolkit/MixedRealityToolkit-Unity
Mixed Reality Toolkit 2.8.3 is now available for download via GitHub and the Mixed Reality Feature Tool. This update provides various fixes and performance improvements. For complete details, please see the release notes or the What's Changed section below.
Download
[Recommended] Mixed Reality Feature Tool
When using Unity 2019.4 or newer, MRTK is available using the Mixed Reality Feature Tool. For more information, please see Welcome to the Mixed Reality Feature Tool.
Import asset (.unitypackage) files
When using Unity versions older than 2019.4, please scroll down to Assets and download to a known location (typically, this is the Downloads folder on Windows 10):
Once downloaded, you can set the target platform and import the desired packages using these instructions.
Getting started
To help get started using MRTK v2.8.3, please see the Welcome page, which covers software requirements and the initial steps required to use MRTK.
Release notes
Please see Release Notes for information on new features, known issues and changes.
What's Changed
Fixed occasional KeyNotFoundExceptions coming from DefaultPointerMediator by @marek-stoj in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/10612
Code cleanup & warning fixes by @BillyFrcs in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/10526
Added BaseMeshOutline inspector by @Proton-V in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/10662
Fixed NullReferenceException when opening PointerProfile without main camera in scene by @keveleigh in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/10715
Updated CameraCache failure case + perf by @keveleigh in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/10714
Fixed ArgumentNullException: Value cannot be null. Parameter name: _unity_self by @keveleigh in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/10713
Fixed flashing RiggedHandMesh by @jloehr in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/10754
Updated rigged hand mesh flicker bug fix to not be a breaking interface change by @keveleigh in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/10831
Fixed MRTK2 in Unity 2022 by @keveleigh in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/10903 and https://github.com/microsoft/MixedRealityToolkit-Unity/pull/10915
Updated OnInspectorGUI for Toolkit Inspector by @Proton-V in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/10936
Moved some codepaths away from MixedRealityToolkitFiles by @keveleigh in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/10956
Fixed TouchPointer NullReferenceException by @manuelpezzera in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/11036
Fixed GetAsync method in Rest class by @Proton-V in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/10797
Added missing mappings for Quest Touch controller "touch" bindings by @keveleigh in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/11105
Changed GGVPointer to use registered raycast provider by @keith-phillips in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/11147
Fix for GazeTarget getting overwritten by non-gaze pointers by @keith-phillips in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/11148
Removed unnecessary controller visuals from the default HoloLens profile to reduce memory footprint by @RogPodge in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/11166
Updated build logic for finding sdk by @keveleigh in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/11129
Added OpenXR "render from PV cam" note by @keveleigh in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/11127
Don't introduce GetAwaiter extension methods conflicting with Unity's Awaitable in 2023.1+ by @simonferquel in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/11178
Resolved Unity 2023 build warnings by @keveleigh in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/11190
Fixed an OIP compatibility issue by @MaxWang-MS in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/11212
Don't share controller and source collections between instances by @keveleigh in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/11266
Fixed rigged hands in remoting by @keveleigh in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/11267
Exposed eye calibration state when using XR SDK by @keveleigh in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/11269
Fixed simulated motion controller grab by @jloehr in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/11272
New Contributors
@kevinfoley made their first contribution in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/10620
@JamieMagee made their first contribution in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/10955
@manuelpezzera made their first contribution in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/11036
@keith-phillips made their first contribution in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/11147
@simonferquel made their first contribution in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/11178
@EstebanFuentealba made their first contribution in https://github.com/microsoft/MixedRealityToolkit-Unity/pull/11185
Full Changelog: https://github.com/microsoft/MixedRealityToolkit-Unity/compare/v2.8.2...v2.8.3
Upgrading
Please review the Upgrade Guide for guidance on how to upgrade existing projects.
Note that the Tools package is now required when upgrading to a newer version of MRTK. It includes the migration tool, which automates the updating of projects assets to account for some changes in MRTK.
